En esta página

QSGGeometryNode Class

La clase QSGGeometryNode se utiliza para todo el contenido renderizado en el grafo de escena. Más información...

Encabezado: #include <QSGGeometryNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Heredado de: QSGBasicGeometryNode
Heredado por:

QSGImageNode, ` QSGRectangleNode`, ` QSGSimpleRectNode` y QSGSimpleTextureNode

Funciones públicas

QSGGeometryNode()
virtual ~QSGGeometryNode() override
QSGMaterial *material() const
QSGMaterial *opaqueMaterial() const
void setMaterial(QSGMaterial *material)
void setOpaqueMaterial(QSGMaterial *material)

Descripción detallada

El QSGGeometryNode consta de geometría y material. La geometría define la malla, los vértices y su estructura, que se van a dibujar. El material define cómo se rellena la forma.

A continuación se muestra un fragmento de código que ilustra cómo crear una línea roja utilizando un QSGGeometryNode:

QSGGeometry *geometry = new QSGGeometry(QSGGeometry::defaultAttributes_Point2D(), 2);
geometry->setDrawingMode(QSGGeometry::DrawLines);
geometry->setLineWidth(3);
geometry->vertexDataAsPoint2D()[0].set(0, 0);
geometry->vertexDataAsPoint2D()[1].set(width(), height());

QSGFlatColorMaterial *material = new QSGFlatColorMaterial;
material->setColor(QColor(255, 0, 0));

QSGGeometryNode *node = new QSGGeometryNode;
node->setGeometry(geometry);
node->setFlag(QSGNode::OwnsGeometry);
node->setMaterial(material);
node->setFlag(QSGNode::OwnsMaterial);

Un nodo de geometría debe tener tanto geometría como un material normal antes de añadirse al grafo de escena. Cuando se modifican la geometría y los materiales después de que el nodo se haya añadido al grafo de escena, el usuario también debe marcarlos como modificados mediante QSGNode::markDirty().

El nodo de geometría admite dos tipos de materiales: el « opaqueMaterial » y el material normal. El « opaqueMaterial » se utiliza cuando la opacidad acumulada del grafo de escena en el momento del renderizado es 1. Su principal uso es tratar el renderizado opaco como un caso especial para evitar que una operación adicional en el sombreador de fragmentos pueda tener un impacto significativo en el rendimiento de los chips gráficos integrados. El material opaco es opcional.

Nota: Todas las clases con el prefijo «QSG» deben utilizarse exclusivamente en el hilo de renderizado del grafo de escena. Consulte «Grafo de escena y renderizado» para obtener más información.

Véase también QSGGeometry y QSGMaterial.

Documentación de las funciones miembro

QSGGeometryNode::QSGGeometryNode()

Crea un nuevo nodo de geometría sin geometría ni material.

[override virtual noexcept] QSGGeometryNode::~QSGGeometryNode()

Elimina este nodo de geometría.

Los indicadores « QSGNode::OwnsMaterial », « QSGNode::OwnsOpaqueMaterial » y « QSGNode::OwnsGeometry » determinan si el nodo de geometría también debe eliminar los materiales y la geometría. Por defecto, estos indicadores están desactivados.

QSGMaterial *QSGGeometryNode::material() const

Devuelve el material de QSGGeometryNode.

Véase también setMaterial().

QSGMaterial *QSGGeometryNode::opaqueMaterial() const

Devuelve el material opaco de QSGGeometryNode.

Véase también setOpaqueMaterial().

void QSGGeometryNode::setMaterial(QSGMaterial *material)

Establece el material de este nodo de geometría como « material ».

Los nodos de geometría deben tener un material antes de poder añadirse al grafo de escena.

Si se cambia el material sin volver a llamar a setMaterial(), el usuario también debe marcar el material como modificado mediante QSGNode::markDirty().

Véase también material().

void QSGGeometryNode::setOpaqueMaterial(QSGMaterial *material)

Establece el material opaco de esta geometría como « material ».

El renderizador dará preferencia al material opaco frente al material predeterminado, tal y como lo devuelve la función material(), si no es nulo y el elemento geométrico tiene una opacidad heredada de 1.

La opacidad se refiere a la opacidad del grafo de escena; el material sigue pudiendo establecer QSGMaterial::Blending en true y dibujar píxeles transparentes.

Si se cambia el material sin volver a llamar a setOpaqueMaterial(), el usuario también debe marcar el material opaco como modificado mediante QSGNode::markDirty().

Véase también opaqueMaterial().

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