QOpenGLWindow Class

QSurfaceFormat format;
format.setDepthBufferSize(24);
format.setStencilBufferSize(8);
setFormat(format);

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

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

指定されたparent およびupdateBehavior を使用して、新しいQOpenGLWindowを構築します。

QOpenGLWindow::UpdateBehaviorも参照してください 。

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLContext *shareContext, QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

指定されたparent およびupdateBehavior を使用して、新しいQOpenGLWindowを構築します。このQOpenGLWindowのコンテキストは、shareContext と共有されます。

QOpenGLWindow::UpdateBehavior およびshareContextも参照してください 。

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

QOpenGLWindow インスタンスを破棄し、そのリソースを解放します。

デストラクタ内で OpenGLWindow のコンテキストがアクティブに設定されるため、このウィンドウが提供するコンテキストに属する OpenGL リソースを解放する必要がある子オブジェクトを安全に破棄することができます。

makeCurrentも参照してください 。

QOpenGLContext *QOpenGLWindow::context() const

このウィンドウで使用されているQOpenGLContext を返します。まだ初期化されていない場合は、0 を返します。

GLuint QOpenGLWindow::defaultFramebufferObject() const

このウィンドウで使用されるフレームバッファオブジェクトのハンドル。

更新動作がNoPartialUpdate に設定されている場合、個別のフレームバッファオブジェクトは存在しません。この場合、戻り値はデフォルトのフレームバッファのIDとなります。

それ以外の場合は、フレームバッファオブジェクトのID、またはまだ初期化されていない場合は0 が返されます。

void QOpenGLWindow::doneCurrent()

コンテキストを解放します。

paintGL() を呼び出す際、ウィジェットがコンテキストのバインドと解放を適切に処理するため、ほとんどの場合、この関数を呼び出す必要はありません。

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

[signal] void QOpenGLWindow::frameSwapped()

このシグナルは、ブロックされる可能性のあるbuffer swap が実行された後に発信されます。垂直リフレッシュに同期して継続的に再描画を行いたいアプリケーションは、このシグナルを受け取った際にupdate()を呼び出す必要があります。これにより、従来のタイマーを使用した方法に比べて、はるかにスムーズな操作感を実現できます。

QImage QOpenGLWindow::grabFramebuffer()

フレームバッファのコピーを返します。

[virtual protected] void QOpenGLWindow::initializeGL()

この仮想関数は、paintGL() またはresizeGL() が最初に呼び出される前に 1 回呼び出されます。サブクラスでこれを再実装してください。

この関数では、必要な OpenGL リソースと状態を設定する必要があります。

makeCurrent() を呼び出す必要はありません。この関数が呼び出された時点で、すでにその処理は完了しているからです。ただし、部分更新モードが使用されている場合、この段階ではフレームバッファがまだ利用できないため、ここから描画呼び出しを行わないでください。そのような呼び出しは、代わりにpaintGL() まで延期してください。

paintGL() およびresizeGL()も参照してください 。

bool QOpenGLWindow::isValid() const

コンテキストなどのウィンドウの OpenGL リソースが正常に初期化された場合、true を返します。なお、ウィンドウがエクスポーズ（表示）されるまでは、戻り値は常にfalse となることに注意してください。

void QOpenGLWindow::makeCurrent()

このウィンドウの OpenGL コンテンツのレンダリングに備えて、対応するコンテキストをアクティブにし、そのコンテキスト内にフレームバッファオブジェクトが存在する場合はそれをバインドします。

paintGL() を呼び出す前に自動的に呼び出されるため、ほとんどの場合、この関数を明示的に呼び出す必要はありません。ただし、GUI スレッドやメインスレッドとは異なるスレッドがサーフェスやフレームバッファの内容を更新したいといった、高度なマルチスレッド環境に対応するために、この関数は用意されています。スレッド関連の問題に関する詳細については、QOpenGLContext を参照してください。

この関数は、基盤となるプラットフォームウィンドウがすでに破棄されている場合でも呼び出すのに適しています。つまり、QOpenGLWindow のサブクラスのデストラクタからこの関数を呼び出しても安全です。ネイティブウィンドウがもはや存在しない場合は、代わりにオフスクリーンサーフェスが使用されます。これにより、この関数が最初に呼び出される限り、デストラクタ内でのOpenGLリソースのクリーンアップ処理が常に正常に実行されることが保証されます。

QOpenGLContext 、context()、paintGL()、およびdoneCurrent()も参照してください 。

[override virtual protected] void QOpenGLWindow::paintEvent(QPaintEvent *event)

QPaintDeviceWindow::paintEvent(QPaintEvent *event) を再実装します。

event ハンドラを描画します。paintGL() を呼び出します。

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

[virtual protected] void QOpenGLWindow::paintGL()

この仮想関数は、ウィンドウの内容を描画する必要があるたびに呼び出されます。サブクラスでこれを再実装してください。

makeCurrent() を呼び出す必要はありません。この関数が呼び出される時点で、すでにその処理は行われているためです。

この関数を呼び出す前に、コンテキストと（存在する場合の）フレームバッファがバインドされ、glViewport() の呼び出しによってビューポートが設定されます。それ以外の状態は設定されず、フレームワークによるクリアや描画は行われません。

関連項目： initializeGL()、resizeGL()、paintUnderGL()、paintOverGL()、およびUpdateBehavior 。

[virtual protected] void QOpenGLWindow::paintOverGL()

この仮想関数は、paintGL() が呼び出されるたびに呼び出されます。

更新モードがNoPartialUpdate に設定されている場合、この関数とpaintGL()との間に違いはなく、どちらでレンダリングを行っても同じ結果になります。

paintUnderGL() と同様に、この関数でのレンダリングは、更新の挙動にかかわらず、ウィンドウのデフォルトのフレームバッファを対象とします。この関数は、paintGL() が戻り、ブリット (PartialUpdateBlit) またはクワッド描画 (PartialUpdateBlend) が完了した後に呼び出されます。

paintGL()、paintUnderGL()、およびUpdateBehaviorも参照してください 。

[virtual protected] void QOpenGLWindow::paintUnderGL()

paintGL() が呼び出されるたびに、この仮想関数が呼び出されます。

更新モードがNoPartialUpdate に設定されている場合、この関数とpaintGL()との間に違いはなく、どちらでレンダリングを行っても同じ結果になります。

この違いは、追加のフレームバッファオブジェクトが使用される `PartialUpdateBlend` を使用する場合に顕著になります。この場合、`paintGL()` はこの追加のフレームバッファオブジェクトを対象とし、その内容を保持しますが、`paintUnderGL()` および `paintOverGL()` はデフォルトのフレームバッファ、つまりウィンドウサーフェスを直接対象とするため、各フレームの表示後にその内容は失われます。

paintGL()、paintOverGL()、およびUpdateBehaviorも参照してください 。

[override virtual protected] void QOpenGLWindow::resizeEvent(QResizeEvent *event)

QWindow::resizeEvent(QResizeEvent *ev) を再実装します。

event のハンドラをリサイズします。resizeGL()を呼び出します。

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

[virtual protected] void QOpenGLWindow::resizeGL(int w, int h)

この仮想関数は、ウィジェットのサイズが変更されるたびに呼び出されます。サブクラスでこれを再実装してください。新しいサイズは、w およびh に渡されます。

関連項目： initializeGL() およびpaintGL()。

QOpenGLContext *QOpenGLWindow::shareContext() const

このウィンドウの `QOpenGLContext` と共有するよう要求された `QOpenGLContext ` を返します。

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

このQOpenGLWindow の更新動作を返します。