HermiteSpline

new Cesium.HermiteSpline(options)
engine/Source/Core/HermiteSpline.js 169

Hermite 样条是一种三次插值样条。每个控制点都必须定义点、进入切线、离开切线和时间 。离开切线针对点 [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> 控制点数组。
inTangents Array.<Cartesian3> 每个控制点处的进入切线数组。
outTangents Array.<Cartesian3> 每个控制点处的离开切线数组。
Throws:
  • DeveloperError ：points.length 必须大于等于 2。
  • DeveloperError ：times.length 必须等于 points.length。
  • DeveloperError ：inTangents 和 outTangents 的长度必须等于 points.length - 1。
  • DeveloperError ：inTangents 和 outTangents 的类型必须与 points 相同。
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>
engine/Source/Core/HermiteSpline.js 263

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

readonly outTangents : Array.<Cartesian3>
engine/Source/Core/HermiteSpline.js 277

每个控制点处的离开切线数组。

readonly points : Array.<Cartesian3>
engine/Source/Core/HermiteSpline.js 249

控制点数组。

readonly times : Array.<number>
engine/Source/Core/HermiteSpline.js 235

控制点的时间数组。

Methods

static Cesium.HermiteSpline.createC1(options) → HermiteSpline
engine/Source/Core/HermiteSpline.js 322

创建一个样条，其中每个控制点处的切线相同。 这些曲线保证至少属于 C1 类。
Name Type Description
options object 包含以下属性的对象：
Name Type Description
times Array.<number> 控制点时间数组。
points Array.<Cartesian3> 控制点数组。
tangents Array.<Cartesian3> 控制点处的切线数组。
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
engine/Source/Core/HermiteSpline.js 452

创建一个钳制三次样条。内部控制点处的切线被生成 以构造属于 C2 类的曲线。
Name Type Description
options object 包含以下属性的对象：
Name Type Description
times Array.<number> 控制点时间数组。
points Array.<number> | Array.<Cartesian3> 控制点数组。
firstTangent Cartesian3 第一个控制点的离开切线。
lastTangent Cartesian3 最后一个控制点的进入切线。
Returns:
一个 Hermite 样条；如果给定的控制点少于 3 个，则为线性样条。
Throws:
  • DeveloperError ：points、times、firstTangent 和 lastTangent 是必需的。
  • DeveloperError ：points.length 必须大于等于 2。
  • DeveloperError ：times.length 必须等于 points.length。
  • DeveloperError ：firstTangent 和 lastTangent 的类型必须与 points 相同。
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
engine/Source/Core/HermiteSpline.js 382

创建一个自然三次样条。控制点处的切线被生成 以构造属于 C2 类的曲线。
Name Type Description
options object 包含以下属性的对象：
Name Type Description
times Array.<number> 控制点时间数组。
points Array.<Cartesian3> 控制点数组。
Returns:
一个 Hermite 样条；如果给定的控制点少于 3 个，则为线性样条。
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
engine/Source/Core/HermiteSpline.js 554

将给定时间钳制到样条所覆盖的时间段内。
Name Type Description
time number 时间。
Returns:
被钳制到动画周期内的时间。

evaluate(time, result) → Cartesian3
engine/Source/Core/HermiteSpline.js 567

在给定时间处计算曲线的值。
Name Type Description
time number 用于计算曲线值的时间。
result Cartesian3 optional 用于存储结果的对象。
Returns:
修改后的 result 参数；或给定时间处曲线上点的新实例。
Throws:
  • DeveloperError ：time 必须位于范围 [t0, tn] 内，其中 t0 是数组 times 中的第一个元素，tn 是 数组 times 中的最后一个元素。

findTimeInterval(time) → number
engine/Source/Core/HermiteSpline.js 533

在 times 中找到一个索引 i，使得参数 time 位于区间 [times[i], times[i + 1]] 内。
Name Type Description
time number 时间。
Returns:
区间起始处元素的索引。
Throws:
  • DeveloperError ：time 必须位于范围 [t0, tn] 内，其中 t0 是数组 times 中的第一个元素，tn 是 数组 times 中的最后一个元素。

wrapTime(time) → number
engine/Source/Core/HermiteSpline.js 545

将给定时间环绕到样条所覆盖的时间段内。
Name Type Description
time number 时间。
Returns:
被环绕到更新后动画的时间。
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets