En esta página

QRhiVertexInputBinding Class

Describe un enlace de entrada de vértices. 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 Classification { PerVertex, PerInstance }

Funciones públicas

QRhiVertexInputBinding()
QRhiVertexInputBinding(quint32 stride, QRhiVertexInputBinding::Classification cls = PerVertex, quint32 stepRate = 1)
QRhiVertexInputBinding::Classification classification() const
quint32 instanceStepRate() const
void setClassification(QRhiVertexInputBinding::Classification c)
void setInstanceStepRate(quint32 rate)
void setStride(quint32 s)
quint32 stride() const
size_t qHash(const QRhiVertexInputBinding &key, size_t seed = 0)
bool operator!=(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)
bool operator==(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)

Descripción detallada

Especifica el paso (en bytes, debe ser un múltiplo de 4), la clasificación y, opcionalmente, la frecuencia de paso de la instancia.

A modo de ejemplo, supongamos un sombreador de vértices con las siguientes entradas:

layout(location = 0) in vec4 position;
layout(location = 1) in vec2 texcoord;

Supongamos ahora también que se proporcionan posiciones de vértices de 3 componentes (x, y, z) y coordenadas de textura de 2 componentes (u, v) en un formato no intercalado en un búfer (o incluso en búferes separados). La definición de dos enlaces se podría realizar así:

QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({
    { 3 * sizeof(float) },
    { 2 * sizeof(float) }
});

Aquí solo nos interesa el paso, ya que no se utiliza la instanciación. El número de enlace viene dado por el índice del elemento QRhiVertexInputBinding en el vector de enlaces de QRhiVertexInputLayout.

Una vez enlazada una canalización gráfica con esta disposición de entradas de vértices, las entradas de vértices podrían configurarse de la siguiente manera para dibujar un cubo de 36 vértices, suponiendo que disponemos de un único búfer en el que primero figuran las posiciones y, a continuación, las coordenadas de textura:

const QRhiCommandBuffer::VertexInput vbufBindings[] = {
    { cubeBuf, 0 },
    { cubeBuf, 36 * 3 * sizeof(float) }
};
cb->setVertexInput(0, 2, vbufBindings);

Obsérvese cómo el índice definido por ` startBinding + i`, donde ` i ` es el índice del segundo argumento de ` setVertexInput()`, coincide con el índice de la entrada correspondiente en el vector ` bindings ` de ` QRhiVertexInputLayout`.

Nota: el paso debe ser siempre un múltiplo de 4.

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::setVertexInput().

Documentación sobre tipos de miembros

enum QRhiVertexInputBinding::Classification

Describe la clasificación de los datos de entrada.

ConstanteValorDescripción
QRhiVertexInputBinding::PerVertex0Los datos son por vértice
QRhiVertexInputBinding::PerInstance1Los datos son por instancia

Documentación de funciones de miembro

[constexpr noexcept default] QRhiVertexInputBinding::QRhiVertexInputBinding()

Crea una descripción predeterminada de la vinculación de entrada de vértices.

QRhiVertexInputBinding::QRhiVertexInputBinding(quint32 stride, QRhiVertexInputBinding::Classification cls = PerVertex, quint32 stepRate = 1)

Crea una descripción de enlace de entrada de vértices con el stride especificado, la clasificación cls y la tasa de pasos de instancia stepRate.

Nota: El valor de « stepRate » distinto de 1 solo se admite cuando se indica que « QRhi::CustomInstanceStepRate » es compatible.

QRhiVertexInputBinding::Classification QRhiVertexInputBinding::classification() const

Devuelve la clasificación de los datos de entrada.

Véase también setClassification().

quint32 QRhiVertexInputBinding::instanceStepRate() const

Devuelve la tasa de paso de la instancia.

Véase también setInstanceStepRate().

void QRhiVertexInputBinding::setClassification(QRhiVertexInputBinding::Classification c)

Establece la clasificación de los datos de entrada c. Por defecto, está configurada como PerVertex.

Véase también classification().

void QRhiVertexInputBinding::setInstanceStepRate(quint32 rate)

Establece el paso de la instancia rate. Por defecto, está fijado en 1.

Véase también instanceStepRate().

void QRhiVertexInputBinding::setStride(quint32 s)

Establece el paso en s.

Véase también stride().

quint32 QRhiVertexInputBinding::stride() const

Devuelve el paso en bytes.

Véase también setStride().

Elementos no miembros relacionados

[noexcept] size_t qHash(const QRhiVertexInputBinding &key, size_t seed = 0)

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

[noexcept] bool operator!=(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)

Devuelve « false » si los valores de los dos objetos « QRhiVertexInputBinding » — a y b — son iguales; en caso contrario, devuelve « true ».

[noexcept] bool operator==(const QRhiVertexInputBinding &a, const QRhiVertexInputBinding &b)

Devuelve « true » si los valores de los dos objetos « QRhiVertexInputBinding » — 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.