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コマンドキューにマーカーを置き、GPUがこのマーカーに到達したときのタイムスタンプを記録します。この関数はノンブロッキングで、結果は後で利用可能になります。

結果の可用性はisResultAvailable() で確認できます。結果はwaitForResult() でフェッチできます。この関数は、結果がまだ利用可能でない場合にブロックします。

waitForResult()、isResultAvailable()、begin()、end()も参照 。

GLuint64 QOpenGLTimerQuery::waitForResult() const

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

この関数は、OpenGLによって結果が利用可能になるまでブロックされます。不必要なブロックやストールを避けるために、isResultAvailable （）を呼び出して、結果が利用可能であることを確認することをお勧めします。

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

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

以前に発行されたすべてのOpenGLコマンドがGPUによって実行されたとは限らないが、受信されたときのGPUの現在のタイムスタンプを返します。

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

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