Hermite 样条是三次插值样条。必须为每个控制点定义点、入切线、出切线和时间。输出切线是为点 [0, n - 2] 定义的,而输入切线是为点 [1, n - 1] 定义的。例如,在
points[i]
和
points[i + 1]
之间插值曲线段时,点处的切线将分别为
outTangents[i]
和
inTangents[i]
。
Name | Type | Description | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
Throws:
-
DeveloperError : points.length 必须大于或等于 2。
-
DeveloperError :times.length 必须等于 points.length。
-
DeveloperError : inTangents 和 outTangents 的长度必须等于 points.length - 1。
-
DeveloperError : inTangents 和 outTangents 必须与点的类型相同。
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 points : Array.< Cartesian3 >
一组控制点。
控制点的时间数组。
Methods
static Cesium.HermiteSpline.createC1 (options) → HermiteSpline
创建一个样条曲线,其中每个控制点的切线都相同。保证曲线至少在 C
1
类中。
Name | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
具有以下属性的对象:
|
Returns:
Hermite 样条曲线。
Throws:
-
DeveloperError :需要点、时间和切线。
-
DeveloperError : points.length 必须大于或等于 2。
-
DeveloperError :时间、点和切线必须具有相同的长度。
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 |
具有以下属性的对象:
|
Returns:
如果给出少于 3 个控制点,则为 Hermite 样条或线性样条。
Throws:
-
DeveloperError : points, times, firstTangent 和 lastTangent 是必需的。
-
DeveloperError : points.length 必须大于或等于 2。
-
DeveloperError :times.length 必须等于 points.length。
-
DeveloperError : firstTangent 和 lastTangent 必须与点的类型相同。
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 |
具有以下属性的对象:
|
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.
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)
]
});
将给定时间限制在样条曲线覆盖的时间段内。
Name | Type | Description |
---|---|---|
time
|
Number | 时间。 |
Returns:
时间,夹在动画时期。
evaluate (time, result ) → Cartesian3
在给定时间评估曲线。
Name | Type | Description |
---|---|---|
time
|
Number | 评估曲线的时间。 |
result
|
Cartesian3 | 可选 存储结果的对象。 |
Returns:
修改后的结果参数或给定时间曲线上点的新实例。
Throws:
查找索引
i
以使参数
time
在区间 [
times
[times[i], times[i + 1]]
中。
Name | Type | Description |
---|---|---|
time
|
Number | 时间。 |
Returns:
间隔开始处元素的索引。
Throws:
将给定时间包装到样条覆盖的时间段。
Name | Type | Description |
---|---|---|
time
|
Number | 时间。 |
Returns:
时间,围绕着更新的动画。