HermiteSpline

new Cesium.HermiteSpline(options)

Hermite样条曲线是一个三次插值样条曲线(spline)。必须为每个控制点定义点、内切线(incoming tangents)、外切线(outgoing tangents)和时间。 外切线定义为点[0,n - 2],内切线定义为点[1,n - 1]。例如,在points[i]points[i + 1]之间插入一段曲线时, 这些点的切线分别为outTangents[i]inTangents[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:
Example:
// 创建一个G<sup>1</sup>连续Hermite样条曲线
var times = [ 0.0, 1.5, 3.0, 4.5, 6.0 ];
var spline = new Cesium.HermiteSpline({
    times : times,
    points : [
        new Cesium.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new Cesium.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new Cesium.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new Cesium.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new Cesium.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ],
    outTangents : [
        new Cesium.Cartesian3(1125196, -161816, 270551),
        new Cesium.Cartesian3(-996690.5, -365906.5, 184028.5),
        new Cesium.Cartesian3(-2096917, 48379.5, -292683.5),
        new Cesium.Cartesian3(-890902.5, 408999.5, -447115)
    ],
    inTangents : [
        new Cesium.Cartesian3(-1993381, -731813, 368057),
        new Cesium.Cartesian3(-4193834, 96759, -585367),
        new Cesium.Cartesian3(-1781805, 817999, -894230),
        new Cesium.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

staticCesium.HermiteSpline.createC1(options)HermiteSpline

创建一个样条曲线(spline),其中每个控制点的切线都是相同的。 保证这些曲线至少属于C类1
Name Type Description
options Object 对象,具有以下属性:
Name Type Description
times Array.<Number> 控制点的时间的数组。
points Array.<Cartesian3> 控制点的数组。
tangents Array.<Cartesian3> 控制点的切线数组。
Returns:
Hermite样条曲线。
Throws:
Example:
var points = [
    new Cesium.Cartesian3(1235398.0, -4810983.0, 4146266.0),
    new Cesium.Cartesian3(1372574.0, -5345182.0, 4606657.0),
    new Cesium.Cartesian3(-757983.0, -5542796.0, 4514323.0),
    new Cesium.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
    new Cesium.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
];

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

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

staticCesium.HermiteSpline.createClampedCubic(options)HermiteSpline|LinearSpline

创建一个夹紧的(clamped)三次样条曲线(spline)。在C类2中,内部控制点的切线被生成为的曲线。
Name Type Description
options Object 对象,具有以下属性:
Name Type Description
times Array.<Number> 控制点时间的数组。
points Array.<Cartesian3> 控制点的数组。
firstTangent Cartesian3 第一个控制点的外切线。
lastTangent Cartesian3 最后一个控制点的内切线。
Returns:
给出了少于3个控制点的hermite样条曲线或线性样条曲线(spline)。
Throws:
Example:
// 在从费城到洛杉矶的地球上空创建一个夹紧的(clamped)三次样条曲线。
var spline = Cesium.HermiteSpline.createClampedCubic({
    times : [ 0.0, 1.5, 3.0, 4.5, 6.0 ],
    points : [
        new Cesium.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new Cesium.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new Cesium.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new Cesium.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new Cesium.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ],
    firstTangent : new Cesium.Cartesian3(1125196, -161816, 270551),
    lastTangent : new Cesium.Cartesian3(1165345, 112641, 47281)
});

staticCesium.HermiteSpline.createNaturalCubic(options)HermiteSpline|LinearSpline

创建一个自然的三次样条曲线。在C类2中,生成控制点的切线来创建一条曲线。
Name Type Description
options Object 对象,具有以下属性:
Name Type Description
times Array.<Number> 控制点时间的数组。
points Array.<Cartesian3> 控制点的数组。
Returns:
给出了少于3个控制点的hermite样条曲线或线性样条曲线(spline)。
Throws:
Example:
// 从费城到洛杉矶,在地面上创造一个自然的三次样条曲线。
var spline = Cesium.HermiteSpline.createNaturalCubic({
    times : [ 0.0, 1.5, 3.0, 4.5, 6.0 ],
    points : [
        new Cesium.Cartesian3(1235398.0, -4810983.0, 4146266.0),
        new Cesium.Cartesian3(1372574.0, -5345182.0, 4606657.0),
        new Cesium.Cartesian3(-757983.0, -5542796.0, 4514323.0),
        new Cesium.Cartesian3(-2821260.0, -5248423.0, 4021290.0),
        new Cesium.Cartesian3(-2539788.0, -4724797.0, 3620093.0)
    ]
});

clampTime(time)Number

将给定的时间固定(clamps)到样条曲线(spline)所覆盖的周期。
Name Type Description
time Number 时间。
Returns:
时间,固定的动画的周期。

evaluate(time, result)Array.<Number>

在给定时间对曲线求值。
Name Type Description
time Number 对曲线求值的时间。
result Array.<Number> optional 存储结果的对象。
Returns:
在给定时间的修改结果参数或曲线上点的新实例。
Throws:
  • DeveloperError : 时间必须在[t0, tn]范围内, 其中t0是数组code>times中的第一个元素, 并且tn是数组times中的最后一个元素。

findTimeInterval(time)Number

times中查找一个索引i,使得参数time 在区间[times[i], times[i + 1]]中。
Name Type Description
time Number 时间。
Returns:
间隔开始时元素的索引。
Throws:
  • DeveloperError : 时间必须在[t0, tn]范围内, 其中t0是数组code>times中的第一个元素, 并且tn是数组times中的最后一个元素。

wrapTime(time)Number

将给定的时间封装到样条曲线(spline)所覆盖的周期中。
Name Type Description
time Number 时间。
Returns:
时间,环绕着动画的周期。