帧定时器 QML 类型

提供给定窗口的帧速率信息。更多...

导入语句	import QtApplicationManager 2.0

所有成员的列表，包括继承的成员

属性

averageFps : real
interval : int
jitterFps : real
maximumFps : real
minimumFps : real
roleNames : list<string>
running : bool
window : Object

方法

update()

详细描述

帧定时器用于获取给定窗口的帧速率信息。该窗口可以是顶级窗口（来自QtQuick.Window模块）或WindowObject（来自QtApplicationManager.SystemUI模块）。

以下代码片段演示了如何使用帧定时器显示窗口的帧速率：

import QtQuick
import QtApplicationManager

Window {
    id: toplevelWindow
    ...
    FrameTimer {
        id: frameTimer
        running: topLevelWindow.visible
        window: toplevelWindow
    }
    Text {
        text: "FPS: " + Number(frameTimer.averageFps).toLocaleString(Qt.locale("en_US"), 'f', 1)
    }
}

如果您想将其作为MonitorModel数据源，以便绘制其先前值随时间变化的图表，您也可以使用此组件。

import QtQuick
import QtApplicationManager

Window {
    id: toplevelWindow
    ...
    MonitorModel {
        running: true
        FrameTimer {
            window: toplevelWindow
        }
    }
}

请注意，当使用帧定时器作为MonitorModel数据源时，不需要将其设置为running，因为MonitorModel会根据需要调用update()。

属性文档

averageFps : real [只读]

自update()上次调用以来（无论是手动调用还是自动调用，当running设置为 true 时），给定window的平均帧速率，以每秒帧数表示。

另请参阅 window、running和update。

interval : int

当running属性为true时，update()调用之间间隔的毫秒数。

另请参阅update()和running。

jitterFps : real [只读]

自上次调用update()以来（无论手动还是自动，只要running被设置为true），给定window的帧率抖动，以每秒帧数为单位。

另请参阅 window、running和update。

maximumFps : real [只读]

自上次调用update()以来（无论手动还是自动，只要running被设置为true），给定window的最大帧率，以每秒帧数为单位。

另请参阅 window、running和update。

minimumFps : real [只读]

自上次调用update()以来（无论手动还是自动，只要running被设置为true），给定window的最小帧率，以每秒帧数为单位。

另请参阅 window、running和update。

roleNames : list<string> [只读]

当作为MonitorModel数据源使用时，FrameTimer提供的角色的名称。

另请参阅MonitorModel。

running : bool

如果为true，则每隔interval毫秒自动调用update()。

当将FrameTimer用作MonitorModel数据源时，此属性应保持为false。

另请参阅update()和interval。

window : Object

要监控的窗口，其中将收集帧率信息。它可以是一个顶级窗口（来自QtQuick.Window模块）或WindowObject（来自QtApplicationManager.SystemUI模块）。

另请参阅WindowObject。

方法文档

update()

更新属性averageFps、minimumFps、maximumFps和jitterFps。然后重置内部计数器，以便从调用此方法的那一刻起为新时间段收集新的数字。

请注意，通常您无需直接调用此方法，因为FrameTimer会在间隔毫秒内自动执行，当运行设置为true时。

另请参阅运行。