QOpenGLContext Class

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

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

親オブジェクトparent を持つ新しいOpenGLコンテキストインスタンスを作成する。

使用する前に、適切なフォーマットを設定し、create() を呼び出す必要があります。

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

[virtual noexcept] QOpenGLContext::~QOpenGLContext()

QOpenGLContext オブジェクトを破棄します。

これがスレッドの現在のコンテキストである場合、doneCurrent() も呼び出されます。

[signal] void QOpenGLContext::aboutToBeDestroyed()

このシグナルは、基盤となるネイティブOpenGLコンテキストが破棄される前に発行されるため、OpenGLコンテキストが共有されている場合、ユーザーはOpenGLリソースをクリーンアップすることができます。

クリーンアップを行うためにコンテキストをカレントな状態にしたい場合は、直接接続のみを使用してシグナルに接続するようにしてください。

[static] bool QOpenGLContext::areSharing(QOpenGLContext *first, QOpenGLContext *second)

first とsecond コンテキストがOpenGLリソースを共有している場合、true を返します。

bool QOpenGLContext::create()

現在の構成でOpenGLコンテキストの作成を試みます。

現在の構成には、フォーマット、共有コンテキスト、スクリーンが含まれる。

システム上のOpenGL実装が要求されたバージョンのOpenGLコンテキストをサポートしていない場合、QOpenGLContext 、最も近いバージョンのOpenGLコンテキストの作成を試みる。実際に作成されたコンテキスト・プロパティは、format （）関数によって返されるQSurfaceFormat を使用して問い合わせることができる。たとえば、OpenGL 4.3 Coreプロファイルをサポートするコンテキストを要求したが、ドライバやハードウェアがバージョン3.2 Coreプロファイルのコンテキストしかサポートしていない場合、3.2 Coreプロファイルのコンテキストを取得します。

ネイティブ・コンテキストが正常に作成され、makeCurrent （）、swapBuffers （）などで使用する準備ができている場合は、true を返します。

makeCurrent() およびformat()も参照 。

[static] QOpenGLContext *QOpenGLContext::currentContext()

現在のスレッドで最後にmakeCurrent を呼び出したコンテキストを返すか、現在のコンテキストがない場合はnullptr を返す。

GLuint QOpenGLContext::defaultFramebufferObject() const

現在のサーフェスのデフォルトのフレームバッファオブジェクトを取得するためにこれを呼び出します。

いくつかのプラットフォーム（例えばiOS）では、デフォルトのフレームバッファオブジェクトはレンダリングされるサーフェスに依存し、0とは異なるかもしれません。したがって、異なるQtプラットフォーム間でアプリケーションを動作させたい場合は、glBindFramebuffer(0)を呼び出す代わりに、glBindFramebuffer(ctx->defaultFramebufferObject())を呼び出す必要があります。

QOpenGLFunctions 、glBindFramebuffer()を使用すると、0が渡されたときに現在のコンテキストのdefaultFramebufferObject()を自動的にバインドするので、この心配はありません。

QOpenGLFramebufferObjectも参照してください 。

void QOpenGLContext::doneCurrent()

makeCurrent を0サーフェスで呼び出すための便利な関数です。

この結果、現在のスレッドにはコンテキストが存在しなくなります。

makeCurrent() およびcurrentContext() も参照 。

QSet<QByteArray> QOpenGLContext::extensions() const

このコンテキストがサポートするOpenGL拡張のセットを返します。

このコンテキストまたは共有コンテキストはカレントでなければなりません。

hasExtension()も参照 。

QOpenGLExtraFunctions *QOpenGLContext::extraFunctions() const

このコンテキストのQOpenGLExtraFunctions インスタンスを取得します。

QOpenGLContext 手動で管理することなく にアクセスする便利な方法としてこれを提供しています。QOpenGLExtraFunctions

コンテキストまたは共有コンテキストが最新でなければなりません。

返されたQOpenGLExtraFunctions インスタンスはすぐに使用でき、initializeOpenGLFunctions()を呼び出す必要はありません。

QOpenGLFunctions およびQOpenGLExtraFunctionsも参照のこと 。

QSurfaceFormat QOpenGLContext::format() const

create() が呼び出された場合、基礎となるプラットフォーム・コンテキストのフォーマットを返す。

そうでない場合は、要求されたフォーマットを返します。

要求されたフォーマットと実際のフォーマットは異なる場合があります。指定されたOpenGLバージョンを要求しても、結果のコンテキストが要求されたバージョンを正確にターゲットにすることを意味するわけではありません。ドライバがそのようなコンテキストを提供できる限り、作成されるコンテキストのバージョン/プロファイル/オプションの組み合わせが要求と互換性があることだけが保証される。

たとえば、OpenGLバージョン3.xコアプロファイルコンテキストを要求すると、OpenGL 4.xコアプロファイルコンテキストが生成されるかもしれません。同様に、OpenGL 2.1のリクエストは、非推奨関数を有効にしたOpenGL 3.0コンテキストになるかもしれません。最後に、ドライバによっては、サポートされていないバージョンは、コンテキストの作成に失敗するか、サポートされている最も高いバージョンのコンテキストになる可能性があります。

たとえば、結果のコンテキストは要求されたよりも大きな深度バッファを持つかもしれません。これは完全に正常です。

setFormat()も参照 。

QOpenGLFunctions *QOpenGLContext::functions() const

このコンテキストのQOpenGLFunctions インスタンスを取得します。

QOpenGLContext これは、 を手動で管理することなくアクセスする便利な方法です。QOpenGLFunctions

コンテキストまたは共有コンテキストが最新でなければなりません。

返されたQOpenGLFunctions インスタンスはすぐに使用でき、initializeOpenGLFunctions() を呼び出す必要はありません。

QFunctionPointer QOpenGLContext::getProcAddress(const QByteArray &procName) const

で識別されるOpenGL拡張関数への関数ポインタを解決します。procName

そのような関数が見つからない場合はnullptr を返します。

QFunctionPointer QOpenGLContext::getProcAddress(const char *procName) const

これはオーバーロードされた関数です。

[static] QOpenGLContext *QOpenGLContext::globalShareContext()

アプリケーション全体で共有されているOpenGLコンテキストが存在する場合は、それを返します。そうでない場合は、nullptr を返します。

これは、QOpenGLWidget またはQQuickWidget を作成または表示する前に、OpenGL オブジェクト（バッファ、テクスチャなど）をアップロードする必要がある場合に便利です。

Qt::AA_ShareOpenGLContexts 、setShareContext()、makeCurrent()も参照 。

bool QOpenGLContext::hasExtension(const QByteArray &extension) const

このOpenGLコンテキストが指定されたOpenGLextension をサポートしている場合はtrue を返し、そうでない場合はfalse を返します。

コンテキストまたは共有コンテキストは現在のものでなければならない。

extensions()も参照 。

bool QOpenGLContext::isOpenGLES() const

コンテキストがOpenGL ESコンテキストである場合、trueを返します。

コンテキストがまだ作成されていない場合、結果はsetFormat() で設定された要求フォーマットに基づきます。

create()、format()、setFormat()も参照 。

bool QOpenGLContext::isValid() const

このコンテキストが有効かどうか、つまり正常に作成されたかどうかを返します。

いくつかのプラットフォームでは、以前に正常に作成されたコンテキストに対するfalse の返り値は、OpenGLコンテキストが失われたことを示します。

アプリケーションでコンテキスト喪失シナリオを処理する典型的な方法は、makeCurrent() が失敗してfalse を返すたびに、この関数でチェックすることである。この関数がfalse を返した場合、create （）を呼び出して基礎となるネイティブOpenGLコンテキストを再作成し、makeCurrent （）を再度呼び出してから、すべてのOpenGLリソースを再初期化します。

プラットフォームによっては、コンテキストが失われる状況は避けられません。しかし、他のプラットフォームでは、オプトインする必要があるかもしれません。これは、QSurfaceFormat でResetNotification を有効にすることで可能です。これは、基盤となるネイティブOpenGLコンテキストのRESET_NOTIFICATION_STRATEGY_EXT をLOSE_CONTEXT_ON_RESET_EXT に設定することにつながります。QOpenGLContext は、makeCurrent() のたびにglGetGraphicsResetStatusEXT() を介してステータスを監視します。

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

bool QOpenGLContext::makeCurrent(QSurface *surface)

与えられたsurface に対して、現在のスレッドでコンテキストをカレントにします。成功すればtrue を返し、そうでなければfalse を返す。成功した場合は を返し、失敗した場合は を返します。後者は、サーフェスが公開されていない場合や、 アプリケーションがサスペンドしているなどの理由でグラフィックハードウェアが利用できない場合に発生します。

surface がnullptr の場合、これはdoneCurrent() を呼び出すのと同じです。

この関数を、QOpenGLContext インスタンスが存在するスレッドとは異なるスレッドから呼び出すことは避けてください。異なるスレッドからQOpenGLContext を使用したい場合は、まず、必要に応じてdoneCurrent() を呼び出して、現在のスレッドでこの関数が使用されていないことを確認する必要があります。そして、他のスレッドで使用する前に、moveToThread(otherThread)を呼び出します。

デフォルトでは、Qtはスレッド親和性に関して上記の条件を強制するチェックを採用しています。このチェックを無効にするには、Qt::AA_DontCheckOpenGLContextThreadAffinity アプリケーション属性を設定します。QObject thread affinity ドキュメントで説明されているように、QObject をスレッド外から使用した場合の結果を理解しておいてください。

functions(),doneCurrent(),Qt::AA_DontCheckOpenGLContextThreadAffinityも参照してください 。

template <typename QNativeInterface> QNativeInterface *QOpenGLContext::nativeInterface() const

コンテキストに指定された型のネイティブ・インターフェースを返します。

この関数は、QNativeInterface 名前空間で定義されているQOpenGLContext のプラットフォーム固有の機能へのアクセスを提供します：

要求されたインターフェースが利用できない場合は、nullptr が返されます。

[static] QOpenGLContext::OpenGLModuleType QOpenGLContext::openGLModuleType()

基礎となるOpenGL実装タイプを返します。

OpenGL実装が動的にロードされないプラットフォームでは、戻り値はコンパイル時に決定され、変更されることはありません。

QScreen *QOpenGLContext::screen() const

コンテキストが作成された画面を返します。

setScreen()も参照 。

void QOpenGLContext::setFormat(const QSurfaceFormat &format)

OpenGLコンテキストが互換性を持つべきformat を設定します。この関数が有効になる前にcreate() を呼び出す必要があります。

この関数でフォーマットを明示的に設定しない場合、QSurfaceFormat::defaultFormat() が返すフォーマットが使用されます。つまり、複数のコンテキストを持つ場合、この関数を個別に呼び出す代わりに、最初のコンテキストを作成する前にQSurfaceFormat::setDefaultFormat() を 1 回呼び出すだけでよい。

format()も参照 。

void QOpenGLContext::setScreen(QScreen *screen)

OpenGLコンテキストが有効であるべきscreen を設定します。この関数が有効になる前にcreate() を呼び出す必要があります。

screen()も参照 。

void QOpenGLContext::setShareContext(QOpenGLContext *shareContext)

このコンテキストは、テクスチャ、シェーダ、およびその他の OpenGL リソースをshareContext と共有します。 この設定を有効にするには、create() を呼び出す必要があります。

shareContext() も参照 。

QOpenGLContext *QOpenGLContext::shareContext() const

このコンテキストが作成された共有コンテキストを返します。

基礎となるプラットフォームが要求された共有をサポートできなかった場合、これは 0 を返します。

setShareContext() も参照 。

QOpenGLContextGroup *QOpenGLContext::shareGroup() const

このコンテキストが属する共有グループを返します。

[static] bool QOpenGLContext::supportsThreadedOpenGL()

プラットフォームがメイン（gui）スレッド以外でのOpenGLレンダリングをサポートしている場合、true を返します。

この値は、使用しているプラットフォームプラグインによって制御され、グラフィックドライバにも依存します。

QSurface *QOpenGLContext::surface() const

コンテキストがカレントになっているサーフェスを返します。

これはmakeCurrent() の引数として渡されたサーフェスです。

void QOpenGLContext::swapBuffers(QSurface *surface)

surface のバックバッファとフロントバッファを入れ替えます。

OpenGLレンダリングのフレームを終了するためにこれを呼び出し、新しいフレームの一部など、それ以上のOpenGLコマンドを発行する前に、makeCurrent （）を再度呼び出すようにしてください。