HermiteSpline

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

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 262

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

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

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

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

控制点的数组。

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

控制点的时间数组。

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 450

创建一个固定的立方样条。内部控制点的切线被生成以创建一个 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:
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 381

创建一个自然立方样条。控制点的切线被生成以创建一个 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 555

将给定时间限制在样条覆盖的周期内。
Name Type Description
time number 时间。
Returns:
时间，限制在动画周期内。

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

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

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

在 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 Forum.
packages/engine
packages/widgets