QOpenGLTimeMonitor Class

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

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

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

setSampleCount() およびcreate()も参照してください 。

[virtual noexcept] QOpenGLTimeMonitor::~QOpenGLTimeMonitor()

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

bool QOpenGLTimeMonitor::create()

sampleCount() インスタンスを作成します。これは、recordSample() の連続した呼び出しの間に OpenGL コマンドの実行にかかった時間を追跡するために使用される OpenGL タイマークエリオブジェクトです。

OpenGL タイマー照会オブジェクトの作成に成功した場合、true を返します。

destroy()、setSampleCount()、およびrecordSample()も参照してください 。

void QOpenGLTimeMonitor::destroy()

このインスタンス内で使用されている OpenGL タイマークエリオブジェクトをすべて破棄します。

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

bool QOpenGLTimeMonitor::isCreated() const

基になる OpenGL クエリーオブジェクトが作成されている場合、true を返します。これがtrue を返し、かつ関連する OpenGL コンテキストがアクティブな状態であれば、このオブジェクトを使用して時間サンプルを記録することができます。

bool QOpenGLTimeMonitor::isResultAvailable() const

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

waitForSamples() およびwaitForIntervals()も参照してください 。

QList<GLuint> QOpenGLTimeMonitor::objectIds() const

OpenGLタイマークエリオブジェクトのオブジェクトIDを含むQList を返します。

int QOpenGLTimeMonitor::recordSample()

OpenGL コマンドキューのこの位置で OpenGL タイマークエリを発行します。アプリケーションのレンダリング関数内でこの関数を連続して呼び出すことで、この関数の連続した呼び出しの間に OpenGL コマンドの実行に要した GPU 時間の詳細情報を収集することができます。

setSampleCount()、isResultAvailable()、waitForSamples()、およびwaitForIntervals()も参照してください 。

void QOpenGLTimeMonitor::reset()

タイムモニターをリセットし、次のレンダリングフレームで使用できるようにします。前回の結果を取得した後、次のフレームで初めて `recordSample()` を呼び出す前に、この関数を呼び出してください。

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

int QOpenGLTimeMonitor::sampleCount() const

setSampleCount() で要求されたサンプルポイントの数を返します。setSampleCount() の後に create が正常に呼び出された場合、返される値は実際に使用可能なサンプルポイントの数となります。

サンプル数のデフォルト値は 2 であり、これにより 1 つの区間が測定されます。

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

void QOpenGLTimeMonitor::setSampleCount(int sampleCount)

サンプルポイント数をsampleCount に設定します。この関数でサンプル数を設定した後、create()を呼び出して、基盤となるOpenGLタイマークエリオブジェクトをインスタンス化する必要があります。

新しいsampleCount の値は、2以上でなければなりません。

sampleCount()、create()、およびrecordSample()も参照してください 。

QList<GLuint64> QOpenGLTimeMonitor::waitForIntervals() const

recordSample() の呼び出しによって区切られた時間間隔を含む `QList ` を返します。結果のベクトルには、実際のタイムスタンプのサンプルではなく、その間の間隔が表されているため、要素数が 1 つ少なくなります。

この関数は、OpenGL が結果が利用可能になったことを示すまでブロックされます。isResultAvailable() を使用してこの関数を呼び出す前に、結果が利用可能かどうかを確認することをお勧めします。

waitForSamples() およびisResultAvailable()も参照してください 。

QList<GLuint64> QOpenGLTimeMonitor::waitForSamples() const

recordSample() で取得した GPU タイムスタンプを含む `QList ` を返します。

この関数は、OpenGL が結果が利用可能になったことを示すまでブロックします。isResultAvailable() を呼び出す前に、結果が利用可能かどうかを確認することをお勧めします。

関連項目： waitForIntervals() およびisResultAvailable()。