QQuickWindow::GraphicsStateInfo Struct
struct QQuickWindow::GraphicsStateInfoDescribe algunos de los estados gráficos de RHI en el momento de una llamada a beginExternalCommands(). Más información...
Variables públicas
| int | currentFrameSlot |
| int | framesInFlight |
Documentación de las variables miembro
int GraphicsStateInfo::currentFrameSlot
Esta variable contiene el índice actual de la ranura de fotograma durante la grabación de un fotograma.
Cuando el grafo de escena se renderiza con API 3D de bajo nivel, como Vulkan o Metal, es responsabilidad de Qt garantizar el bloqueo cada vez que se inicia un nuevo fotograma y se detecta que la CPU ya lleva una cierta cantidad de fotogramas de ventaja sobre la GPU (debido a que el búfer de comandos enviado en el fotograma n.º current - FramesInFlight aún no se ha completado). Con otras API gráficas, como OpenGL o Direct 3D 11, este nivel de control no se expone al cliente de la API, sino que lo gestiona la implementación de la propia API gráfica.
Por extensión, esto también significa que la gestión del almacenamiento en búfer doble (o triple) adecuado de los recursos, como los búferes, recae en el cliente de la API gráfica. Lo más habitual es que un búfer uniforme, en el que los datos cambian entre fotogramas, no pueda cambiar simplemente su contenido al enviar un fotograma, dado que este puede seguir activo («en vuelo») al comenzar a grabar el siguiente fotograma. Para evitar el bloqueo del proceso, una solución consiste en disponer de múltiples búferes (y asignaciones de memoria) en segundo plano, logrando así al menos un esquema de doble búfer para dichos recursos.
Las aplicaciones que integran el renderizado realizado directamente con una API gráfica como Vulkan pueden querer llevar a cabo un doble o triple almacenamiento en búfer similar de sus propios recursos gráficos, de forma que sea compatible con el proceso de envío de fotogramas del motor de renderizado de Qt. Esto implica conocer los valores del número máximo de fotogramas en proceso (que suele ser 2 o 3) y el índice actual de la ranura de fotogramas, que es un número que va de 0, 1, …, FramesInFlight-1, y luego vuelve a empezar. El primero se expone en la variable ` framesInFlight `. El segundo, el índice actual, es este valor.
Para ver un ejemplo del uso práctico de estos valores, consulta los ejemplos {Scene Graph - Vulkan Under QML} y {Scene Graph - Vulkan Texture Import}.
int GraphicsStateInfo::framesInFlight
Esta variable contiene el número máximo de fotogramas que se mantienen en vuelo.
Consulte currentFrameSlot para obtener una descripción detallada.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.