new Cesium.FrameRateMonitor(options)
监视
Scene
中的帧速率(每秒帧数),如果帧速率低于阈值,则引发事件。
稍后,如果帧速率返回到所需的级别,则会引发单独的事件。
为了避免为单个Scene
创建多个frameratemonitor,可以使用FrameRateMonitor.fromScene
而不是显式地构造一个实例。
Name | Type | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
optional
具有下列属性的对象:
|
成员变量
默认的帧速率监控设置,当
FrameRateMonitor.fromscene
需要创建一个新的帧速率监控器时,以及对于没有传递给FrameRateMonitor
构造函数的任何设置,将使用这些设置。
lastFramesPerSecond : Number
获取最后一个
samplingWindow
>上最近计算的平均每秒帧数。如果未计算帧速率,则此属性可能未定义。
lowFrameRate : Event
获取检测到低帧速率时引发的事件。函数的第一个参数是
Scene
实例,第二个参数是采样窗口每秒的平均帧数。
minimumFrameRateAfterWarmup : Number
获取或设置预热期间过后可接受性能所需的每秒最低帧数。
minimumFrameRateDuringWarmup : Number
获取或设置预热期间可接受性能所需的每秒最低帧数。
nominalFrameRate : Event
获取在帧速率较低后返回到正常水平时引发的事件。函数的第一个参数是
Scene
实例,第二个参数是采样窗口每秒的平均帧数。
quietPeriod : Number
获取或者设置在开始测量性能之前,在启动时等待的时间以及每次页面变得可见(例如,当用户切换回选项卡时)的时间(以秒为单位)。
samplingWindow : Number
获取或设置要在其上计算平均帧速率的滑动窗口的长度(以秒为单位)。
scene : Scene
获取用于监视性能的
Scene
实例。
warmupPeriod : Number
获取或设置预热周期的长度,以秒为单位。
内置方法
Name | Type | Description |
---|---|---|
scene |
Scene |
获取FrameRateMonitor 的场景。 |
返回值:
场景的
FrameRateMonitor
.
destroy()
销毁此对象持有的WebGL资源。
一旦对象被销毁,它将不能在使用; 调用除
一旦对象被销毁,它将不能在使用; 调用除
isDestroyed
之外的任何函数都会导致DeveloperError
异常。
因此,将返回值(undefined
)赋给对象,如示例所示。
异常情况:
-
DeveloperError : 对象已经被销毁。
返回值:
false
pause()
暂停对帧速率的监视。要恢复监视,每次调用此函数时必须调用
FrameRateMonitor#unpause
一次。
unpause()
继续监控帧速率。如果多次调用
FrameRateMonitor#pause
,则必须调用相同次数的此函数才能实际恢复监视。