TimeDynamicPointCloud

提供时间动态点云数据的回放。

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

new TimeDynamicPointCloud(options)
Parameters:
options (Object)
Name Description
options.clock
Clock
确定时间维度值时使用的Clock实例。
options.intervals
TimeIntervalCollection
aTimeIntervalCollection其数据属性是包含uri到三维瓦片点云瓦片和可选transform的对象。
options.show
Boolean
default true
确定是否显示点云。
options.modelMatrix
Matrix4
default Matrix4.IDENTITY
转换点云的4x4变换矩阵。
options.shadows
ShadowMode
default ShadowMode.ENABLED
确定点云是投射还是接收来自每个光源的阴影。
options.maximumMemoryUsage
Number
default 256
点云可以使用的最大内存量(MB)。
options.shading
Object
用于构建PointCloudShading对象以控制点衰减和眼罩照明的选项。
options.style
BM3DTileStyle
使用3D Tiles Styling language定义的样式,应用于点云中的每个点。
options.clippingPlanes
ClippingPlaneCollection
ClippingPlaneCollection用于有选择地禁用渲染点云。

Members

(readonly) boundingSphere : BoundingSphere

正在渲染的帧的边界球体。如果未呈现帧,则返回undefined

clippingPlanes : ClippingPlaneCollection

ClippingPlaneCollection用于有选择地禁用渲染点云。

frameChanged : Event

触发的事件指示已呈现新帧。

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

Default Value: new Event()
Example:
pointCloud.frameChanged.addEventListener(function(timeDynamicPointCloud) {
    viewer.camera.viewBoundingSphere(timeDynamicPointCloud.boundingSphere);
});

frameFailed : Event

触发的事件指示未能加载帧。如果对其uri的请求失败或由于内容无效而处理失败,则帧可能无法加载。

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

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

  • uri:失败帧的URI。
  • message:错误消息。
Default Value: new Event()
Example:
pointCloud.frameFailed.addEventListener(function(error) {
    console.log('An error occurred loading frame: ' + error.uri);
    console.log('Error: ' + error.message);
});

maximumMemoryUsage : Number

可用于缓存点云帧的最大GPU内存量(以MB为单位)。

未加载或渲染的帧将卸载以强制执行此操作。

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

Default Value: 256
See:

modelMatrix : Matrix4

转换点云的4x4变换矩阵。
Default Value: Matrix4.IDENTITY

(readonly) readyPromise : Promise.<TimeDynamicPointCloud>

获取将在点云首次呈现帧时解决的承诺。

shading : PointCloudShading

基于几何误差和眼罩照明控制点大小的选项。

shadows : ShadowMode

确定点云是投射还是接收来自每个光源的阴影。

启用阴影会影响性能。投射阴影的点云必须渲染两次,一次从相机渲染,一次从灯光渲染。

阴影仅在Viewer#shadowstrue时呈现。

Default Value: ShadowMode.ENABLED

show : Boolean

确定是否显示点云。
Default Value: true

style : BM3DTileStyle

使用3D Tiles Styling language定义的样式,应用于点云中的每个点。

assignundefined删除样式,这将在未应用样式时将点云的视觉外观恢复为默认外观。

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

(readonly) totalMemoryUsageInBytes : Number

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

Methods

destroy()
销毁此对象持有的WebGL资源。销毁对象允许确定地释放WebGL资源,而不是依赖垃圾收集器来销毁此对象。

一旦对象被破坏,就不应使用它;调用除isDestroyed以外的任何函数都将导致DeveloperError异常。因此,将返回值(undefined)赋给对象,如示例中所述。
Example
pointCloud = pointCloud && pointCloud.destroy();
Throws
See:
isDestroyed() → {Boolean}
如果此对象被破坏,则返回true;否则返回false。

如果此对象被破坏,则不应使用它;调用除isDestroyed以外的任何函数将导致DeveloperError异常。
See:
makeStyleDirty()
将点云的TimeDynamicPointCloud#style标记为脏,这将强制所有点在下一帧中重新评估样式。