SampledProperty

new Cesium.SampledProperty(type, derivativeTypes)

一个 Property,其值是从提供的一组样本和指定的插值算法与程度中, interpolated 为给定时间的。
Name Type Description
type number | Packable 属性的类型。
derivativeTypes Array.<Packable> optional 提供时,指示样本将包含指定类型的导数信息。
Examples:
//Create a linearly interpolated Cartesian2
const property = new Cesium.SampledProperty(Cesium.Cartesian2);

//Populate it with data
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:00:00.00Z'), new Cesium.Cartesian2(0, 0));
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-02T00:00:00.00Z'), new Cesium.Cartesian2(4, 7));

//Retrieve an interpolated value
const result = property.getValue(Cesium.JulianDate.fromIso8601('2012-08-01T12:00:00.00Z'));
//Create a simple numeric SampledProperty that uses third degree Hermite Polynomial Approximation
const property = new Cesium.SampledProperty(Number);
property.setInterpolationOptions({
    interpolationDegree : 3,
    interpolationAlgorithm : Cesium.HermitePolynomialApproximation
});

//Populate it with data
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:00:00.00Z'), 1.0);
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:01:00.00Z'), 6.0);
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:02:00.00Z'), 12.0);
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:03:30.00Z'), 5.0);
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:06:30.00Z'), 2.0);

//Samples can be added in any order.
property.addSample(Cesium.JulianDate.fromIso8601('2012-08-01T00:00:30.00Z'), 6.2);

//Retrieve an interpolated value
const result = property.getValue(Cesium.JulianDate.fromIso8601('2012-08-01T00:02:34.00Z'));
See:

Members

backwardExtrapolationDuration : number

获取或设置在属性变为未定义之前向后推断的时间量。 值为 0 将无限制向后推断。
Default Value: 0
获取或设置在请求值时执行的向后推断类型 当在任何可用样本之前的时间请求值时。
Default Value: ExtrapolationType.NONE
获取每当该属性的定义发生变化时所触发的事件。 如果调用 getValue 对于相同时间会返回不同的结果,则认为定义已更改。
获取此属性使用的导数类型。

forwardExtrapolationDuration : number

获取或设置在属性变为未定义之前向前推断的时间量。 值为 0 将无限制向前推断。
Default Value: 0
获取或设置在请求值时执行的向前推断类型 当在任何可用样本之后的时间请求值时。
Default Value: ExtrapolationType.NONE
获取检索值时使用的插值算法。
Default Value: LinearApproximation
获取检索值时进行的插值程度。
Default Value: 1

readonly isConstant : boolean

获取一个值,指示该属性是否为常量。如果 getValue 对于当前定义始终返回相同的结果,则认为该属性是常量。
获取属性的类型。

Methods

addSample(time, value, derivatives)

添加一个新的样本。
Name Type Description
time JulianDate 样本时间。
value Packable 在提供时间的值。
derivatives Array.<Packable> optional 在提供时间的导数数组。

addSamples(times, values, derivativeValues)

添加一组样本。
Name Type Description
times Array.<JulianDate> 一个 JulianDate 实例的数组,每个索引对应一个样本时间。
values Array.<Packable> 值的数组,其中每个值对应于提供时间的索引。
derivativeValues Array.<Array> optional 一个数组,其中每个项是等效时间索引处的导数数组。
Throws:
  • DeveloperError : times 和 values 必须具有相同的长度。
  • DeveloperError : times 和 derivativeValues 必须具有相同的长度。

addSamplesPackedArray(packedSamples, epoch)

作为单个打包数组添加样本,其中每个新样本表示为一个日期, 后跟相应值和导数的打包表示。
Name Type Description
packedSamples Array.<number> 打包样本的数组。
epoch JulianDate optional 如果 packedSamples 中的任何日期是数字,则视为相对于该纪元的偏移量(以秒为单位)。
将此属性与提供的属性进行比较并返回 如果相等则为 true,否则为 false
Name Type Description
other Property optional 另一个属性。
Returns:
如果两个属性相等,则返回 true,否则返回 false

getValue(time, result)object

获取在提供时间的属性值。
Name Type Default Description
time JulianDate JulianDate.now() optional 要检索值的时间。如果省略,则使用当前系统时间。
result object optional 用于存储值的对象,如果省略,则创建并返回一个新实例。
Returns:
修改后的结果参数,如果未提供结果参数,则返回一个新实例。

removeSample(time)boolean

移除给定时间的样本(如果存在)。
Name Type Description
time JulianDate 样本时间。
Returns:
如果在该时间移除了样本,则返回 true,否则返回 false
移除给定时间区间内的所有样本。
Name Type Description
time TimeInterval 要移除所有样本的时间区间。

setInterpolationOptions(options)

设置插值时使用的算法和程度。
Name Type Description
options object optional 带有以下属性的对象:
Name Type Description
interpolationAlgorithm InterpolationAlgorithm optional 新的插值算法。如果未定义,则现有属性保持不变。
interpolationDegree number optional 新的插值程度。如果未定义,则现有属性保持不变。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.