En esta página

Qt3DRender::QGeometryRenderer Class

class Qt3DRender::QGeometryRenderer

Encapsula el renderizado de la geometría. Más...

Encabezado: #include <qgeometryrenderer.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: GeometryRenderer
Heredado de: Qt3DCore::QBoundingVolume
Heredado por:

Qt3DExtras::QConeMesh, Qt3DExtras::QCuboidMesh, Qt3DExtras::QCylinderMesh, Qt3DExtras::QExtrudedTextMesh, Qt3DExtras::QPlaneMesh, Qt3DExtras::QSphereMesh, Qt3DExtras::QTorusMesh y Qt3DRender::QMesh

Estado: Obsoleta

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Tipos públicos

enum PrimitiveType { Points, Lines, LineLoop, LineStrip, Triangles, …, Patches }

Propiedades

Funciones públicas

QGeometryRenderer(Qt3DCore::QNode *parent = nullptr)
int firstInstance() const
int firstVertex() const
Qt3DCore::QGeometry *geometry() const
int indexBufferByteOffset() const
int indexOffset() const
int instanceCount() const
bool primitiveRestartEnabled() const
Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType() const
int restartIndexValue() const
float sortIndex() const
int vertexCount() const
int verticesPerPatch() const

Ranuras públicas

void setFirstInstance(int firstInstance)
void setFirstVertex(int firstVertex)
void setGeometry(Qt3DCore::QGeometry *geometry)
void setIndexBufferByteOffset(int offset)
void setIndexOffset(int indexOffset)
void setInstanceCount(int instanceCount)
void setPrimitiveRestartEnabled(bool enabled)
void setPrimitiveType(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)
void setRestartIndexValue(int index)
void setSortIndex(float sortIndex)
void setVertexCount(int vertexCount)
void setVerticesPerPatch(int verticesPerPatch)

Señales

void firstInstanceChanged(int firstInstance)
void firstVertexChanged(int firstVertex)
void geometryChanged(Qt3DCore::QGeometry *geometry)
void indexBufferByteOffsetChanged(int offset)
void indexOffsetChanged(int indexOffset)
void instanceCountChanged(int instanceCount)
void primitiveRestartEnabledChanged(bool primitiveRestartEnabled)
void primitiveTypeChanged(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)
void restartIndexValueChanged(int restartIndexValue)
void sortIndexChanged(float sortIndex)
void vertexCountChanged(int vertexCount)
void verticesPerPatchChanged(int verticesPerPatch)

Descripción detallada

Un objeto ` Qt3DRender::QGeometryRenderer ` contiene toda la información necesaria para dibujar un objeto ` Qt3DCore::QGeometry`. Un objeto `QGeometry` contiene las coordenadas de los datos geométricos; `QGeometryRenderer` especifica cómo interpretar dichos datos.

Documentación sobre los tipos de miembros

enum QGeometryRenderer::PrimitiveType

El tipo de la primitiva.

ConstanteValorDescripción
Qt3DRender::QGeometryRenderer::Points0x0000Lista de puntos
Qt3DRender::QGeometryRenderer::Lines0x0001Lista de líneas
Qt3DRender::QGeometryRenderer::LineLoop0x0002Grupo de líneas conectadas por los extremos que forman un bucle
Qt3DRender::QGeometryRenderer::LineStrip0x0003Grupo de líneas conectadas
Qt3DRender::QGeometryRenderer::Triangles0x0004Lista de triángulos
Qt3DRender::QGeometryRenderer::TriangleStrip0x0005Lista de triángulos conectados
Qt3DRender::QGeometryRenderer::TriangleFan0x0006Lista de triángulos conectados en la que todos los triángulos comparten el primer vértice
Qt3DRender::QGeometryRenderer::LinesAdjacency0x000APermite al sombreador geométrico acceder a las líneas adyacentes de una lista de líneas
Qt3DRender::QGeometryRenderer::TrianglesAdjacency0x000CPermite al sombreador geométrico acceder a los triángulos adyacentes de una lista de triángulos
Qt3DRender::QGeometryRenderer::LineStripAdjacency0x000BPermite que el sombreador geométrico acceda a las líneas adyacentes de una tira de líneas
Qt3DRender::QGeometryRenderer::TriangleStripAdjacency0x000DPermite al sombreador geométrico acceder a los triángulos adyacentes de una tira de triángulos
Qt3DRender::QGeometryRenderer::Patches0x000EÚnico tipo de primitiva aceptado por el sombreador de teselación en el que un parche está formado por un número arbitrario de vértices

Documentación de la propiedad

firstInstance : int

Almacena la instancia base.

Funciones de acceso:

int firstInstance() const
void setFirstInstance(int firstInstance)

Señal del notificador:

void firstInstanceChanged(int firstInstance)

firstVertex : int

Contiene el vértice base.

Funciones de acceso:

int firstVertex() const
void setFirstVertex(int firstVertex)

Señal de notificación:

void firstVertexChanged(int firstVertex)

geometry : Qt3DCore::QGeometry*

Almacena la geometría.

Funciones de acceso:

Qt3DCore::QGeometry *geometry() const
void setGeometry(Qt3DCore::QGeometry *geometry)

Señal de notificación:

void geometryChanged(Qt3DCore::QGeometry *geometry)

indexBufferByteOffset : int

Almacena el desplazamiento en bytes dentro del búfer de índices.

Funciones de acceso:

int indexBufferByteOffset() const
void setIndexBufferByteOffset(int offset)

Señal del notificador:

void indexBufferByteOffsetChanged(int offset)

indexOffset : int

Contiene el vértice base.

Funciones de acceso:

int indexOffset() const
void setIndexOffset(int indexOffset)

Señal de notificación:

void indexOffsetChanged(int indexOffset)

instanceCount : int

Almacena el recuento de instancias.

Funciones de acceso:

int instanceCount() const
void setInstanceCount(int instanceCount)

Señal del notificador:

void instanceCountChanged(int instanceCount)

primitiveRestartEnabled : bool

Contiene el indicador de reinicio primitivo.

Funciones de acceso:

bool primitiveRestartEnabled() const
void setPrimitiveRestartEnabled(bool enabled)

Señal de notificador:

void primitiveRestartEnabledChanged(bool primitiveRestartEnabled)

primitiveType : PrimitiveType

Almacena el tipo primitivo.

Funciones de acceso:

Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType() const
void setPrimitiveType(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)

Señal del notificador:

void primitiveTypeChanged(Qt3DRender::QGeometryRenderer::PrimitiveType primitiveType)

restartIndexValue : int

Almacena el índice de reinicio.

Funciones de acceso:

int restartIndexValue() const
void setRestartIndexValue(int index)

Señal de notificación:

void restartIndexValueChanged(int restartIndexValue)

[since 6.0] sortIndex : float

Anula el índice de ordenación cuando la ordenación por profundidad está activada.

Si la ordenación por profundidad está activada en el gráfico de fotogramas, el renderizador ordenará los objetos en función de la distancia a la que se encuentre el centro del volumen delimitador respecto a la cámara y renderizará los objetos de más lejos a más cerca.

Esta propiedad se puede utilizar para anular el índice de profundidad y controlar con precisión el orden en el que se renderizan los objetos. Esto resulta útil cuando todos los objetos se encuentran a la misma distancia física de la cámara.

Los valores concretos no son significativos, solo definen un orden para clasificar los objetos. Estos se ordenan de tal forma que el objeto con el valor más pequeño se dibuja primero, luego el segundo más pequeño, y así sucesivamente.

Nota: Si se establece este valor en -1.f, se desactivará la ordenación explícita para esta entidad y se volverá a utilizar la distancia desde el centro del volumen delimitador.

Esta enumeración se introdujo en Qt 6.0.

Funciones de acceso:

float sortIndex() const
void setSortIndex(float sortIndex)

Señal de notificador:

void sortIndexChanged(float sortIndex)

Véase también Qt3DRender::QSortPolicy.

vertexCount : int

Almacena el recuento de primitivas.

Funciones de acceso:

int vertexCount() const
void setVertexCount(int vertexCount)

Señal del notificador:

void vertexCountChanged(int vertexCount)

verticesPerPatch : int

Almacena vértices por parche.

Funciones de acceso:

int verticesPerPatch() const
void setVerticesPerPatch(int verticesPerPatch)

Señal del notificador:

void verticesPerPatchChanged(int verticesPerPatch)

Documentación de las funciones de miembro

[explicit] QGeometryRenderer::QGeometryRenderer(Qt3DCore::QNode *parent = nullptr)

Crea un nuevo objeto `QGeometryRenderer` con ` parent`.

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