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 에서 지정해야 합니다. 스레드 상황에서 실수를 방지하기 위해 QWindow 와 마찬가지로 QSurface 서브클래스의 인스턴스는 종종 gui/메인 스레드에서만 생성될 수 있으므로 QRhi 에 의해 자동으로 생성되지 않습니다.

편의를 위해 애플리케이션은 newFallbackSurface()를 사용하여 나중에 QRhi 에 의해 생성될 QOpenGLContext 과 호환되는 QOffscreenSurface 을 생성하고 반환할 수 있습니다. 반환된 QOffscreenSurface 의 소유권은 호출자에게 이전되며 QRhi 은 이를 파괴하지 않습니다.

기존 QOpenGLContext 과 리소스 공유가 필요한 경우 shareContext 을 기존 QOpenGLContext 으로 설정할 수 있습니다. 또는 Qt::AA_ShareOpenGLContexts 도 활성화된 경우 그대로 사용할 수 있습니다.

기존 OpenGL 컨텍스트로 작업하기

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

QOpenGLContext 다른 접근 방식은 다른 엔진의 컨텍스트를 사용하여 shares resources 을 만들고 QRhiGles2NativeHandles 을 통해 해당 컨텍스트를 전달하는 것입니다.

QRhi 은 QRhiGles2NativeHandles 을 통해 전달된 QOpenGLContext 의 소유권을 갖지 않습니다.