HermiteSpline

new Cesium.HermiteSpline (options)

Hermite 样条是三次插值样条。必须为每个控制点定义点、入切线、出切线和时间。输出切线是为点 [0, n - 2] 定义的,而输入切线是为点 [1, n - 1] 定义的。例如,在 points[i] points[i + 1] 之间插值曲线段时,点处的切线将分别为 outTangents[i] inTangents[i]
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 描述
times 数组.<数字> 每个点处严格递增的无单位浮点时间数组。这些值与时钟时间无关。它们是曲线的参数化。
points 数组。< 笛卡尔3 > 控制点数组。
inTangents 数组。< 笛卡尔3 > 每个控制点的传入切线数组。
outTangents 数组。< 笛卡尔3 > 每个控制点的传出切线数组。
Throws:
Example:
// Create a G<sup>1</sup> continuous Hermite spline
const times = [ 0.0, 1.5, 3.0, 4.5, 6.0 ];
const 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)
    ]
});

const p0 = spline.evaluate(times[0]);
See:

Members

readonly inTangents : Array.< Cartesian3 >

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

readonly outTangents : Array.< Cartesian3 >

每个控制点的传出切线数组。
一组控制点。

readonly times : Array.<Number>

控制点的时间数组。

Methods

static Cesium.HermiteSpline.createC1 (options) HermiteSpline

创建一个样条曲线,其中每个控制点的切线都相同。保证曲线至少在 C 1 类中。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 描述
times 数组.<数字> 控制点时间数组。
points 数组。< 笛卡尔3 > 控制点数组。
tangents 数组。< 笛卡尔3 > 控制点处的切线数组。
Returns:
Hermite 样条曲线。
Throws:
Example:
const 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)
];

// Add tangents
const tangents = new Array(points.length);
tangents[0] = new Cesium.Cartesian3(1125196, -161816, 270551);
const temp = new Cesium.Cartesian3();
for (let 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);

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

static Cesium.HermiteSpline.createClampedCubic (options) HermiteSpline | LinearSpline

创建一个夹紧的三次样条曲线。生成内部控制点处的切线以创建 C 2 类中的曲线。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 描述
times 数组.<数字> 控制点时间数组。
points 数组。<数字> | 数组。< 笛卡尔3 > 控制点数组。
firstTangent 笛卡尔3 第一个控制点的出切线。
lastTangent 笛卡尔3 最后一个控制点的传入切线。
Returns:
如果给出少于 3 个控制点,则为 Hermite 样条或线性样条。
Throws:
Example:
// Create a clamped cubic spline above the earth from Philadelphia to Los Angeles.
const 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)
});

static Cesium.HermiteSpline.createNaturalCubic (options) HermiteSpline | LinearSpline

创建自然三次样条。生成控制点处的切线以创建 C 2 类中的曲线。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 描述
times 数组.<数字> 控制点时间数组。
points 数组。< 笛卡尔3 > 控制点数组。
Returns:
如果给出少于 3 个控制点,则为 Hermite 样条或线性样条。
Throws:
Example:
// Create a natural cubic spline above the earth from Philadelphia to Los Angeles.
const 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

将给定时间限制在样条曲线覆盖的时间段内。
Name Type Description
time Number 时间。
Returns:
时间,夹在动画时期。

evaluate (time, result ) Cartesian3

在给定时间评估曲线。
Name Type Description
time Number 评估曲线的时间。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或给定时间曲线上点的新实例。
Throws:
  • DeveloperError : time 必须在 [t 0 , t n ] 范围内,其中 t 0 是数组 times 中的第一个元素, t n 是数组 times 中的最后一个元素。

findTimeInterval (time) Number

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

wrapTime (time) Number

将给定时间包装到样条覆盖的时间段。
Name Type Description
time Number 时间。
Returns:
时间,围绕着更新的动画。