En esta página

Shader Tools Descripción general de Qt XML-ph-0000@deepl.internal

El módulo Qt « Shader Tools » se basa en el ecosistema de código abierto SPIR-V, tal y como se describe en la página web de Khronos dedicada a SPIR-V. Para la compilación en SPIR-V se utiliza glslang, mientras que la traducción y la reflexión se realizan mediante SPIRV-Cross.

Para que el código de los shaders se escriba una sola vez en las aplicaciones y bibliotecas de Qt, se espera que todos los shaders se escriban en un único lenguaje, que luego se compila a SPIR-V. Este lenguaje de sombreado es, por el momento, GLSL compatible con Vulkan. Esto difiere de lo que espera el GLSL de estilo OpenGL de Qt 5.x. Consulte la especificación GL_KHR_vulkan_gls para obtener una visión general de las diferencias.

A continuación, el código fuente para otros lenguajes de sombreado, como GLSL, HLSL y el Metal Shading Language, se genera a partir de la traducción del código de bytes SPIR-V, junto con la información de reflexión (entradas, salidas y recursos de sombreador). En el caso concreto de GLSL, esto también implica generar múltiples variantes, es decir, código fuente adecuado para diferentes versiones de GLSL, como GLSL ES 100, GLSL ES 300, y GLSL 120 y 150. A continuación, este se empaqueta en objetos contenedores serializables de tipo « QShader », que suelen almacenarse en disco como archivos « .qsb ». La interfaz de hardware de renderizado de Qt utiliza directamente instancias de « QShader », seleccionando el código fuente o el bytecode del shader que mejor se adapta a la API gráfica utilizada en tiempo de ejecución. Un objeto « QShader » suele deserializarse a partir de archivos « .qsb » incluidos con la aplicación o con el propio Qt en el Sistema de Recursos de Qt.

Algunas plataformas ofrecen la opción de compilar el código fuente del shader a un formato intermedio similar a SPIR-V. Esto implica ejecutar herramientas específicas de la plataforma. Con Direct 3D, la herramienta qsb ofrece la opción de invocar la herramienta fxc del SDK de Windows una vez generado el código fuente HLSL. A continuación, sustituye el código fuente HLSL por el binario « DXBC » generado por fxc. Esto puede tener un efecto positivo en el rendimiento en tiempo de ejecución de las aplicaciones, ya que estas ya no tienen que realizar por sí mismas la primera fase de la compilación (de código fuente HLSL a DXBC). Para macOS e iOS, el SDK de XCode proporciona herramientas similares. La desventaja de este enfoque es que estas herramientas solo pueden ejecutarse en sus respectivas plataformas. Por lo tanto, resulta más adecuado utilizarlo en combinación con la integración de CMake de qsb, ya que realizar el acondicionamiento de shaders en el momento de la compilación de la aplicación implica, de forma implícita, conocer la plataforma de destino y saber qué herramientas específicas de dicha plataforma pueden invocarse.

El siguiente diagrama describe los pasos que tienen lugar durante la ejecución de la herramienta « qsb »:

Diagrama de flujo del proceso de preparación de shaders, desde el código fuente GLSL de Vulkan hasta el archivo QShader empaquetado, en el que se muestran la compilación, la traducción y los pasos opcionales

Los componentes principales del sistema de acondicionamiento de sombreadores de Qt son:

  • la herramienta de línea de comandos « qsb »
  • la integración con CMake de la herramienta ` qsb `
  • QShader (parte del módulo « QtGui »)
  • QShaderBaker (parte de este módulo, el equivalente en forma de biblioteca de la herramienta qsb )

Uso habitual con Qt Quick

Los desarrolladores de aplicaciones suelen trabajar con código de shader personalizado en escenas de Qt Quick que contienen uno de los siguientes elementos:

  • ShaderEffect elementos
  • QQuickItem subclases que utilizan nodos del grafo de escena en combinación con materiales personalizados creados mediante la subclasificación de QSGMaterial.

Por ejemplo, consideremos el siguiente fragmento de código QML:

ShaderEffect {
    width: 100; height: 100
    fragmentShader: "myeffect.frag.qsb"
}

Aquí, la URL fragmentShader hace referencia a un archivo .qsb relativo a la ubicación del archivo .qml. Se espera que la aplicación incluya el archivo myeffect.frag.qsb junto al archivo .qml. Para generar ese archivo a partir del código fuente GLSL al estilo Vulkan (que en sí mismo no tiene por qué incluirse con la aplicación), la aplicación debe utilizar la herramienta qsb, ya sea directamente o a través de CMake.

Uso habitual con Qt Quick 3D

Qt Quick 3D utiliza directamente el módulo « Shader Tools » para realizar el acondicionamiento de los shaders en tiempo de ejecución. Además, ofrece soluciones para la pregeneración de shaders para materiales en fase de compilación, en caso de que no se considere ideal una dependencia en tiempo de ejecución de compiladores de shaders y otras herramientas. En cualquier caso, los desarrolladores no necesitan trabajar directamente con la herramienta qsb, ya que está encapsulada por el propio marco y las herramientas de Qt Quick 3D.

© 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.