QRhiGles2InitParams Struct

Descripción detallada

Un QRhi basado en OpenGL necesita un QSurface ya creado que pueda utilizarse en combinación con QOpenGLContext. En la práctica, lo más habitual es que se trate de QOffscreenSurface. Además, aunque es opcional, se recomienda pasar también el QWindow al que se dirigirá el primer QRhiSwapChain.

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

Por defecto, QRhi crea un QOpenGLContext por sí solo. Este enfoque funciona bien en la mayoría de los casos, incluidos los escenarios con subprocesos, donde hay un QRhi dedicado para cada subproceso de renderizado. Como habrá un QOpenGLContext para cada QRhi, se satisfacen los requisitos de contexto de OpenGL (un contexto sólo puede ser actual en un hilo). El contexto creado implícitamente se destruye automáticamente junto con QRhi.

El QSurfaceFormat para el contexto se especifica en format. El constructor lo establece en QSurfaceFormat::defaultFormat() para que las aplicaciones que llamen a QSurfaceFormat::setDefaultFormat() con la configuración adecuada antes de que se ejecute el constructor no necesiten cambiar el valor de format.

Un QSurface tiene que ser especificado en fallbackSurface. Para prevenir errores en situaciones de hilos, este nunca es creado automáticamente por el QRhi porque, como QWindow, las instancias de QSurface subclases pueden a menudo ser creadas en el hilo gui/main solamente.

Por conveniencia, las aplicaciones pueden usar newFallbackSurface() que crea y devuelve un QOffscreenSurface que es compatible con el QOpenGLContext que va a ser creado por el QRhi después. Tenga en cuenta que la propiedad del QOffscreenSurface devuelto se transfiere a la persona que llama y el QRhi no lo destruirá.

En caso de que se desee compartir recursos con un QOpenGLContext existente, se puede establecer shareContext a un QOpenGLContext existente. Alternativamente, Qt::AA_ShareOpenGLContexts también es respetado, cuando está habilitado.

Trabajar con contextos OpenGL existentes

Al interoperar con otro motor gráfico, puede ser necesario obtener una instancia de QRhi que utilice el mismo contexto OpenGL. Esto se puede conseguir pasando un puntero a QRhiGles2NativeHandles a QRhi::create(). En este caso, QRhiGles2NativeHandles::context debe tener un valor no nulo.

Un enfoque alternativo es crear un QOpenGLContext que shares resources con el contexto del otro motor y pasar ese contexto a través de QRhiGles2NativeHandles.

El QRhi no se apropia del QOpenGLContext pasado a través de QRhiGles2NativeHandles.