提供时间动态点云数据的回放。
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
|
使用三维平铺样式语言定义的样式,应用于点云中的每个点。 |
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#shadows
为true
时呈现。
-
Default Value:
ShadowMode.ENABLED
show : Boolean
确定是否显示点云。
-
Default Value:
true
style : BM3DTileStyle
使用三维平铺样式语言定义的样式,应用于点云中的每个点。
assignundefined
删除样式,这将在未应用样式时将点云的视觉外观恢复为默认外观。
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内存总量(字节)。
Methods
destroy()
销毁此对象持有的WebGL资源。销毁对象允许确定地释放WebGL资源,而不是依赖垃圾收集器来销毁此对象。
一旦对象被破坏,就不应使用它;调用除
一旦对象被破坏,就不应使用它;调用除
isDestroyed
以外的任何函数都将导致DeveloperError
异常。因此,将返回值(undefined
)赋给对象,如示例中所述。
Throws
-
DeveloperError : 此对象已被销毁,即调用destroy()。
将点云的
TimeDynamicPointCloud#style
标记为脏,这将强制所有点在下一帧中重新评估样式。