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"));

const QList<QOpenGLDebugMessage> messages =  logger->loggedMessages();for(const QOpenGLDebugMessage &메시지: 메시지)    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)

OpenGL 디버그 로그에 debugMessage 메시지를 삽입합니다. 이를 통해 애플리케이션이나 라이브러리에서 사용자 지정 메시지를 삽입하여 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, id id, 소스 source 의 디버그 그룹을 디버그 그룹 스택에 푸시합니다. 그룹이 성공적으로 푸시되면 OpenGL은 메시지 name, id id, 소스 source, 유형 QOpenGLDebugMessage::GroupPushType 및 심각도 QOpenGLDebugMessage::NotificationSeverity 를 포함하는 메시지를 자동으로 기록합니다.

새로 푸시된 그룹은 스택 맨 위에 있던 그룹의 동일한 필터링 설정을 상속하므로 새 그룹을 푸시해도 필터링이 변경되지 않습니다.

popGroup(), enableMessages() 및 disableMessages()도 참조하세요 .

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

OpenGL 서버에서 오는 메시지 로깅을 시작합니다. 새 메시지가 수신되면 로깅된 메시지를 인자로 전달하는 messageLogged() 신호가 전송됩니다.

loggingMode 로깅이 비동기식(기본값)인지 동기식인지 지정합니다.

QOpenGLDebugLogger 로깅이 시작되면 GL_DEBUG_OUTPUT 및 GL_DEBUG_OUTPUT_SYNCHRONOUS 값을 기록하고 로깅이 중지되면 다시 설정합니다. 또한 이 함수가 호출될 때 설치된 사용자 정의 OpenGL 디버그 콜백은 로깅이 중지될 때 복원되며, QOpenGLDebugLogger 은 로깅 시 기존 콜백이 계속 호출되도록 합니다.

stopLogging() 및 initialize()도 참조하세요 .

[slot] void QOpenGLDebugLogger::stopLogging()

OpenGL 서버에서 메시지 로깅을 중지합니다.

startLogging()도 참조하세요 .