QOpenGLContext Class

멤버 함수 문서

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

부모 객체가 있는 새 OpenGL 컨텍스트 인스턴스를 만듭니다 parent.

사용하려면 먼저 적절한 형식을 설정하고 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 에서 가장 일치하는 버전을 만들려고 시도합니다. format () 함수에서 반환된 QSurfaceFormat 을 사용하여 실제로 생성된 컨텍스트 속성을 쿼리할 수 있습니다. 예를 들어 OpenGL 4.3 코어 프로파일을 지원하는 컨텍스트를 요청했지만 드라이버 및/또는 하드웨어가 버전 3.2 코어 프로파일 컨텍스트만 지원하는 경우 3.2 코어 프로파일 컨텍스트를 가져옵니다.

네이티브 컨텍스트가 성공적으로 생성되어 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()

표면이 0인 makeCurrent 호출을 위한 편의 함수입니다.

이렇게 하면 현재 스레드에 현재 컨텍스트가 없습니다.

makeCurrent() 및 currentContext()도 참조하세요 .

QSet<QByteArray> QOpenGLContext::extensions() const

이 컨텍스트에서 지원되는 OpenGL 확장 집합을 반환합니다.

컨텍스트 또는 공유 컨텍스트는 최신 컨텍스트여야 합니다.

hasExtension()도 참조하세요 .

QOpenGLExtraFunctions *QOpenGLContext::extraFunctions() const

이 컨텍스트에 맞는 QOpenGLExtraFunctions 인스턴스를 가져옵니다.

QOpenGLContext 는 수동으로 관리할 필요 없이 QOpenGLExtraFunctions 에 액세스할 수 있는 편리한 방법으로 이를 제공합니다.

컨텍스트 또는 공유 컨텍스트는 최신 상태여야 합니다.

반환된 QOpenGLExtraFunctions 인스턴스는 사용할 준비가 되었으며 초기화OpenGLFunctions()를 호출할 필요가 없습니다.

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 인스턴스는 사용할 준비가 되었으며 초기화OpenGLFunctions()를 호출할 필요가 없습니다.

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

extension이 OpenGL 컨텍스트가 지정된 OpenGL을 지원하는 경우 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() 호출 한 번으로 대체할 수 있습니다.

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()를 다시 호출해야 합니다.