En esta página

QShaderVersion Class

Especifica la versión del lenguaje de sombreado. Más...

Encabezado: #include <qshader.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.6

Tipos públicos

enum Flag { GlslEs }
flags Flags

Funciones públicas

QShaderVersion()
QShaderVersion(int v, QShaderVersion::Flags f = Flags())
QShaderVersion::Flags flags() const
void setFlags(QShaderVersion::Flags f)
void setVersion(int v)
int version() const
(since 6.12) size_t qHash(QShaderVersion key, size_t seed)
bool operator!=(const QShaderVersion &lhs, const QShaderVersion &rhs)
bool operator<(const QShaderVersion &lhs, const QShaderVersion &rhs)
bool operator==(const QShaderVersion &lhs, const QShaderVersion &rhs)

Descripción detallada

Mientras que lenguajes como SPIR-V o Metal Shading Language utilizan números de versión tradicionales, los shaders para otras API pueden emplear esquemas de versionado ligeramente diferentes. No obstante, todos ellos se asignan aquí a un único número de versión. En el caso de HLSL, la versión hace referencia a la versión del modelo de sombreador, como 5.0, 5.1 o 6.0. Para GLSL se necesita un indicador adicional para elegir entre GLSL y GLSL/ES.

A continuación se muestra una lista con los ejemplos más comunes de versiones de shaders para diferentes API gráficas:

  • Vulkan (SPIR-V): 100
  • OpenGL: 120, 330, 440, etc.
  • OpenGL ES: 100 con GlslEs, 300 con GlslEs, etc.
  • Direct3D: 50, 51, 60
  • Metal: 12, 20

Un objeto QShaderVersion creado por defecto contiene una versión de 100 y ningún indicador activado.

Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QShader para obtener más detalles.

Documentación sobre los tipos de miembros

enum QShaderVersion::Flag
flags QShaderVersion::Flags

Describe los indicadores que se pueden activar.

ConstanteValorDescripción
QShaderVersion::GlslEs0x01Indica que GLSL/ES se utiliza en combinación con GlslShader

El tipo Flags es un typedef de QFlags<Flag>. Almacena una combinación OR de valores de Flag.

Documentación de las funciones miembro

[constexpr noexcept default] QShaderVersion::QShaderVersion()

QShaderVersion::QShaderVersion(int v, QShaderVersion::Flags f = Flags())

Crea una nueva instancia de `QShaderVersion` con la versión ` v ` y los indicadores ` f`.

QShaderVersion::Flags QShaderVersion::flags() const

Devuelve los indicadores.

Véase también setFlags().

void QShaderVersion::setFlags(QShaderVersion::Flags f)

Establece los indicadores « f ».

Véase también flags().

void QShaderVersion::setVersion(int v)

Establece la versión del lenguaje de sombreado en v.

Véase también version().

int QShaderVersion::version() const

Devuelve la versión.

Véase también setVersion().

Elementos no miembros relacionados

[noexcept, since 6.12] size_t qHash(QShaderVersion key, size_t seed)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

Nota: En INTEGRITY, esta función está disponible desde la versión 6.2.

Esta función se introdujo en Qt 6.12.

[noexcept] bool operator!=(const QShaderVersion &lhs, const QShaderVersion &rhs)

Devuelve « false » si los valores de los dos objetos « QShaderVersion » — lhs y rhs — son iguales; en caso contrario, devuelve « true ».

[noexcept] bool operator<(const QShaderVersion &lhs, const QShaderVersion &rhs)

Devuelve «true» si lhs es menor que rhs.

Establece un orden de clasificación entre los dos: QShaderVersion, lhs y rhs.

[noexcept] bool operator==(const QShaderVersion &lhs, const QShaderVersion &rhs)

Devuelve « true » si los dos objetos « QShaderVersion » lhs y rhs son iguales.

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