Cesium API - 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`外切线的数组。

异常情况：

DeveloperError : points.length 必须大于等于 2。
DeveloperError : times.length 必须等于 points.length.
DeveloperError : inTangents 和 outTangents 的长度必须等于 points.length - 1.

示例：

// 创建一个G¹连续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]);

参考：

成员变量

readonlyinTangents : Array.<Cartesian3>

Core/HermiteSpline.js 289

每个控制点上的Cartesian3内切线的数组。

readonlyoutTangents : Array.<Cartesian3>

Core/HermiteSpline.js 303

每个控制点上的Cartesian3外切线的数组。

readonlypoints : Array.<Cartesian3>

Core/HermiteSpline.js 275

Cartesian3控制点的数组。

readonlytimes : Array.<Number>

Core/HermiteSpline.js 261

控制点的时间数组。

内置方法

staticCesium.HermiteSpline.createC1(options) → HermiteSpline

Core/HermiteSpline.js 386

创建一个样条曲线（spline），其中每个控制点的切线都是相同的。保证这些曲线至少属于C类¹。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Description
`times`	Array.<Number>	控制点的时间的数组。
`points`	Array.<Cartesian3>	控制点的数组。
`tangents`	Array.<Cartesian3>	控制点的切线数组。

返回值：

Hermite样条曲线。

异常情况：

DeveloperError : 需要点、时间和切线。
DeveloperError : points.length 必须大于等于 2。
DeveloperError : 时间，点和切线必须有相同的长度。

示例：

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

Core/HermiteSpline.js 563

创建一个夹紧的（clamped）三次样条曲线（spline）。在C类²中，内部控制点的切线被生成为的曲线。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Description
`times`	Array.<Number>	控制点时间的数组。
`points`	Array.<Cartesian3>	控制点的数组。
`firstTangent`	Cartesian3	第一个控制点的外切线。
`lastTangent`	Cartesian3	最后一个控制点的内切线。

返回值：

给出了少于3个控制点的hermite样条曲线或线性样条曲线（spline）。

异常情况：

DeveloperError : 需要点，时间，firstTangent和lastTangent。
DeveloperError : points.length 必须大于等于 2。
DeveloperError : times.length 必须等于 points.length。

示例：

// 在从费城到洛杉矶的地球上空创建一个夹紧的（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

Core/HermiteSpline.js 467

创建一个自然的三次样条曲线。在C类²中，生成控制点的切线来创建一条曲线。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Description
`times`	Array.<Number>	控制点时间的数组。
`points`	Array.<Cartesian3>	控制点的数组。

返回值：

给出了少于3个控制点的hermite样条曲线或线性样条曲线（spline）。

异常情况：

DeveloperError : 需要点、时间和切线。
DeveloperError : points.length 必须大于等于 2。
DeveloperError : times.length 必须等于 points.length。

示例：

// 从费城到洛杉矶，在地面上创造一个自然的三次样条曲线。
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

Core/HermiteSpline.js 666

将给定的时间固定（clamps）到样条曲线（spline）所覆盖的周期。