Almacenamiento en caché persistente de shaders con 3D de Qt Quick
Shaders y materiales 3D
El renderizado de un objeto 3D con un material implica el uso de un sombreador de vértices y un sombreador de fragmentos.
Esto es lo que ocurre en tiempo de ejecución cuando se encuentra un material por primera vez durante la vida útil de una escena 3D:
- Se generan los textos fuente de los sombreadores.
- Los shaders se envían a través del canal de procesamiento de shaders estándar de Qt. El resultado es una versión intermedia en bytecode del shader (SPIR-V), varias variantes de código fuente para otras API 3D (GLSL para OpenGL, HLSL para Direct3D, etc.) y metadatos adicionales.
- Cuando el motor 3D crea un « graphics pipeline », se elige una variante de código byte o de código fuente adecuada para la API 3D utilizada y, a continuación, es probable que la API 3D subyacente realice una compilación de segunda fase dirigida al conjunto de instrucciones real de la GPU.
Todo esto en conjunto puede suponer una operación costosa. Para evitarlo en ejecuciones posteriores de la aplicación, se emplean dos cachés persistentes almacenadas en disco.
Caché de bajo nivel
Qt Quick El 3D se basa en Qt Quick y en el grafo de escena. A la hora de almacenar en caché de forma persistente y en disco los binarios de programas OpenGL, los flujos de trabajo de Vulkan, etc., se utiliza la misma infraestructura.
Consulte QQuickGraphicsConfiguration#Pipeline Cache Save and Load para obtener una explicación detallada al respecto.
De forma predeterminada, la caché de shaders en disco está habilitada. Esto significa que, incluso cuando la plataforma o la implementación de la API 3D no realice su propio almacenamiento en caché persistente de los shaders compilados, Qt puede seguir almacenando los binarios de programas OpenGL o recursos similares que se recopilan durante el ciclo de vida de un QQuickWindow. Los datos se escriben en el disco al cerrar la ventana y se vuelven a cargar la próxima vez que se ejecute la aplicación. De este modo, la creación de tuberías gráficas puede ser significativamente más rápida cuando los sombreadores ya se han encontrado en ejecuciones anteriores de la aplicación.
Los shaders de los materiales 3D y los efectos de posprocesamiento también participan en este proceso.
Caché de sombreadores de materiales
A diferencia de Qt Quick, Qt Quick 3D se basa actualmente en la generación en tiempo de ejecución de los textos fuente de los shaders para materiales y efectos 3D. La excepción a esto es cuando se utiliza la herramienta Shadergen; sin embargo, esa característica es experimental y no se recomienda su uso en producción por el momento.
Generar los textos fuente de los shaders y, a continuación, llevar a cabo la compilación y la transpilación de primera fase (véase Qt Shader Tools para más detalles) puede ser una operación costosa. En el caso de los materiales y efectos 2D, esto suele ocurrir en tiempo de compilación, mientras que para 3D esa opción no está disponible actualmente.
Por lo tanto, Qt Quick 3D emplea otra caché basada en disco. Esta almacena los recursos de los materiales y efectos 3D generados.
Esto significa que, en combinación con la caché de bajo nivel, una escena 3D con un material que ya se haya encontrado durante ejecuciones anteriores de la aplicación no dará lugar a una operación costosa y bloqueante cuando se vuelva a encontrar en ejecuciones posteriores.
Nota: Al igual que con la caché de bajo nivel para shaders y pipelines, esto requiere un sistema de archivos en el que se pueda escribir y que la plataforma proporcione una ubicación de caché en la que se pueda escribir mediante QStandardPaths.
El atributo de aplicación ` Qt::AA_DisableShaderDiskCache ` y la variable de entorno correspondiente también se aplican a la caché de shaders de materiales. Cuando se activa, se desactivarán tanto la caché de materiales de bajo nivel de Qt como la de Qt Quick 3D.
Nota: La herramienta qml configura este atributo de forma predeterminada. Pasa el argumento de línea de comandos --enable-shader-cache para obtener un comportamiento idéntico al de las aplicaciones Qt independientes.
Activa la categoría de registro « qt.quick3d.cache » para que se muestre información sobre la caché de materiales 3D en tiempo de ejecución.
© 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.