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 |
- Lista de todos los miembros, incluidos los heredados
- QSGGeometryNode forma parte de las clases de nodos del grafo de escena deQt Quick .
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.