En esta página

QRhiGraphicsPipeline Class

Recurso de estado del canal de procesamiento gráfico. Más...

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
Heredado de: QRhiResource

Tipos públicos

(since 6.6) struct StencilOpState
(since 6.6) struct TargetBlend
enum BlendFactor { Zero, One, SrcColor, OneMinusSrcColor, DstColor, …, OneMinusSrc1Alpha }
enum BlendOp { Add, Subtract, ReverseSubtract, Min, Max }
flags ColorMask
enum ColorMaskComponent { R, G, B, A }
enum CompareOp { Never, Less, Equal, LessOrEqual, Greater, …, Always }
enum CullMode { None, Front, Back }
enum Flag { UsesBlendConstants, UsesStencilRef, UsesScissor, CompileShadersWithDebugInfo, UsesShadingRate, UsesIndirectDraws }
flags Flags
enum FrontFace { CCW, CW }
enum PolygonMode { Fill, Line }
enum StencilOp { StencilZero, Keep, Replace, IncrementAndClamp, DecrementAndClamp, …, DecrementAndWrap }
enum Topology { Triangles, TriangleStrip, TriangleFan, Lines, LineStrip, …, Patches }

Funciones públicas

const QRhiShaderStage *cbeginShaderStages() const
const QRhiGraphicsPipeline::TargetBlend *cbeginTargetBlends() const
const QRhiShaderStage *cendShaderStages() const
const QRhiGraphicsPipeline::TargetBlend *cendTargetBlends() const
virtual bool create() = 0
QRhiGraphicsPipeline::CullMode cullMode() const
int depthBias() const
QRhiGraphicsPipeline::CompareOp depthOp() const
QRhiGraphicsPipeline::Flags flags() const
QRhiGraphicsPipeline::FrontFace frontFace() const
(since 6.11) bool hasDepthClamp() const
bool hasDepthTest() const
bool hasDepthWrite() const
bool hasStencilTest() const
float lineWidth() const
(since 6.7) int multiViewCount() const
int patchControlPointCount() const
QRhiGraphicsPipeline::PolygonMode polygonMode() const
QRhiRenderPassDescriptor *renderPassDescriptor() const
int sampleCount() const
void setCullMode(QRhiGraphicsPipeline::CullMode mode)
void setDepthBias(int bias)
(since 6.11) void setDepthClamp(bool enable)
void setDepthOp(QRhiGraphicsPipeline::CompareOp op)
void setDepthTest(bool enable)
void setDepthWrite(bool enable)
void setFlags(QRhiGraphicsPipeline::Flags f)
void setFrontFace(QRhiGraphicsPipeline::FrontFace f)
void setLineWidth(float width)
(since 6.7) void setMultiViewCount(int count)
void setPatchControlPointCount(int count)
void setPolygonMode(QRhiGraphicsPipeline::PolygonMode mode)
void setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
void setSampleCount(int s)
void setShaderResourceBindings(QRhiShaderResourceBindings *srb)
void setShaderStages(std::initializer_list<QRhiShaderStage> list)
void setShaderStages(InputIterator first, InputIterator last)
void setSlopeScaledDepthBias(float bias)
void setStencilBack(const QRhiGraphicsPipeline::StencilOpState &state)
void setStencilFront(const QRhiGraphicsPipeline::StencilOpState &state)
void setStencilReadMask(quint32 mask)
void setStencilTest(bool enable)
void setStencilWriteMask(quint32 mask)
void setTargetBlends(std::initializer_list<QRhiGraphicsPipeline::TargetBlend> list)
void setTargetBlends(InputIterator first, InputIterator last)
void setTopology(QRhiGraphicsPipeline::Topology t)
void setVertexInputLayout(const QRhiVertexInputLayout &layout)
QRhiShaderResourceBindings *shaderResourceBindings() const
const QRhiShaderStage *shaderStageAt(qsizetype index) const
qsizetype shaderStageCount() const
float slopeScaledDepthBias() const
QRhiGraphicsPipeline::StencilOpState stencilBack() const
QRhiGraphicsPipeline::StencilOpState stencilFront() const
quint32 stencilReadMask() const
quint32 stencilWriteMask() const
const QRhiGraphicsPipeline::TargetBlend *targetBlendAt(qsizetype index) const
qsizetype targetBlendCount() const
QRhiGraphicsPipeline::Topology topology() const
QRhiVertexInputLayout vertexInputLayout() const

Funciones públicas reimplementadas

virtual QRhiResource::Type resourceType() const override

Descripción detallada

Representa un canal de procesamiento gráfico. Lo que esto se traduce exactamente en la API gráfica nativa subyacente varía. Cuando existe el concepto de objetos de canal, por ejemplo en Vulkan, el backend « QRhi » creará dicho objeto al llamar a ` create()`. En otros casos, como por ejemplo con OpenGL, es posible que QRhiGraphicsPipeline se limite a recopilar los distintos estados, y que la tarea principal de create() sea configurar el programa de sombreado correspondiente, posponiendo el análisis de cualquiera de los estados solicitados para un momento posterior.

Al igual que con todas las subclases de ` QRhiResource `, se aplica el patrón de inicialización en dos fases: el establecimiento de cualquier valor mediante los setters, por ejemplo ` setDepthTest()`, solo surte efecto tras llamar a ` create()`. Evita modificar cualquier valor una vez que el `QRhiGraphicsPipeline` se haya inicializado mediante ` create()`. Para cambiar algún estado, establece el nuevo valor y vuelve a llamar a ` create()`. Sin embargo, esto liberará efectivamente todos los recursos nativos subyacentes y creará otros nuevos. Como resultado, puede ser una operación pesada y costosa. Es preferible crear varias tuberías con diferentes estados y utilizar ` switch between them ` al grabar la pasada de renderizado.

Nota: Es obligatorioconfigurar las etapas del shader. Debe haber al menos una etapa y debe haber una etapa de vértices.

Nota: Es obligatorioconfigurar los enlaces de recursos del shader. El objeto ` QRhiShaderResourceBindings ` al que se hace referencia debe haber sido objeto de la llamada ` create()` en el momento en que se invoque a ` create()`. También es válido asociarlo a un objeto ` QRhiShaderResourceBindings ` que no tenga enlaces, siempre y cuando ningún shader de ninguna etapa espere ningún recurso. El uso de un objeto ` QRhiShaderResourceBindings ` que no especifique ningún recurso real (es decir, los búferes, texturas, etc. de los puntos de enlace estén establecidos en ` nullptr`) también es válido, siempre y cuando se vaya a establecer un ` layout-compatible ` ` QRhiShaderResourceBindings`, que especifique recursos para todos los enlaces, mediante ` setShaderResources()` al grabar la pasada de renderizado.

Nota: Es obligatorioconfigurar el descriptor de la pasada de renderizado. Para obtener un QRhiRenderPassDescriptor que se pueda pasar a setRenderPassDescriptor(), utiliza QRhiTextureRenderTarget::newCompatibleRenderPassDescriptor() o QRhiSwapChain::newCompatibleRenderPassDescriptor().

Nota: Es obligatorioconfigurar la disposición de entrada de vértices.

Nota: El valor predeterminado de` sampleCount()` es 1 y debe coincidir con el número de muestras de los anexos de color y de estarcido de profundidad del destino de renderizado.

Nota: La prueba de profundidad, la escritura de profundidad y la prueba de estarcido están desactivadas por defecto. El modo de culling de caras tiene como valor predeterminado «sin culling».

Nota: « stencilReadMask» () y « stencilWriteMask » () se aplican a ambas caras. Ambos tienen un valor predeterminado de 0xFF.

Ejemplo de uso

Todos los ajustes de un canal gráfico tienen valores predeterminados que pueden resultar adecuados para muchas aplicaciones. Por lo tanto, un ejemplo mínimo de creación de un canal gráfico podría ser el siguiente. Se supone que el sombreador de vértices toma una única entrada de « vec3 position » en la ubicación de entrada 0. Con los objetos « QRhiShaderResourceBindings » y « QRhiRenderPassDescriptor », además de las colecciones « QShader » para las etapas de vértices y fragmentos, se podría crear un canal de la siguiente manera:

QRhiShaderResourceBindings *srb;
QRhiRenderPassDescriptor *rpDesc;
QShader vs, fs;
// ...

QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({ { 3 * sizeof(float) } });
inputLayout.setAttributes({ { 0, 0, QRhiVertexInputAttribute::Float3, 0 } });

QRhiGraphicsPipeline *ps = rhi->newGraphicsPipeline();
ps->setShaderStages({ { QRhiShaderStage::Vertex, vs }, { QRhiShaderStage::Fragment, fs } });
ps->setVertexInputLayout(inputLayout);
ps->setShaderResourceBindings(srb);
ps->setRenderPassDescriptor(rpDesc);
if (!ps->create()) { error(); }

El código anterior crea un objeto de pipeline que utiliza los valores predeterminados para muchos ajustes y estados. Por ejemplo, utilizará una topología Triangles, no se aplicará el culling de caras ocultas, la mezcla estará desactivada pero la escritura de color estará activada para los cuatro canales, la prueba y la escritura de profundidad estarán desactivadas, y las operaciones de estarcido estarán desactivadas.

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

Véase también QRhiCommandBuffer y QRhi.

Documentación sobre tipos de miembros

enum QRhiGraphicsPipeline::BlendFactor

Especifica el factor de mezcla

ConstanteValor
QRhiGraphicsPipeline::Zero0
QRhiGraphicsPipeline::One1
QRhiGraphicsPipeline::SrcColor2
QRhiGraphicsPipeline::OneMinusSrcColor3
QRhiGraphicsPipeline::DstColor4
QRhiGraphicsPipeline::OneMinusDstColor5
QRhiGraphicsPipeline::SrcAlpha6
QRhiGraphicsPipeline::OneMinusSrcAlpha7
QRhiGraphicsPipeline::DstAlpha8
QRhiGraphicsPipeline::OneMinusDstAlpha9
QRhiGraphicsPipeline::ConstantColor10
QRhiGraphicsPipeline::OneMinusConstantColor11
QRhiGraphicsPipeline::ConstantAlpha12
QRhiGraphicsPipeline::OneMinusConstantAlpha13
QRhiGraphicsPipeline::SrcAlphaSaturate14
QRhiGraphicsPipeline::Src1Color15
QRhiGraphicsPipeline::OneMinusSrc1Color16
QRhiGraphicsPipeline::Src1Alpha17
QRhiGraphicsPipeline::OneMinusSrc1Alpha18

enum QRhiGraphicsPipeline::BlendOp

Especifica la operación de fusión

ConstanteValor
QRhiGraphicsPipeline::Add0
QRhiGraphicsPipeline::Subtract1
QRhiGraphicsPipeline::ReverseSubtract2
QRhiGraphicsPipeline::Min3
QRhiGraphicsPipeline::Max4

enum QRhiGraphicsPipeline::ColorMaskComponent
flags QRhiGraphicsPipeline::ColorMask

Valores de los indicadores para especificar la máscara de escritura de color

ConstanteValor
QRhiGraphicsPipeline::R1 << 0
QRhiGraphicsPipeline::G1 << 1
QRhiGraphicsPipeline::B1 << 2
QRhiGraphicsPipeline::A1 << 3

El tipo ColorMask es una definición de tipo (typedef) para QFlags<ColorMaskComponent>. Almacena una combinación OR de valores de ColorMaskComponent.

enum QRhiGraphicsPipeline::CompareOp

Especifica la función de comparación de profundidad o de plantilla

ConstanteValorDescripción
QRhiGraphicsPipeline::Never0 
QRhiGraphicsPipeline::Less1(valor por defecto para la profundidad)
QRhiGraphicsPipeline::Equal2 
QRhiGraphicsPipeline::LessOrEqual3 
QRhiGraphicsPipeline::Greater4 
QRhiGraphicsPipeline::NotEqual5 
QRhiGraphicsPipeline::GreaterOrEqual6 
QRhiGraphicsPipeline::Always7(valor predeterminado para la plantilla)

enum QRhiGraphicsPipeline::CullMode

Especifica el modo de culling

ConstanteValorDescripción
QRhiGraphicsPipeline::None0Sin culling (por defecto)
QRhiGraphicsPipeline::Front1Descartar caras frontales
QRhiGraphicsPipeline::Back2Eliminar caras traseras

enum QRhiGraphicsPipeline::Flag
flags QRhiGraphicsPipeline::Flags

Valores de los indicadores para describir el estado dinámico del proceso y otras opciones. La ventana gráfica es siempre dinámica.

ConstanteValorDescripción
QRhiGraphicsPipeline::UsesBlendConstants1 << 0Indica que se establecerá una constante de color de mezcla mediante QRhiCommandBuffer::setBlendConstants()
QRhiGraphicsPipeline::UsesStencilRef1 << 1Indica que se establecerá un valor de referencia de estarcido mediante QRhiCommandBuffer::setStencilRef()
QRhiGraphicsPipeline::UsesScissor1 << 2Indica que se establecerá un rectángulo de tijera mediante QRhiCommandBuffer::setScissor()
QRhiGraphicsPipeline::CompileShadersWithDebugInfo1 << 3Solicita la compilación de shaders con la información de depuración habilitada. Esto solo es relevante cuando se trata de la compilación de shaders en tiempo de ejecución a partir del código fuente, y solo cuando la infraestructura subyacente lo admite. Con ejemplos concretos, esto no es relevante con Vulkan y SPIR-V, ya que la compilación de GLSL a SPIR-V no se produce en tiempo de ejecución. Por otro lado, pensemos en Direct3D y HLSL, donde existen varias opciones: cuando los paquetes « QShader » se suministran con bytecode precompilado (DXBC), la información de depuración debe solicitarse a través de la herramienta que genera el archivo « .qsb », de forma similar al caso de Vulkan y SPIR-V. Sin embargo, cuando se dispone de código fuente HLSL en los paquetes QShader generados en fase previa o en tiempo de ejecución, la primera fase de la compilación (del código fuente HLSL al formato intermedio) también tiene lugar en tiempo de ejecución, teniendo en cuenta este indicador. La información de depuración es especialmente relevante con herramientas como RenderDoc, ya que permite ver el código fuente original al analizar el pipeline y al realizar la depuración de sombreadores de vértices o de fragmentos.
QRhiGraphicsPipeline::UsesShadingRate1 << 4Indica que se establecerá un valor de tasa de sombreado por dibujo (por pipeline) mediante QRhiCommandBuffer::setShadingRate(). No especificar este indicador y seguir llamando a setShadingRate() puede dar lugar a resultados variables e inesperados, dependiendo de la API gráfica subyacente.
QRhiGraphicsPipeline::UsesIndirectDraws (since Qt 6.12)1 << 5Indica que este pipeline se utilizará con llamadas de dibujo indirectas (QRhiCommandBuffer::drawIndirect() o QRhiCommandBuffer::drawIndexedIndirect()). Al establecer este indicador, se permite que el backend de Metal utilice búferes de comandos indirectos (ICB) para el renderizado impulsado por la GPU, lo que reduce significativamente la sobrecarga de la CPU en casos de gran número de dibujos. No establecer este indicador al utilizar dibujos indirectos sigue siendo funcional, pero puede dar lugar a un rendimiento menos óptimo en Metal. Este indicador no tiene ningún efecto en otros backends.

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

enum QRhiGraphicsPipeline::FrontFace

Especifica el orden de bobinado de la cara frontal

ConstanteValorDescripción
QRhiGraphicsPipeline::CCW0En sentido antihorario (por defecto)
QRhiGraphicsPipeline::CW1En el sentido de las agujas del reloj

enum QRhiGraphicsPipeline::PolygonMode

Especifica el modo de rasterización de polígonos

El modo de polígono (modo de relleno de triángulos en Metal, modo de relleno en D3D) especifica el modo de relleno utilizado al rasterizar polígonos. Los polígonos pueden dibujarse como sólidos (relleno) o como una malla de alambre (línea).

La compatibilidad con los modos de polígono sin relleno es opcional y se indica mediante la característica « QRhi::NonFillPolygonMode ». Con OpenGL ES y algunas implementaciones de Vulkan, es probable que esta característica se indique como no compatible, lo que significa que no se pueden utilizar valores distintos de «Fill».

ConstanteValorDescripción
QRhiGraphicsPipeline::Fill0El interior del polígono se rellena (por defecto)
QRhiGraphicsPipeline::Line1Los bordes del polígono se dibujan como segmentos de línea.

enum QRhiGraphicsPipeline::StencilOp

Especifica la operación de plantilla

ConstanteValorDescripción
QRhiGraphicsPipeline::StencilZero0 
QRhiGraphicsPipeline::Keep1(por defecto)
QRhiGraphicsPipeline::Replace2 
QRhiGraphicsPipeline::IncrementAndClamp3 
QRhiGraphicsPipeline::DecrementAndClamp4 
QRhiGraphicsPipeline::Invert5 
QRhiGraphicsPipeline::IncrementAndWrap6 
QRhiGraphicsPipeline::DecrementAndWrap7 

enum QRhiGraphicsPipeline::Topology

Especifica la topología primitiva

ConstanteValorDescripción
QRhiGraphicsPipeline::Triangles0(por defecto)
QRhiGraphicsPipeline::TriangleStrip1 
QRhiGraphicsPipeline::TriangleFan2(solo disponible si se admite « QRhi::TriangleFanTopology »)
QRhiGraphicsPipeline::Lines3 
QRhiGraphicsPipeline::LineStrip4 
QRhiGraphicsPipeline::Points5 
QRhiGraphicsPipeline::Patches6(solo disponible si se admite « QRhi::Tessellation », y requiere que las etapas de teselación estén presentes en el proceso)

Documentación de funciones de miembro

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

Devuelve un iterador const que apunta al primer elemento de la lista de etapas del shader.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cbeginTargetBlends() const

Devuelve un iterador constante que apunta al primer elemento de la lista de ajustes de mezcla del destino de renderizado.

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

Devuelve un iterador const que apunta justo después del último elemento de la lista de etapas del shader.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cendTargetBlends() const

Devuelve un iterador const que apunta justo después del último elemento de la lista de ajustes de mezcla del destino de renderizado.

[pure virtual] bool QRhiGraphicsPipeline::create()

Crea los recursos gráficos nativos correspondientes. Si ya existen recursos debido a una llamada previa a `create()` sin el correspondiente ` destroy()`, se llama primero de forma implícita a ` destroy()`.

Devuelve ` true ` si se realiza correctamente, y ` false ` si falla una operación gráfica. Independientemente del valor devuelto, llamar a ` destroy()` siempre es seguro.

Nota: Dependiendo de la API gráfica subyacente,esta puede ser una operación costosa, especialmente cuando los shaders se compilan u optimizan desde el código fuente o desde un formato de bytecode intermedio al propio conjunto de instrucciones de la GPU. Cuando procede, el backend QRhi configura automáticamente los mecanismos no persistentes pertinentes para acelerar este proceso; por ejemplo, el backend Vulkan crea automáticamente un VkPipelineCache para mejorar la reutilización de datos durante el tiempo de vida de la aplicación.

Nota: Los controladores también pueden emplear diversas estrategias de almacenamiento en caché persistente (basadas en disco) para los datos de los shaders y de la canalización, lo cual queda oculto y está fuera del control de Qt. En algunos casos, dependiendo de la API gráfica y del backend QRhi, existen mecanismos dentro de QRhi para gestionar manualmente dicha caché, lo que permite recuperar un blob serializable que luego puede volver a cargarse en futuras ejecuciones de la aplicación para garantizar tiempos de creación de la canalización más rápidos. Véase QRhi::pipelineCacheData() y QRhi::setPipelineCacheData() para más detalles. Tenga en cuenta también que, al trabajar con una instancia de QRhi gestionada por un marco Qt de nivel superior, como Qt Quick, es posible que dicho almacenamiento en caché basado en disco se gestione automáticamente; por ejemplo, QQuickWindow utiliza de forma predeterminada una caché de canalizaciones basada en disco (que se suma a cualquier almacenamiento en caché a nivel de controlador).

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Devuelve el modo de culling de caras actualmente establecido.

Véase también ` setCullMode()`.

int QRhiGraphicsPipeline::depthBias() const

Devuelve el sesgo de profundidad establecido actualmente.

Véase también setDepthBias().

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

Devuelve la función de comparación de profundidad.

Véase también setDepthOp().

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

Devuelve los indicadores establecidos actualmente.

Véase también setFlags().

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

Devuelve el modo de cara frontal establecido actualmente.

Véase también setFrontFace().

[since 6.11] bool QRhiGraphicsPipeline::hasDepthClamp() const

Devuelve «true» si está activada la limitación de profundidad.

Esta función se introdujo en Qt 6.11.

bool QRhiGraphicsPipeline::hasDepthTest() const

Devuelve «true» si la comprobación de profundidad está activada.

bool QRhiGraphicsPipeline::hasDepthWrite() const

Devuelve «true» si la escritura en profundidad está habilitada.

bool QRhiGraphicsPipeline::hasStencilTest() const

Devuelve «true» si la comprobación de plantilla está activada.

float QRhiGraphicsPipeline::lineWidth() const

Devuelve el ancho de línea establecido actualmente. El valor por defecto es 1,0f.

Véase también setLineWidth().

[since 6.7] int QRhiGraphicsPipeline::multiViewCount() const

Devuelve el recuento de vistas. El valor por defecto es 0, lo que indica que no se realiza un renderizado multivista.

Esta función se introdujo en Qt 6.7.

Véase también ` setMultiViewCount()`.

int QRhiGraphicsPipeline::patchControlPointCount() const

Devuelve el número de puntos de control de patch establecido actualmente.

Véase también setPatchControlPointCount().

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

Devuelve el modo de polígono.

Véase también setPolygonMode().

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

Devuelve el valor actualmente establecido de « QRhiRenderPassDescriptor ».

Véase también setRenderPassDescriptor().

[override virtual] QRhiResource::Type QRhiGraphicsPipeline::resourceType() const

Reimplementa: ` QRhiResource::resourceType()` const.

Devuelve el tipo de recurso.

int QRhiGraphicsPipeline::sampleCount() const

Devuelve el número de muestras establecido actualmente. El valor 1 indica que no se aplica antialiasing por multimuestra.

Véase también setSampleCount().

void QRhiGraphicsPipeline::setCullMode(QRhiGraphicsPipeline::CullMode mode)

Establece el culling de caras especificado mode.

Véase también cullMode().

void QRhiGraphicsPipeline::setDepthBias(int bias)

Establece la profundidad bias. El valor por defecto es 0.

Véase también depthBias().

[since 6.11] void QRhiGraphicsPipeline::setDepthClamp(bool enable)

Habilita el recorte de profundidad cuando enable tiene el valor «true». Cuando el recorte de profundidad está habilitado, las primitivas que, de otro modo, serían recortadas por el plano de recorte cercano o lejano se rasterizan y sus valores de profundidad se limitan al rango de profundidad. Cuando está deshabilitado (valor por defecto), dichas primitivas se recortan.

Nota: Esta configuración se ignora cuando se indica que la función « QRhi::DepthClamp » no es compatible.

Esta función se introdujo en Qt 6.11.

Véase también ` hasDepthClamp()`.

void QRhiGraphicsPipeline::setDepthOp(QRhiGraphicsPipeline::CompareOp op)

Establece la función de comparación de profundidad op.

Véase también depthOp().

void QRhiGraphicsPipeline::setDepthTest(bool enable)

Activa o desactiva la comprobación de profundidad según enable. Tanto la comprobación de profundidad como el almacenamiento de los datos de profundidad están desactivados por defecto.

Véase también hasDepthTest() y setDepthWrite().

void QRhiGraphicsPipeline::setDepthWrite(bool enable)

Controla la escritura de datos de profundidad en el búfer de profundidad según enable. Por defecto, esta opción está desactivada. La escritura de profundidad suele activarse junto con la comprobación de profundidad.

Nota: Habilitar la escritura de profundidad sin tener habilitada la prueba de profundidad puede no dar el resultado deseado, por lo que debe evitarse.

Véanse también hasDepthWrite() y setDepthTest().

void QRhiGraphicsPipeline::setFlags(QRhiGraphicsPipeline::Flags f)

Establece los indicadores « f ».

Véase también flags().

void QRhiGraphicsPipeline::setFrontFace(QRhiGraphicsPipeline::FrontFace f)

Establece el modo de la cara frontal f.

Véase también frontFace().

void QRhiGraphicsPipeline::setLineWidth(float width)

Establece la línea « width ». Si durante la ejecución se indica que la función « QRhi::WideLines » no es compatible, se ignoran los valores distintos de 1.0f.

Véase también lineWidth().

[since 6.7] void QRhiGraphicsPipeline::setMultiViewCount(int count)

Establece el « count » de la vista para el renderizado multivista. El valor por defecto es 0, lo que indica que no hay renderizado multivista. « count » debe ser 2 o mayor para activar el renderizado multivista.

La visualización en varias vistas solo está disponible cuando se indica que la vista « MultiView feature » es compatible. El destino de renderizado debe ser una matriz de texturas 2D, y el adjunto de color para el destino de renderizado debe tener configurado el mismo valor de « count ».

Consulte QRhiColorAttachment::setMultiViewCount() para obtener más detalles sobre el renderizado multivista.

Esta función se introdujo en Qt 6.7.

Véanse también multiViewCount(), QRhi::MultiView y QRhiColorAttachment::setMultiViewCount().

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Establece el número de puntos de control del parche en count. El valor por defecto es 3. Solo se utiliza cuando la topología está configurada en Patches.

Véase también patchControlPointCount().

void QRhiGraphicsPipeline::setPolygonMode(QRhiGraphicsPipeline::PolygonMode mode)

Establece el polígono « mode ». El valor por defecto es «Fill».

Véase también polygonMode() y QRhi::NonFillPolygonMode.

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Se asocia con el QRhiRenderPassDescriptor desc especificado.

Véase también renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Establece el número de muestras. Los valores habituales para « s » son 1, 4 u 8. El canal de procesamiento debe ser siempre compatible con el destino de renderizado; es decir, el número de muestras debe coincidir.

Véase también sampleCount() y QRhi::supportedSampleCounts().

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

Se asocia con ` srb `, que describe el diseño de enlace de recursos y los propios recursos (QRhiBuffer, QRhiTexture). Este último es opcional, ya que durante la creación del pipeline solo importa el diseño. Por lo tanto, el ` srb ` que se pasa aquí puede dejar sin especificar los objetos de búfer o textura reales (nullptr), siempre y cuando exista otro, ` layout-compatible ` QRhiShaderResourceBindings, vinculado mediante ` setShaderResources()` antes de registrar las llamadas de dibujo.

Véase también shaderResourceBindings().

void QRhiGraphicsPipeline::setShaderStages(std::initializer_list<QRhiShaderStage> list)

Establece la « list » de las etapas del shader.

template <typename InputIterator> void QRhiGraphicsPipeline::setShaderStages(InputIterator first, InputIterator last)

Establece la lista de etapas de shader a partir de los iteradores first y last.

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

Establece la profundidad escalada de la pendiente bias. El valor por defecto es 0.

Véase también slopeScaledDepthBias().

void QRhiGraphicsPipeline::setStencilBack(const QRhiGraphicsPipeline::StencilOpState &state)

Establece la prueba de plantilla « state » para las caras posteriores.

Véase también stencilBack().

void QRhiGraphicsPipeline::setStencilFront(const QRhiGraphicsPipeline::StencilOpState &state)

Establece la prueba de plantilla « state » para las caras frontales.

Véase también stencilFront().

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Establece la lectura de la plantilla en mask. El valor por defecto es 0xFF.

Véase también stencilReadMask().

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Activa o desactiva las pruebas de plantilla según enable. Por defecto, esta opción está desactivada.

Véase también hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

Establece el mask de escritura de la plantilla. El valor por defecto es 0xFF.

Véase también stencilWriteMask().

void QRhiGraphicsPipeline::setTargetBlends(std::initializer_list<QRhiGraphicsPipeline::TargetBlend> list)

Establece el « list » de la configuración de mezcla de los objetivos de renderizado. Se trata de una lista porque, cuando se utilizan varios objetivos de renderizado (es decir, un « QRhiTextureRenderTarget » con más de un « QRhiColorAttachment »), es necesario que haya una estructura « TargetBlend » por cada objetivo de renderizado (adjunto de color).

Por defecto, hay un conjunto TargetBlend creado de forma predeterminada.

Véase también QRhi::MaxColorAttachments.

template <typename InputIterator> void QRhiGraphicsPipeline::setTargetBlends(InputIterator first, InputIterator last)

Establece la lista de ajustes de mezcla del destino de renderizado a partir de los iteradores first y last.

void QRhiGraphicsPipeline::setTopology(QRhiGraphicsPipeline::Topology t)

Establece la topología primitiva t.

Véase también topology().

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

Especifica la entrada de vértices layout.

Véase también vertexInputLayout().

QRhiShaderResourceBindings *QRhiGraphicsPipeline::shaderResourceBindings() const

Devuelve el objeto ` QRhiShaderResourceBindings ` asociado actualmente.

Véase también setShaderResourceBindings().

const QRhiShaderStage *QRhiGraphicsPipeline::shaderStageAt(qsizetype index) const

Devuelve la etapa de shader en la dirección especificada ` index`.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Devuelve el número de etapas de shader de esta cadena de procesamiento.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

Devuelve el sesgo de profundidad escalado por la pendiente que está configurado actualmente.

Véase también setSlopeScaledDepthBias().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

Devuelve el estado actual de la prueba de estarcido para las caras posteriores.

Véase también setStencilBack().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

Devuelve el estado actual de la prueba de plantilla para las caras frontales.

Véase también setStencilFront().

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Devuelve la máscara de lectura de la plantilla actual.

Véase también ` setStencilReadMask()`.

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Devuelve la máscara de escritura de estarcido actual.

Véase también ` setStencilWriteMask()`.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::targetBlendAt(qsizetype index) const

Devuelve la configuración de mezcla del destino de renderizado en el ` index` especificado.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

Devuelve el número de ajustes de mezcla del destino de renderizado.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Devuelve la topología primitiva establecida actualmente.

Véase también ` setTopology()`.

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Devuelve la especificación de disposición de entrada de vértices establecida actualmente.

Véase también setVertexInputLayout().

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