QRhiGraphicsPipeline Class

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(); }

Documentación de las funciones miembro

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

Devuelve un iterador constante que apunta al primer elemento de la lista de etapas de sombreado.

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

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

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

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

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

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

[pure virtual] bool QRhiGraphicsPipeline::create()

Crea los recursos gráficos nativos correspondientes. Si ya hay recursos presentes debido a un create() anterior sin destroy() correspondiente, entonces destroy() se llama implícitamente primero.

Devuelve true en caso de éxito, false en caso de fallo de la operación gráfica. Independientemente del valor de retorno, llamar a destroy() es siempre seguro.

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Devuelve el modo de ocultación de caras actualmente configurado.

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 las banderas configuradas actualmente.

Véase también setFlags().

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

Devuelve el modo de cara frontal actualmente configurado.

Véase también setFrontFace().

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

Devuelve true si la abrazadera de profundidad está activada.

Esta función se introdujo en Qt 6.11.

bool QRhiGraphicsPipeline::hasDepthTest() const

Devuelve true si la prueba de profundidad está activada.

bool QRhiGraphicsPipeline::hasDepthWrite() const

Devuelve true si la escritura en profundidad está activada.

bool QRhiGraphicsPipeline::hasStencilTest() const

Devuelve true si la prueba de esténciles está activada.

float QRhiGraphicsPipeline::lineWidth() const

Devuelve el ancho de línea actual. 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, indicando que no hay renderizado multivista.

Esta función se introdujo en Qt 6.7.

Véase también setMultiViewCount().

int QRhiGraphicsPipeline::patchControlPointCount() const

Devuelve el recuento de puntos de control de parche 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 la dirección 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 actual. 1 significa que no hay antialiasing multimuestra.

Véase también setSampleCount().

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

Establece la selección de caras especificada 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)

Activa la fijación de profundidad cuando enable es verdadero. Cuando la fijación de profundidad está activada, 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 fijan al rango de profundidad. Cuando está desactivada (por defecto), estas primitivas se recortan.

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 prueba de profundidad en función de enable. Tanto la prueba de profundidad como la escritura de datos de profundidad están desactivadas 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 basándose en enable. Por defecto está desactivada. La escritura en profundidad suele activarse junto con la prueba de profundidad.

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

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

Establece las banderas 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 se informa de que la función QRhi::WideLines no está soportada en tiempo de ejecución, se ignoran los valores distintos de 1.0f.

Véase también lineWidth().

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

Establece la vista count para el renderizado multivista. El valor predeterminado es 0, lo que indica que no hay representación multivista. count debe ser 2 o superior para activar la representación multivista.

Multiview sólo está disponible cuando MultiView feature está soportado. El objetivo de renderizado debe ser una matriz de texturas 2D, y el adjunto de color para el objetivo de renderizado debe tener el mismo conjunto count.

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

Esta función se introdujo en Qt 6.7.

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

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Establece el número de puntos de control de parche en count. El valor por defecto es 3. Esto se utiliza sólo cuando la topología se establece en Patches.

Véase también patchControlPointCount().

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

Establece el polígono mode. El valor por defecto es Relleno.

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

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Se asocia con el QRhiRenderPassDescriptor especificado desc.

Véase también renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Establece el recuento de muestras. Los valores típicos para s son 1, 4 u 8. El conducto debe ser siempre compatible con el objetivo de renderizado, es decir, los recuentos de muestras deben coincidir.

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

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

Se asocia a srb para describir la disposición de los recursos y los propios recursos (QRhiBuffer, QRhiTexture). Esto último es opcional, ya que sólo importa la disposición durante la creación de la canalización. Por lo tanto, el srb pasado aquí puede dejar el búfer real o los objetos de textura sin especificar (nullptr) siempre y cuando haya otro, layout-compatible QRhiShaderResourceBindings vinculado a través de setShaderResources() antes de grabar las llamadas de dibujo.

Véase también shaderResourceBindings().

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

Establece el list de las etapas de sombreado.

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

Establece la lista de etapas de sombreado 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 estarcido state para las caras posteriores.

Véase también stencilBack().

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

Establece la prueba de estarcido state para las caras frontales.

Véase también stencilFront().

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Establece la lectura del esténcil mask. El valor por defecto es 0xFF.

Véase también stencilReadMask().

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Activa o desactiva las pruebas de esténcil basadas en enable. Por defecto está desactivado.

Véase también hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

Establece la escritura del esténcil mask. El valor por defecto es 0xFF.

Véase también stencilWriteMask().

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

Establece la list de los ajustes de mezcla del objetivo 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 objetivo de renderizado (adjunto de color).

Por defecto hay un conjunto TargetBlend construido por defecto.

Véase también QRhi::MaxColorAttachments.

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

Establece la lista de ajustes de mezcla del objetivo de renderizado 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 del sombreador en la dirección index especificada.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Devuelve el número de etapas de sombreado en este pipeline.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

Devuelve el sesgo de profundidad a escala de pendiente actualmente establecido.

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 prueba del esténcil para las caras frontales.

Véase también setStencilFront().

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Devuelve la máscara de lectura actual.

Véase también setStencilReadMask().

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Devuelve la máscara de escritura del esténcil actual.

Véase también setStencilWriteMask().

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

Devuelve la configuración de mezcla del objetivo de renderizado en la dirección index especificada.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

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

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Devuelve la topología primitiva actualmente establecida.

Véase también setTopology().

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Devuelve la especificación de diseño de entrada de vértices actualmente establecida.

Véase también setVertexInputLayout().