QRhiGles2InitParams Struct

상세 설명

OpenGL 기반의 QRhi 는 QOpenGLContext 와 함께 사용할 수 있도록 미리 생성된 QSurface 가 필요합니다. 실제로는 대부분 QOffscreenSurface 를 사용합니다. 또한, 선택 사항이지만 첫 번째 QRhiSwapChain 가 목표로 할 QWindow 도 함께 전달하는 것이 좋습니다.

QOffscreenSurface *fallbackSurface = QRhiGles2InitParams::newFallbackSurface();
QRhiGles2InitParams params;
params.fallbackSurface = fallbackSurface;
params.window = window;
rhi = QRhi::create(QRhi::OpenGLES2, &params);

기본적으로 QRhi 는 자체적으로 QOpenGLContext 를 생성합니다. 이 방식은 각 렌더링 스레드마다 전용 QRhi 가 있는 스레드 기반 시나리오를 포함하여 대부분의 경우에서 잘 작동합니다. 각 QRhi 마다 QOpenGLContext 가 하나씩 존재하므로, OpenGL 컨텍스트 요구 사항(컨텍스트는 하나의 스레드에서만 현재 컨텍스트로 설정될 수 있음)이 충족됩니다. 암시적으로 생성된 컨텍스트는 QRhi 와 함께 자동으로 소멸됩니다.

컨텍스트의 QSurfaceFormat 는 format 에서 지정됩니다. 생성자는 이 값을 QSurfaceFormat::defaultFormat()로 설정하므로, 생성자가 실행되기 전에 적절한 설정으로 QSurfaceFormat::setDefaultFormat()를 호출하는 애플리케이션은 format 의 값을 변경할 필요가 없습니다.

QSurface 는 fallbackSurface 에서 반드시 지정되어야 합니다. 스레드 환경에서 오류를 방지하기 위해, QRhi 에서는 이 객체가 절대 자동으로 생성되지 않습니다. QWindow 와 마찬가지로, QSurface 의 하위 클래스 인스턴스는 대개 GUI/메인 스레드에서만 생성될 수 있기 때문입니다.

편의상, 애플리케이션은 newFallbackSurface()를 사용할 수 있습니다. 이 함수는 이후 QRhi 에 의해 생성될 QOpenGLContext 와 호환되는 QOffscreenSurface 를 생성하여 반환합니다. 반환된 QOffscreenSurface 의 소유권은 호출자에게 이전되며, QRhi 는 이를 파괴하지 않는다는 점에 유의하십시오.

기존 QOpenGLContext 와 리소스를 공유하고자 하는 경우, shareContext 를 기존 QOpenGLContext 로 설정할 수 있습니다. 또는, 활성화된 상태에서는 Qt::AA_ShareOpenGLContexts 도 허용됩니다.

기존 OpenGL 컨텍스트와 연동하기

다른 그래픽 엔진과 상호 운용할 때, 동일한 OpenGL 컨텍스트를 사용하는 QRhi 인스턴스를 가져와야 할 수 있습니다. 이는 QRhiGles2NativeHandles 에 대한 포인터를 QRhi::create()에 전달함으로써 달성할 수 있습니다. 이때 QRhiGles2NativeHandles::context 는 null이 아닌 값으로 설정되어야 합니다.

다른 방법으로는, 다른 엔진의 컨텍스트와 shares resources 를 수행한 QOpenGLContext 를 생성한 후, QRhiGles2NativeHandles()를 통해 해당 컨텍스트를 전달하는 것입니다.

QRhi 는 QRhiGles2NativeHandles 를 통해 전달된 QOpenGLContext 의 소유권을 인수하지 않습니다.