HermiteSpline - SuperMap3D Documentation

HermiteSpline

new SuperMap3D.HermiteSpline(options)

埃尔米特样条是三次插值样条。必须为每个控制点定义点、进线切线、出线切线和时间。为点[0,n - 2]定义出的切线，为点[1,n - 1]定义入线。例如，在点[i]和点[i + 1]之间插入曲线段时，这两点处的切线将分别为outTangents[i]和 intangible ents[i]。

Name Type Description

options

Object

具有以下属性的对象:

Name	Type	Description
`times`	Array.<Number>	每个点上严格递增的、无单位的浮点时间数组。它们是曲线的参数化。
`points`	Array.<Cartesian3>	`Cartesian3` 控制点数组。
`inTangents`	Array.<Cartesian3>	每个控制点的 `Cartesian3` 传入切线数组。
`outTangents`	Array.<Cartesian3>	每个控制点的 `Cartesian3` 外切数组。

Throws:

DeveloperError : points.length 必须大于或等于 2。
DeveloperError : times.length 必须与 points.length 相等。
DeveloperError : inTangents 和 outTangents 的长度必须等于 points.length -1。

Example:

// Create a G<sup>1</sup> continuous Hermite spline
var times = [ 0.0, 1.5, 3.0, 4.5, 6.0 ];
var spline = new SuperMap3D.HermiteSpline({
    times : times,
    points : [
        new SuperMap3D.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new SuperMap3D.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new SuperMap3D.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new SuperMap3D.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new SuperMap3D.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ],
    outTangents : [
        new SuperMap3D.Cartesian3(1125196, -161816, 270551),
        new SuperMap3D.Cartesian3(-996690.5, -365906.5, 184028.5),
        new SuperMap3D.Cartesian3(-2096917, 48379.5, -292683.5),
        new SuperMap3D.Cartesian3(-890902.5, 408999.5, -447115)
    ],
    inTangents : [
        new SuperMap3D.Cartesian3(-1993381, -731813, 368057),
        new SuperMap3D.Cartesian3(-4193834, 96759, -585367),
        new SuperMap3D.Cartesian3(-1781805, 817999, -894230),
        new SuperMap3D.Cartesian3(1165345, 112641, 47281)
    ]
});

var p0 = spline.evaluate(times[0]);

See:

Members

readonlyinTangents : Array.<Cartesian3>

每个控制点的 Cartesian3 传入切线数组。

readonlyoutTangents : Array.<Cartesian3>

每个控制点的 Cartesian3 外切数组。

readonlypoints : Array.<Cartesian3>

Cartesian3 控制点数组。

readonlytimes : Array.<Number>

控制点的时间数组。

Methods

staticSuperMap3D.HermiteSpline.createC1(options) → HermiteSpline

创建一个样条，其中每个控制点的切线是相同的。曲线保证至少在C¹类中。

Name Type Description

options

Object

具有以下属性的对象:

Name	Type	Description
`times`	Array.<Number>	控制点时间的数组。
`points`	Array.<Cartesian3>	控制点阵列。
`tangents`	Array.<Cartesian3>	控制点上的切线阵列。

Returns:

hermite 样条线。

Throws:

DeveloperError : 点、时间和切线的要求。
DeveloperError : points.length 必须大于或等于 2。
DeveloperError : 时，点和切线的长度必须相同。

Example:

var points = [
    new SuperMap3D.Cartesian3(1235398.0, -4810983.0, 4146266.0),
    new SuperMap3D.Cartesian3(1372574.0, -5345182.0, 4606657.0),
    new SuperMap3D.Cartesian3(-757983.0, -5542796.0, 4514323.0),
    new SuperMap3D.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
    new SuperMap3D.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
];

// Add tangents
var tangents = new Array(points.length);
tangents[0] = new SuperMap3D.Cartesian3(1125196, -161816, 270551);
var temp = new SuperMap3D.Cartesian3();
for (var i = 1; i < tangents.length - 1; ++i) {
    tangents[i] = SuperMap3D.Cartesian3.multiplyByScalar(SuperMap3D.Cartesian3.subtract(points[i + 1], points[i - 1], temp), 0.5, new SuperMap3D.Cartesian3());
}
tangents[tangents.length - 1] = new SuperMap3D.Cartesian3(1165345, 112641, 47281);

var spline = SuperMap3D.HermiteSpline.createC1({
    times : times,
    points : points,
    tangents : tangents
});

staticSuperMap3D.HermiteSpline.createClampedCubic(options) → HermiteSpline|LinearSpline

创建三次样条线。在内部控制点处生成切线，以创建 C² 类曲线。

Name Type Description

options

Object

具有以下属性的对象:

Name	Type	Description
`times`	Array.<Number>	控制点时间数组。
`points`	Array.<Cartesian3>	控制点阵列。
`firstTangent`	Cartesian3	第一个控制点的外切值。
`lastTangent`	Cartesian3	最后一个控制点的切线。

Returns:

如果给定的控制点少于 3 个，则使用赫米特样条线或线性样条线。

Throws:

DeveloperError : 点、时间、firstTangent 和 lastTangent 是必需的。
DeveloperError : points.length 必须大于或等于 2。
DeveloperError : times.length 必须与 points.length 相等。

Example:

// Create a clamped cubic spline above the earth from Philadelphia to Los Angeles.
var spline = SuperMap3D.HermiteSpline.createClampedCubic({
    times : [ 0.0, 1.5, 3.0, 4.5, 6.0 ],
    points : [
        new SuperMap3D.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new SuperMap3D.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new SuperMap3D.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new SuperMap3D.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new SuperMap3D.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ],
    firstTangent : new SuperMap3D.Cartesian3(1125196, -161816, 270551),
    lastTangent : new SuperMap3D.Cartesian3(1165345, 112641, 47281)
});

staticSuperMap3D.HermiteSpline.createNaturalCubic(options) → HermiteSpline|LinearSpline

创建一个自然的三次样条。生成控制点处的切线，以创建C²类中的曲线。

Name Type Description

options

Object

具有以下属性的对象:

Name	Type	Description
`times`	Array.<Number>	控制点时间的数组。
`points`	Array.<Cartesian3>	控制点阵列。

Returns:

如果给出的控制点少于3个，则为hermite样条或线性样条。

Throws:

DeveloperError : 分数和时间是必需的。
DeveloperError : points.length 必须大于或等于2。
DeveloperError : times.length 必须等于 points.length。

Example:

// Create a natural cubic spline above the earth from Philadelphia to Los Angeles.
var spline = SuperMap3D.HermiteSpline.createNaturalCubic({
    times : [ 0.0, 1.5, 3.0, 4.5, 6.0 ],
    points : [
        new SuperMap3D.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new SuperMap3D.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new SuperMap3D.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new SuperMap3D.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new SuperMap3D.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ]
});

evaluate(time, result) → Cartesian3

在给定时间对曲线求值。

Name	Type	Description
`time`	Number	计算曲线的时间。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

修改后的结果参数或给定时间曲线上该点的新实例。

Throws:

DeveloperError : Time必须在[t₀，t_n]范围内，其中t₀是数组times中的第一个元素，t_n是数组times中的最后一个元素。

findTimeInterval(time) → Number

在 times 中查找索引 i，使得参数 time 位于区间 [times[i], times[i+1]]

Name	Type	Description
`time`	Number	时间。

Returns:

区间起点元素的索引。

Throws:

DeveloperError : Time必须在[t₀， t_n]范围内，其中t₀是数组times中的第一个元素，t_n是数组times中的最后一个元素。