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 （）を最初に呼び出す前に一度だけ呼び出される。サブクラスで再実装してください。

この関数は、必要な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)を再実装します。

Paintevent ハンドラ。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 を使用する場合に大きくなります。paintUnderGL() とpaintOverGL() がデフォルトのフレームバッファ、つまりウィンドウ表面を直接ターゲットとするのに対し、paintGL() はこの追加フレームバッファオブジェクトをターゲットとし、その内容は保持されます。

paintGL()、paintOverGL()、UpdateBehaviorも参照 。

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

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

Resizeevent ハンドラ。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 の更新動作を返します。