QRhiShaderStage Class
Especifica el tipo y el código del shader para una etapa de shader en el proceso. Más información...
| Encabezado: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Desde: | Qt 6.6 |
Tipos públicos
| enum | Type { Vertex, TessellationControl, TessellationEvaluation, Fragment, Compute, Geometry } |
Funciones públicas
| QRhiShaderStage() | |
| QRhiShaderStage(QRhiShaderStage::Type type, const QShader &shader, QShader::Variant v = QShader::StandardShader) | |
| void | setShader(const QShader &s) |
| void | setShaderVariant(QShader::Variant v) |
| void | setType(QRhiShaderStage::Type t) |
| QShader | shader() const |
| QShader::Variant | shaderVariant() const |
| QRhiShaderStage::Type | type() const |
Elementos no miembros relacionados
| size_t | qHash(const QRhiShaderStage &key, size_t seed = 0) |
| bool | operator!=(const QRhiShaderStage &a, const QRhiShaderStage &b) |
| bool | operator==(const QRhiShaderStage &a, const QRhiShaderStage &b) |
Descripción detallada
Al configurar un « QRhiGraphicsPipeline », se especifica un conjunto de etapas de sombreado. El objeto `QRhiShaderStage` contiene un ` QShader ` y algunos metadatos asociados, como la etapa del canal de procesamiento gráfico y el ` shader variant ` que se va a seleccionar. No es necesario especificar el lenguaje ni la versión del sombreador, ya que el backend ` QRhi ` utilizado en tiempo de ejecución se encargará de elegir la versión adecuada del sombreador de entre la colección contenida en el ` QShader`.
El uso habitual es en combinación con QRhiGraphicsPipeline::setShaderStages(), que se muestra aquí con un enfoque sencillo para cargar el QShader a partir de archivos .qsb generados sin conexión o en el momento de la compilación:
QShader getShader(const QString &name)
{
QFile f(name);
return f.open(QIODevice::ReadOnly) ? QShader::fromSerialized(f.readAll()) : QShader();
}
QShader vs = getShader("material.vert.qsb");
QShader fs = getShader("material.frag.qsb");
pipeline->setShaderStages({
{ QRhiShaderStage::Vertex, vs },
{ QRhiShaderStage::Fragment, fs }
});Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.
Documentación sobre los tipos de miembros
enum QRhiShaderStage::Type
Especifica el tipo de etapa del shader.
| Constante | Valor | Descripción |
|---|---|---|
QRhiShaderStage::Vertex | 0 | Etapa de vértices |
QRhiShaderStage::TessellationControl | 1 | Etapa de control de teselación (sombreador de casco). Solo debe utilizarse cuando se admita la función « QRhi::Tessellation ». |
QRhiShaderStage::TessellationEvaluation | 2 | Etapa de evaluación de la teselación (sombreador de dominio). Solo debe utilizarse cuando se admita la función « QRhi::Tessellation ». |
QRhiShaderStage::Fragment | 4 | Etapa de fragmentos (sombreador de píxeles) |
QRhiShaderStage::Compute | 5 | Etapa de cálculo. Solo debe utilizarse cuando se admita la función « QRhi::Compute ». |
QRhiShaderStage::Geometry | 3 | Etapa de geometría. Debe utilizarse únicamente cuando se admita la función « QRhi::GeometryShader ». |
Documentación de las funciones miembro
[noexcept default] QRhiShaderStage::QRhiShaderStage()
Crea una descripción de la etapa de sombreado para la etapa de vértices con un ` QShader` vacío.
QRhiShaderStage::QRhiShaderStage(QRhiShaderStage::Type type, const QShader &shader, QShader::Variant v = QShader::StandardShader)
Crea una descripción de la etapa de sombreado con el « type » de la etapa y el « shader ».
La variante del sombreador « v » toma por defecto el valor « QShader::StandardShader ». Un « QShader » contiene varias versiones fuente y binarias de un sombreador. Además, también puede contener variantes del sombreador con código ligeramente modificado. A continuación, se puede utilizar « v » para seleccionar la variante deseada.
void QRhiShaderStage::setShader(const QShader &s)
Establece la colección de shaders s.
Véase también shader().
void QRhiShaderStage::setShaderVariant(QShader::Variant v)
Establece la variante de shader solicitada v.
Véase también shaderVariant().
void QRhiShaderStage::setType(QRhiShaderStage::Type t)
Establece el tipo de la etapa en « t ». En la práctica, rara vez se necesitarán métodos de configuración. Es probable que la mayoría de las aplicaciones utilicen el constructor « QRhiShaderStage » en la mayoría de los casos.
Véase también type().
QShader QRhiShaderStage::shader() const
Devuelve el objeto « QShader » que se utilizará en esta etapa del proceso de renderizado.
Véase también setShader().
QShader::Variant QRhiShaderStage::shaderVariant() const
Devuelve la variante de shader solicitada.
Véase también setShaderVariant().
QRhiShaderStage::Type QRhiShaderStage::type() const
Devuelve el tipo de la etapa.
Véase también setType().
Elementos no miembros relacionados
[noexcept] size_t qHash(const QRhiShaderStage &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] bool operator!=(const QRhiShaderStage &a, const QRhiShaderStage &b)
Devuelve ` false ` si los valores de los dos objetos ` QRhiShaderStage ` — a y b — son iguales; en caso contrario, devuelve ` true`.
[noexcept] bool operator==(const QRhiShaderStage &a, const QRhiShaderStage &b)
Devuelve « true » si los valores de los dos objetos « QRhiShaderStage » — a y b — 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.