QOpenGLTimerQuery Class

メンバ関数のドキュメント

[explicit] QOpenGLTimerQuery::QOpenGLTimerQuery(QObject *parent = nullptr)

指定されたparent を使用して、QOpenGLTimerQueryのインスタンスを作成します。使用するには、有効なOpenGLコンテキストを指定してcreate()を呼び出す必要があります。

[virtual noexcept] QOpenGLTimerQuery::~QOpenGLTimerQuery()

QOpenGLTimerQuery およびその基盤となる OpenGL リソースを破棄します。

void QOpenGLTimerQuery::begin()

このクエリオブジェクトによってタイミング制御される一連のコマンドについて、OpenGLコマンドキュー内の開始位置を指定します。

これは単純なユースケースで役立ちます。通常は、recordTimestamp() を使用する方が望ましいです。

end()、isResultAvailable()、waitForResult()、およびrecordTimestamp()も参照してください 。

bool QOpenGLTimerQuery::create()

基盤となる OpenGL タイマークエリオブジェクトを作成します。この関数が成功するには、クエリオブジェクトをサポートする有効な OpenGL コンテキストがアクティブである必要があります。

OpenGLタイマークエリオブジェクトが正常に作成された場合、true を返します。

void QOpenGLTimerQuery::destroy()

基になる OpenGL タイマー照会オブジェクトを破棄します。この関数を呼び出す際には、create() が呼び出された時点でアクティブだったコンテキストが、現在もアクティブである必要があります。

void QOpenGLTimerQuery::end()

このクエリーオブジェクトによってタイミングが測定される一連のコマンドについて、OpenGLコマンドキュー内の終了点を指定します。

これは単純なユースケースで有用です。通常は、recordTimestamp() を使用する方が望ましいです。

begin()、isResultAvailable()、waitForResult()、およびrecordTimestamp()も参照してください 。

bool QOpenGLTimerQuery::isCreated() const

基になる OpenGL クエリオブジェクトが作成されている場合、true を返します。これがtrue を返し、かつ関連する OpenGL コンテキストが現在のコンテキストである場合、このオブジェクトを使用してクエリを発行することができます。

bool QOpenGLTimerQuery::isResultAvailable() const

OpenGL タイマークエリの結果が利用可能な場合、true を返します。

この関数はノンブロッキングであり、waitForResult() を呼び出す前に、クエリ結果が利用可能かどうかを確認するために使用するのが理想的です。

waitForResult()も参照してください 。

GLuint QOpenGLTimerQuery::objectId() const

基になる OpenGL クエリオブジェクトの ID を返します。

void QOpenGLTimerQuery::recordTimestamp()

GPUがこのマーカーに到達した際のタイムスタンプを記録するために、OpenGLコマンドキューにマーカーを配置します。この関数はノンブロッキングであり、結果は後ほど利用可能になります。

結果が利用可能かどうかは、isResultAvailable() で確認できます。結果はwaitForResult() で取得できますが、結果がまだ利用できない場合はこの関数はブロックします。

waitForResult()、isResultAvailable()、begin()、およびend()も参照してください 。

GLuint64 QOpenGLTimerQuery::waitForResult() const

OpenGL タイマーのクエリ結果を返します。

この関数は、OpenGL によって結果が利用可能になるまでブロックします。不要なブロックや処理の停滞を避けるため、結果が利用可能であることを確認するために `isResultAvailable()` を呼び出すことを推奨します。

isResultAvailable()も参照してください 。

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

以前に発行されたすべての OpenGL コマンドが GPU によって受信されたが、必ずしも GPU によって実行されたわけではない状態での、GPU の現在のタイムスタンプを返します。

この関数は、結果が返されるまでブロックします。

recordTimestamp()も参照してください 。