Qt 3D Geometría de renderizado
Qt 3D Render ofrece una forma genérica de almacenar datos geométricos y especificar cómo debe leerlos el renderizador.
Búfer
La clase Qt3DCore::QBuffer almacena los datos sin procesar. Actúa simplemente como una matriz de memoria. En la mayoría de los casos, un Qt3DCore::QBuffer se utilizará de forma indirecta, al ser referenciado por uno o más Qt3DRender::QAttributes. Sin embargo, hay ocasiones en las que un ` QBuffer ` puede utilizarse directamente como propiedad «value» de un `QParameter` al trabajar con objetos de búfer uniforme (UBO) u objetos de búfer de almacenamiento de sombreadores (SSBO).
Buffer {
id: vertexBuffer
type: Buffer.VertexBuffer
data: buildVertexBufferData()
}Atributo
Qt3DCore::QAttribute especifica cómo deben extraerse los datos contenidos en el búfer al que se hace referencia y cómo deben pasarse a una entrada de un sombreador de vértices. Hace referencia a un Qt3DCore::QBuffer y puede especificar la disposición de los atributos definiendo el tamaño de los vértices, el tipo de datos, el paso entre dos vértices y un desplazamiento inicial. El tipo del atributo también definirá si se va a utilizar como búfer de vértices o como búfer de índices. Esto te permite una flexibilidad total a la hora de estructurar tus datos en los búferes. Es posible utilizar búferes independientes para cada atributo de vértice, un búfer intercalado que contenga datos para todos los atributos o una combinación de búferes independientes e intercalados.
Attribute {
attributeType: Attribute.VertexAttribute
vertexBaseType: Attribute.Float
vertexSize: 3
byteOffset: 0
byteStride: 9 * 4
count: 4
name: defaultPositionAttributeName()
buffer: vertexBuffer
}Geometría
Un Qt3DCore::QGeometry agrupa varios atributos para formar una pieza de geometría. Normalmente, una geometría adecuada proporcionará un atributo para las posiciones de los vértices, un atributo para las normales de los vértices y un atributo para las coordenadas de textura. Si quieres que tu geometría también funcione con materiales con mapa de normales, deberá proporcionar además un conjunto coherente de vectores tangentes de los vértices.
Geometry {
Attribute {
attributeType: Attribute.VertexAttribute
vertexBaseType: Attribute.Float
vertexSize: 3
byteOffset: 0
byteStride: 9 * 4
count: 4
name: defaultPositionAttributeName()
buffer: vertexBuffer
}
Attribute {
attributeType: Attribute.VertexAttribute
vertexBaseType: Attribute.Float
vertexSize: 3
byteOffset: 3 * 4
byteStride: 9 * 4
count: 4
name: defaultNormalAttributeName()
buffer: vertexBuffer
}GeometryView
Un Qt3DCore::QGeometryView toma como parámetro un Qt3DCore::QGeometry. Proporciona propiedades para controlar la llamada de dibujo, como el número de instancias que se van a dibujar, la instancia inicial, el tipo de « Qt3DCore::QGeometryView::PrimitiveType » que se va a utilizar, etc.
Define por completo los detalles de una malla, de modo que operaciones como el cálculo del volumen delimitador y la selección puedan realizarse sobre una malla sin necesidad de renderizarla.
GeometryView {
instanceCount: 1
indexOffset: 0
firstInstance: 0
primitiveType: GeometryRenderer.Triangles
geometry: Geometry { ... }
}GeometryRenderer
Qt3DRender::QGeometryRenderer es un QComponent que, cuando se agrega a una QEntity, permite dibujar el Qt3DCore::QGeometryView al que hace referencia. Un Qt3DRender::QGeometryRenderer se traduce en una llamada de dibujo a la API gráfica subyacente.
GeometryRenderer {
view: GeometryView { ... }
}Nota: Antes de Qt 6, Qt3DRender::QGeometryRenderer incluía detalles que ahora se pretende que sean proporcionados por la instancia de la vista. Las propiedades siguen estando presentes en Qt 6, pero quedarán obsoletas y, posteriormente, se eliminarán en Qt 7.
© 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.