TimeDynamicPointCloud

new Cesium.TimeDynamicPointCloud(options)

提供时间动态点云数据的播放功能。

点云帧根据平均帧加载时间和当前时钟速度确定的间隔进行预取。 如果中间帧无法及时加载以满足播放速度,它们将被跳过。如果帧足够 小或时钟足够慢,则不会跳过任何帧。

Name Type Description
options object 包含以下属性的对象:
Name Type Default Description
clock Clock 用于确定时间维度值的 Clock 实例。
intervals TimeIntervalCollection 一个 TimeIntervalCollection,其 data 属性为包含 3D Tiles 点云瓦片的 uri 和可选的 transform 的对象。
show boolean true optional 确定是否显示点云。
modelMatrix Matrix4 Matrix4.IDENTITY optional 用于变换点云的 4x4 变换矩阵。
shadows ShadowMode ShadowMode.ENABLED optional 确定点云是否从光源投射或接收阴影。
maximumMemoryUsage number 256 optional 点云可使用的最大内存(MB)。
shading object optional 用于构建 PointCloudShading 对象的选项,以控制点衰减和眼罩照明。
style Cesium3DTileStyle optional 使用 3D Tiles 样式语言 定义的样式,应用于点云中的每个点。
clippingPlanes ClippingPlaneCollection optional 用于选择性禁用点云渲染的 ClippingPlaneCollection

Members

正在渲染的帧的包围球。如果没有正在渲染的帧,则返回 undefined
用于选择性禁用点云渲染的 ClippingPlaneCollection
用于表示渲染了新帧时触发的事件。

时间动态点云 TimeDynamicPointCloud 将传递给事件监听器。

Default Value: new Event()
Example:
pointCloud.frameChanged.addEventListener(function(timeDynamicPointCloud) {
    viewer.camera.viewBoundingSphere(timeDynamicPointCloud.boundingSphere);
});
用于表示帧加载失败时触发的事件。帧加载失败可能是由于其 uri 请求失败或内容无效导致处理失败。

如果没有事件监听器,错误消息将输出到控制台。

传递给监听器的错误对象包含两个属性:

  • uri:失败帧的 uri。
  • message:错误消息。
Default Value: new Event()
Example:
pointCloud.frameFailed.addEventListener(function(error) {
    console.log(`加载帧时发生错误:${error.uri}`);
    console.log(`错误:${error.message}`);
});
可用于缓存点云帧的最大 GPU 内存量(MB)。

未加载或渲染的帧会被卸载以强制执行此限制。

如果减小此值导致卸载瓦片,则瓦片将在下一帧卸载。

Default Value: 256
See:
用于变换点云的 4x4 变换矩阵。
Default Value: Matrix4.IDENTITY
用于控制基于几何误差的点大小和眼罩照明的选项。
确定点云是否从光源投射或接收阴影。

启用阴影会对性能产生影响。投射阴影的点云必须渲染两次,一次从相机视角,一次从光源视角。

仅当 Viewer#shadowstrue 时才渲染阴影。

Default Value: ShadowMode.ENABLED
确定是否显示点云。
Default Value: true
使用 3D Tiles 样式语言 定义的样式,应用于点云中的每个点。

赋值为 undefined 可移除样式,这将恢复点云在未应用样式时的默认视觉外观。

Example:
pointCloud.style = new Cesium.Cesium3DTileStyle({
   color : {
       conditions : [
           ['${Classification} === 0', 'color("purple", 0.5)'],
           ['${Classification} === 1', 'color("red")'],
           ['true', '${COLOR}']
       ]
   },
   show : '${Classification} !== 2'
});
See:

readonly totalMemoryUsageInBytes : number

点云使用的 GPU 内存总量(字节)。
See:

Methods

销毁此对象持有的 WebGL 资源。销毁对象可以确定性释放 WebGL 资源,而不是依赖垃圾回收器来销毁此对象。

对象销毁后不应使用;调用除 isDestroyed 之外的任何函数都将导致 DeveloperError 异常。因此, 应将返回值(undefined)赋给该对象,如示例所示。
Throws:
Example:
pointCloud = pointCloud && pointCloud.destroy();
See:
如果此对象已被销毁,则返回 true;否则返回 false。

如果此对象已被销毁,则不应使用;调用除 isDestroyed 之外的任何函数都将导致 DeveloperError 异常。
Returns:
如果此对象已被销毁,则返回 true;否则返回 false
See:
将点云的 TimeDynamicPointCloud#style 标记为脏,这会强制所有点在下一帧重新评估样式。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.