SampledProperty

new Cesium.SampledProperty (type, derivativeTypes )

一个 Property ,其值在给定时间内根据提供的样本集和指定的插值算法和度数进行插值。
Name Type Description
type Number | Packable 财产的类型。
derivativeTypes Array.< Packable > 可选 提供时,表示样本将包含指定类型的派生信息。
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

interpolationDegree : Number

获取检索值时要执行的插值程度。
Default Value: 1

readonly isConstant : Boolean

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

Methods

addSample (time, value, derivatives )

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

addSamples (times, values, derivativeValues )

添加样本数组。
Name Type Description
times Array.< JulianDate > 一个 JulianDate 实例数组,其中每个索引都是一个采样时间。
values Array.< Packable > 值数组,其中每个值对应于提供的时间索引。
derivativeValues Array.<Array> 可选 一个数组,其中每一项都是等效时间索引处的导数数组。
Throws:

addSamplesPackedArray (packedSamples, epoch )

将样本添加为单个打包数组,其中每个新样本都表示为日期,然后是对应值和导数的打包表示。
Name Type Description
packedSamples Array.<Number> 打包样本的数组。
epoch JulianDate 可选 如果 packedSamples 中的任何日期是数字,则它们被认为是与此纪元的偏移量,以秒为单位。

equals ( other ) Boolean

将此属性与提供的属性进行比较,如果相等则返回 true ,否则返回 false
Name Type Description
other Property 可选 其他属性。
Returns:
如果左右相等,则为 true ,否则为 false

getValue (time, result ) Object

在提供的时间获取属性的值。
Name Type Description
time JulianDate 检索值的时间。
result Object 可选 将值存储到其中的对象,如果省略,则创建并返回一个新实例。
Returns:
如果未提供结果参数,则修改结果参数或新实例。

removeSample (time) Boolean

在给定时间删除样本(如果存在)。
Name Type Description
time JulianDate 采样时间。
Returns:
如果某个时间的样本被删除,则为 true ,否则为 false
删除给定时间间隔的所有样本。
Name Type Description
time TimeInterval 移除所有样本的时间间隔。

setInterpolationOptions ( options )

设置插值时使用的算法和度数。
Name Type Description
options Object 具有以下属性的 可选 对象:
姓名 类型 描述
interpolationAlgorithm 插值算法 可选 新的插值算法。如果未定义,现有属性将保持不变。
interpolationDegree 数字 可选 新的插值度。如果未定义,现有属性将保持不变。