QOpenGLDebugLogger Class

GLenum error = GL_NO_ERROR;
do {
    error = glGetError();
    if (error != GL_NO_ERROR) {
        // handle the error
    }
} while (error != GL_NO_ERROR);

QSurfaceFormat format;
// asks for a OpenGL 3.2 debug context using the Core profile
format.setMajorVersion(3);
format.setMinorVersion(2);
format.setProfile(QSurfaceFormat::CoreProfile);
format.setOption(QSurfaceFormat::DebugContext);

QOpenGLContext *context = new QOpenGLContext;
context->setFormat(format);
context->create();

QOpenGLContext *ctx = QOpenGLContext::currentContext();
QOpenGLDebugLogger *logger = new QOpenGLDebugLogger(this);

logger->initialize(); // initializes in the current context, i.e. ctx

ctx->hasExtension(QByteArrayLiteral("GL_KHR_debug"));

constQList<QOpenGLDebugMessage> messages=  logger->loggedMessages();for(constQOpenGLDebugMessageメッセージ)    qDebug() << message;

connect(logger, &QOpenGLDebugLogger::messageLogged, receiver, &LogHandler::handleLoggedMessage);
logger->startLogging();

QOpenGLDebugMessage message =
    QOpenGLDebugMessage::createApplicationMessage(QStringLiteral("Custom message"));

logger->logMessage(message);

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

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

与えられたparent で新しいロガーオブジェクトを構築します。

initialize()も参照 。

[virtual noexcept] QOpenGLDebugLogger::~QOpenGLDebugLogger()

ロガーオブジェクトを破棄します。

void QOpenGLDebugLogger::disableMessages(QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource, QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType, QOpenGLDebugMessage::Severities severities = QOpenGLDebugMessage::AnySeverity)

指定されたsources 、指定されたtypes 、指定されたseverities と任意のメッセージ ID を持つメッセージのロギングを無効にします。

ロギングは現在のコントロール・グループで無効になります。

enableMessages()、pushGroup()、popGroup()も参照してください 。

void QOpenGLDebugLogger::disableMessages(const QList<GLuint> &ids, QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource, QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType)

指定されたids 、指定されたsources からの、指定されたtypes のメッセージのロギングを無効にします。

ロギングは現在の制御グループで無効になります。

enableMessages()、pushGroup()、popGroup()も参照してください 。

void QOpenGLDebugLogger::enableMessages(QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource, QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType, QOpenGLDebugMessage::Severities severities = QOpenGLDebugMessage::AnySeverity)

与えられたsources から、与えられたtypes から、与えられたseverities と任意のメッセージ ID を持つメッセージのロギングを有効にします。

ロギングは現在の制御グループで有効になります。

disableMessages()、pushGroup()、popGroup()も参照 。

void QOpenGLDebugLogger::enableMessages(const QList<GLuint> &ids, QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource, QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType)

指定されたids 、指定されたsources からの、指定されたtypes の、任意の重要度のメッセージのロギングを有効にします。

ロギングは現在の制御グループで有効になります。

disableMessages()、pushGroup()、popGroup()も参照 。

bool QOpenGLDebugLogger::initialize()

現在のOpenGLコンテキストのオブジェクトを初期化します。初期化を成功させるには、コンテキストがGL_KHR_debug 拡張をサポートしていなければなりません。ロギングを行う前にオブジェクトを初期化しなければなりません。

同じコンテキストからこの関数を複数回呼び出しても安全です。

この関数は、以前に初期化されたオブジェクトのコンテキストを変更するのにも使えます。

ロガーが正常に初期化された場合はtrue を返し、そうでない場合は false を返します。

QOpenGLContextも参照してください 。

bool QOpenGLDebugLogger::isLogging() const

このオブジェクトが現在ロギング中であればtrue を返し、そうでなければ false を返します。

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

[slot] void QOpenGLDebugLogger::logMessage(const QOpenGLDebugMessage &debugMessage)

メッセージdebugMessage をOpenGLデバッグログに挿入します。これは、アプリケーションやライブラリがOpenGLアプリケーションのデバッグを容易にするカスタムメッセージを挿入する方法を提供します。

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

QList<QOpenGLDebugMessage> QOpenGLDebugLogger::loggedMessages() const

OpenGL内部デバッグ・ログで利用可能なメッセージをすべて読み込み、それらを返します。さらに、この関数は内部デバッグログをクリアするので、それ以降の呼び出しでは、すでに返されたメッセージは返されません。

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

QOpenGLDebugLogger::LoggingMode QOpenGLDebugLogger::loggingMode() const

オブジェクトのロギングモードを返す。

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

qint64 QOpenGLDebugLogger::maximumMessageLength() const

logMessage() に渡されたメッセージのテキストがサポートする最大長をバイト単位で返します。これはデバッグ・グループ名の最大長でもあります。グループをプッシュしたりポップしたりすると、デバッグ・グループ名をメッセージ・テキストとして持つメッセージが自動的にログに記録されるからです。

メッセージ・テキストが長すぎる場合は、QOpenGLDebugLogger によって自動的に切り捨てられます。

[signal] void QOpenGLDebugLogger::messageLogged(const QOpenGLDebugMessage &debugMessage)

このシグナルは、OpenGLサーバーからデバッグメッセージ（debugMessage 引数でラップされる）がログに記録されたときに発せられる。

OpenGLの実装によっては、このシグナルは、レシーバーが住んでいるスレッドとは別のスレッドから発せられる可能性があり、また、このオブジェクトが初期化されたQOpenGLContext が住んでいるスレッドとも異なる可能性があります。さらに、シグナルは複数のスレッドから同時に発せられる可能性もあります。Qtはクロススレッドのシグナル発信にキュー接続を利用するため、通常は問題ありませんが、接続タイプをDirectに強制した場合、このシグナルに接続されたスロットでの競合の可能性に注意する必要があります。

ロギングがSynchronousLogging モードで開始されている場合、OpenGL はこのシグナルがQOpenGLContext がバインドされているスレッドと同じスレッドから発行されることを保証します。

startLogging()も参照 。

void QOpenGLDebugLogger::popGroup()

デバッググループスタックから最上位のデバッググループをポップします。グループのポップに成功すると、OpenGLは自動的に、ポップされたグループのメッセージ、id、ソースに一致するメッセージ、タイプQOpenGLDebugMessage::GroupPopType 、重大度QOpenGLDebugMessage::NotificationSeverity 。

デバッググループをポップすると、デバッググループスタックのトップになるグループのメッセージフィルタリング設定が復元されます。

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

void QOpenGLDebugLogger::pushGroup(const QString &name, GLuint id = 0, QOpenGLDebugMessage::Source source = QOpenGLDebugMessage::ApplicationSource)

名前name 、idid 、ソースsource を持つデバッググループをデバッググループスタックにプッシュします。グループが正常にプッシュされると、OpenGLは自動的にメッセージname 、idid 、ソースsource 、タイプQOpenGLDebugMessage::GroupPushType 、重大度QOpenGLDebugMessage::NotificationSeverity を持つメッセージをログに記録します。

つまり、新しいグループをプッシュしてもフィルタリングは変更されません。

popGroup （）、enableMessages （）、disableMessages （）も参照 。

[slot] void QOpenGLDebugLogger::startLogging(QOpenGLDebugLogger::LoggingMode loggingMode = AsynchronousLogging)

OpenGLサーバーから来るメッセージのロギングを開始する。新しいメッセージを受信すると、ログに記録されたメッセージを引数として、シグナルmessageLogged() が発せられます。

loggingMode はロギングが非同期（デフォルト）か同期かを指定します。

QOpenGLDebugLogger は、ロギングが開始されたときに と の値を記録し、ロギングが停止されたときにそれらを戻します。さらに、この関数が呼び出されたときにインストールされたユーザー定義のOpenGLデバッグ・コールバックは、ロギングが停止されたときに元に戻されます。 は、既存のコールバックがロギング時にまだ呼び出されることを保証します。GL_DEBUG_OUTPUT GL_DEBUG_OUTPUT_SYNCHRONOUS QOpenGLDebugLogger

stopLogging() とinitialize()も参照してください 。

[slot] void QOpenGLDebugLogger::stopLogging()

OpenGLサーバーからのメッセージのロギングを停止する。

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