QRhiVertexInputAttribute Class
Describe un elemento de entrada de un solo vértice. 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 |
Tipos públicos
| enum | Format { Float4, Float3, Float2, Float, UNormByte4, …, SShort } |
Funciones públicas
| QRhiVertexInputAttribute() | |
| QRhiVertexInputAttribute(int binding, int location, QRhiVertexInputAttribute::Format format, quint32 offset, int matrixSlice = -1) | |
| int | binding() const |
| QRhiVertexInputAttribute::Format | format() const |
| int | location() const |
| int | matrixSlice() const |
| quint32 | offset() const |
| void | setBinding(int b) |
| void | setFormat(QRhiVertexInputAttribute::Format f) |
| void | setLocation(int loc) |
| void | setMatrixSlice(int slice) |
| void | setOffset(quint32 ofs) |
Elementos no miembros relacionados
| size_t | qHash(const QRhiVertexInputAttribute &key, size_t seed = 0) |
| bool | operator!=(const QRhiVertexInputAttribute &a, const QRhiVertexInputAttribute &b) |
| bool | operator==(const QRhiVertexInputAttribute &a, const QRhiVertexInputAttribute &b) |
Descripción detallada
Los miembros especifican el número de enlace, la ubicación, el formato y el desplazamiento de un único elemento de entrada de vértice.
Nota: En el caso de HLSL, se da por supuesto que el sombreador de vértices traducido desde SPIR-V utiliza « TEXCOORD<location> » como semántica para cada entrada. Por lo tanto, no hay nombre ni índice semántico independiente.
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;Ahora supongamos que disponemos de posiciones de vértices de 3 componentes (x, y, z) y coordenadas de textura de 2 componentes (u, v) proporcionadas en un formato no intercalado en un búfer (o incluso en búferes separados). Una vez definidas dos vinculaciones, los atributos podrían especificarse como:
QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({
{ 3 * sizeof(float) },
{ 2 * sizeof(float) }
});
inputLayout.setAttributes({
{ 0, 0, QRhiVertexInputAttribute::Float3, 0 },
{ 1, 1, QRhiVertexInputAttribute::Float2, 0 }
});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 se encuentran 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);Al trabajar con datos intercalados, normalmente habrá un único enlace, con múltiples atributos que hacen referencia a ese mismo punto de enlace del búfer:
QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({
{ 5 * sizeof(float) }
});
inputLayout.setAttributes({
{ 0, 0, QRhiVertexInputAttribute::Float3, 0 },
{ 0, 1, QRhiVertexInputAttribute::Float2, 3 * sizeof(float) }
});y luego:
const QRhiCommandBuffer::VertexInput vbufBinding(interleavedCubeBuf, 0);
cb->setVertexInput(0, 1, &vbufBinding);Nota: Se trata de una API 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 QRhiVertexInputAttribute::Format
Especifica el tipo de datos del elemento.
| Constante | Valor | Descripción |
|---|---|---|
QRhiVertexInputAttribute::Float4 | 0 | Vector de tipo float de cuatro componentes |
QRhiVertexInputAttribute::Float3 | 1 | Vector de tres componentes de tipo «float» |
QRhiVertexInputAttribute::Float2 | 2 | Vector de dos componentes de tipo «float» |
QRhiVertexInputAttribute::Float | 3 | Float |
QRhiVertexInputAttribute::UNormByte4 | 4 | Vector de bytes sin signo normalizado de cuatro componentes |
QRhiVertexInputAttribute::UNormByte2 | 5 | Vector de bytes sin signo normalizado de dos componentes |
QRhiVertexInputAttribute::UNormByte | 6 | Byte sin signo normalizado |
QRhiVertexInputAttribute::UInt4 | 7 | Vector de cuatro componentes de tipo entero sin signo |
QRhiVertexInputAttribute::UInt3 | 8 | Vector de tres componentes de enteros sin signo |
QRhiVertexInputAttribute::UInt2 | 9 | Vector de enteros sin signo de dos componentes |
QRhiVertexInputAttribute::UInt | 10 | Entero sin signo |
QRhiVertexInputAttribute::SInt4 | 11 | Vector de cuatro componentes de enteros con signo |
QRhiVertexInputAttribute::SInt3 | 12 | Vector de tres componentes de enteros con signo |
QRhiVertexInputAttribute::SInt2 | 13 | Vector de enteros con signo de dos componentes |
QRhiVertexInputAttribute::SInt | 14 | Entero con signo |
QRhiVertexInputAttribute::Half4 | 15 | Vector de cuatro componentes de tipo flotante de media precisión (16 bits) |
QRhiVertexInputAttribute::Half3 | 16 | Vector de tres componentes de tipo flotante de media precisión (16 bits) |
QRhiVertexInputAttribute::Half2 | 17 | Vector de dos componentes de tipo flotante de media precisión (16 bits) |
QRhiVertexInputAttribute::Half | 18 | Número flotante de media precisión (16 bits) |
QRhiVertexInputAttribute::UShort4 | 19 | Vector de enteros cortos sin signo de cuatro componentes (16 bits) |
QRhiVertexInputAttribute::UShort3 | 20 | Vector de tres componentes de tipo entero corto sin signo (16 bits) |
QRhiVertexInputAttribute::UShort2 | 21 | Vector de enteros cortos sin signo (16 bits) de dos componentes |
QRhiVertexInputAttribute::UShort | 22 | Entero corto sin signo (16 bits) |
QRhiVertexInputAttribute::SShort4 | 23 | Vector de cuatro componentes de tipo entero corto con signo (16 bits) |
QRhiVertexInputAttribute::SShort3 | 24 | Vector de tres componentes de tipo entero corto con signo (16 bits) |
QRhiVertexInputAttribute::SShort2 | 25 | Vector de dos componentes de enteros cortos con signo (16 bits) |
QRhiVertexInputAttribute::SShort | 26 | Entero corto con signo (16 bits) Nota: La compatibilidad con los atributos de punto flotante de media precisión se indica en tiempo de ejecución mediante el indicador de características « QRhi::Feature::HalfAttributes ». Nota: Direct3D 11/12 admite atributos de entrada de 16 bits, pero no admite los tipos Half3, UShort3 ni SShort3. Los backends de D3D pasan Half3 como Half4, UShort3 como UShort4 y SShort3 como SShort4. Para garantizar la compatibilidad entre plataformas, las entradas de 16 bits deben rellenarse hasta 8 bytes. |
Documentación de funciones de miembro
[constexpr noexcept default] QRhiVertexInputAttribute::QRhiVertexInputAttribute()
Crea una descripción predeterminada del atributo de entrada de un vértice.
QRhiVertexInputAttribute::QRhiVertexInputAttribute(int binding, int location, QRhiVertexInputAttribute::Format format, quint32 offset, int matrixSlice = -1)
Crea una descripción del atributo de entrada de vértice con los valores especificados para « binding », « location », « format » y « offset ».
matrixSlice debe ser -1, salvo cuando este atributo corresponda a una fila o columna de una matriz (por ejemplo, una matriz de 4x4 se convierte en 4 vec4, ocupando 4 posiciones consecutivas de entrada de vértices), en cuyo caso es el índice de la fila o columna. location - matrixSlice debe ser siempre igual al location de la primera fila o columna de la matriz desplegada.
int QRhiVertexInputAttribute::binding() const
Devuelve el índice del punto de enlace.
Véase también ` setBinding()`.
QRhiVertexInputAttribute::Format QRhiVertexInputAttribute::format() const
Devuelve el formato del elemento de entrada del vértice.
Véase también setFormat().
int QRhiVertexInputAttribute::location() const
Devuelve la ubicación del elemento de entrada del vértice.
Véase también setLocation().
int QRhiVertexInputAttribute::matrixSlice() const
Devuelve el segmento de la matriz si el elemento de entrada corresponde a una fila o columna de una matriz, o -1 si no es relevante.
Véase también setMatrixSlice().
quint32 QRhiVertexInputAttribute::offset() const
Devuelve el desplazamiento en bytes del elemento de entrada.
Véase también setOffset().
void QRhiVertexInputAttribute::setBinding(int b)
Establece el índice del punto de enlace en b. Por defecto, está fijado en 0.
Véase también binding().
void QRhiVertexInputAttribute::setFormat(QRhiVertexInputAttribute::Format f)
Establece el formato del elemento de entrada de vértices en « f ». Por defecto, está configurado en «Float4».
Véase también ` format()`.
void QRhiVertexInputAttribute::setLocation(int loc)
Establece la ubicación del elemento de entrada del vértice en loc. Por defecto, está establecido en 0.
Véase también location().
void QRhiVertexInputAttribute::setMatrixSlice(int slice)
Establece la matriz « slice ». Por defecto, este valor está establecido en -1, y solo debe establecerse en un valor a >= 0 cuando este atributo corresponda a una fila o columna de una matriz (por ejemplo, una matriz de 4x4 se convierte en 4 vec4, ocupando 4 ubicaciones de vértices de entrada consecutivas), en cuyo caso es el índice de la fila o columna. location - matrixSlice debe ser siempre igual al « location » de la primera fila o columna de la matriz desplegada.
Véase también matrixSlice().
void QRhiVertexInputAttribute::setOffset(quint32 ofs)
Establece el desplazamiento en bytes del elemento de entrada en ofs.
Véase también ` offset()`.
Elementos no miembros relacionados
[noexcept] size_t qHash(const QRhiVertexInputAttribute &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] bool operator!=(const QRhiVertexInputAttribute &a, const QRhiVertexInputAttribute &b)
Devuelve « false » si los valores de los dos objetos « QRhiVertexInputAttribute » — a y b — son iguales; en caso contrario, devuelve « true ».
[noexcept] bool operator==(const QRhiVertexInputAttribute &a, const QRhiVertexInputAttribute &b)
Devuelve « true » si los valores de los dos objetos de tipo « QRhiVertexInputAttribute » — 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.