QSGNode Class
La clase QSGNode es la clase base de todos los nodos del grafo de escena. Más información...
| Encabezado: | #include <QSGNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Heredado por: | QSGBasicGeometryNode, QSGOpacityNode, QSGRenderNode y QSGTransformNode |
- Lista de todos los miembros, incluidos los heredados
- QSGNode forma parte de las clases de nodos de grafo de escena deQt Quick .
Tipos públicos
| flags | DirtyState |
| enum | DirtyStateBit { DirtyMatrix, DirtyNodeAdded, DirtyNodeRemoved, DirtyGeometry, DirtyMaterial, …, DirtySubtreeBlocked } |
| enum | Flag { OwnedByParent, UsePreprocess, OwnsGeometry, OwnsMaterial, OwnsOpaqueMaterial, InternalReserved } |
| flags | Flags |
| enum | NodeType { BasicNodeType, GeometryNodeType, TransformNodeType, ClipNodeType, OpacityNodeType, RenderNodeType } |
Funciones públicas
| QSGNode() | |
| virtual | ~QSGNode() |
| void | appendChildNode(QSGNode *node) |
| QSGNode * | childAtIndex(int i) const |
| int | childCount() const |
| QSGNode * | firstChild() const |
| QSGNode::Flags | flags() const |
| void | insertChildNodeAfter(QSGNode *node, QSGNode *after) |
| void | insertChildNodeBefore(QSGNode *node, QSGNode *before) |
| virtual bool | isSubtreeBlocked() const |
| QSGNode * | lastChild() const |
| void | markDirty(QSGNode::DirtyState bits) |
| QSGNode * | nextSibling() const |
| QSGNode * | parent() const |
| void | prependChildNode(QSGNode *node) |
| virtual void | preprocess() |
| QSGNode * | previousSibling() const |
| void | removeAllChildNodes() |
| void | removeChildNode(QSGNode *node) |
| void | setFlag(QSGNode::Flag f, bool enabled = true) |
| void | setFlags(QSGNode::Flags f, bool enabled = true) |
| QSGNode::NodeType | type() const |
Descripción detallada
La clase QSGNode puede utilizarse como contenedor de hijos. Los hijos se añaden mediante los métodos appendChildNode(), prependChildNode(), insertChildNodeBefore() y insertChildNodeAfter(). El orden de los nodos es importante, ya que los nodos geométricos se representan según su orden en el grafo de escena.
Los nodos del grafo de escena contienen un mecanismo que describe qué partes de la escena han cambiado. Esto incluye las matrices combinadas, la opacidad acumulada, los cambios en la jerarquía de nodos, etc. Esta información puede utilizarse para realizar optimizaciones dentro del renderizador del grafo de escena. Para que el renderizador renderice correctamente los nodos, es importante que los usuarios llamen a ` QSGNode::markDirty()` con los indicadores correctos cuando se modifiquen los nodos. La mayoría de las funciones de las clases de nodos llamarán implícitamente a ` markDirty()`. Por ejemplo, ` QSGNode::appendChildNode()` llamará a ` markDirty()` pasando ` QSGNode::DirtyNodeAdded`.
Si los nodos cambian en cada fotograma, se puede utilizar la función preprocess() para aplicar los cambios a un nodo en cada fotograma en el que se renderice. El uso de preprocess() debe habilitarse explícitamente estableciendo el indicador QSGNode::UsePreprocess en el nodo.
La función virtual isSubtreeBlocked() se puede utilizar para desactivar por completo un subárbol. Los nodos de un subárbol bloqueado no se someterán a preprocesamiento (preprocessed()) ni se renderizarán.
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.
Documentación sobre tipos de miembros
enum QSGNode::DirtyStateBit
flags QSGNode::DirtyState
Se utiliza en QSGNode::markDirty() para indicar cómo ha cambiado el grafo de escena.
| Constante | Valor | Descripción |
|---|---|---|
QSGNode::DirtyMatrix | 0x0100 | La matriz de un « QSGTransformNode » ha cambiado. |
QSGNode::DirtyNodeAdded | 0x0400 | Se ha añadido un nodo. |
QSGNode::DirtyNodeRemoved | 0x0800 | Se ha eliminado un nodo. |
QSGNode::DirtyGeometry | 0x1000 | Ha cambiado la geometría de un « QSGGeometryNode ». |
QSGNode::DirtyMaterial | 0x2000 | El material de un « QSGGeometryNode » ha cambiado. |
QSGNode::DirtyOpacity | 0x4000 | Ha cambiado la opacidad de un « QSGOpacityNode ». |
QSGNode::DirtySubtreeBlocked | 0x0080 | Se ha bloqueado el subárbol. |
El tipo DirtyState es una definición de tipo (typedef) para QFlags<DirtyStateBit>. Almacena una combinación OR de valores de DirtyStateBit.
Véase también QSGNode::markDirty().
enum QSGNode::Flag
flags QSGNode::Flags
La enumeración QSGNode::Flag describe los indicadores de la QSGNode
| Constante | Valor | Descripción |
|---|---|---|
QSGNode::OwnedByParent | 0x0001 | El nodo es propiedad de su padre y se eliminará cuando se elimine este. |
QSGNode::UsePreprocess | 0x0002 | La función virtual preprocess() del nodo se llamará antes de que comience la representación. |
QSGNode::OwnsGeometry | 0x00010000 | Solo es válido para ` QSGGeometryNode ` y ` QSGClipNode`. El nodo tiene la propiedad de la instancia ` QSGGeometry ` y la eliminará cuando el nodo se destruya o se le asigne una geometría. |
QSGNode::OwnsMaterial | 0x00020000 | Válido únicamente para QSGGeometryNode. El nodo es propietario del material y lo eliminará cuando se destruya el nodo o se asigne un material. |
QSGNode::OwnsOpaqueMaterial | 0x00040000 | Solo válido para QSGGeometryNode. El nodo es propietario del material opaco y lo eliminará cuando el nodo sea destruido o se le asigne un material. |
QSGNode::InternalReserved | 0x01000000 | Reservado para uso interno. |
El tipo «Flags» es un typedef para QFlags<Flag>. Almacena una combinación OR de valores de Flag.
enum QSGNode::NodeType
Se puede utilizar para determinar el tipo de nodo.
| Constante | Valor | Descripción |
|---|---|---|
QSGNode::BasicNodeType | 0 | El tipo de QSGNode |
QSGNode::GeometryNodeType | 1 | El tipo de QSGGeometryNode |
QSGNode::TransformNodeType | 2 | El tipo de QSGTransformNode |
QSGNode::ClipNodeType | 3 | El tipo de QSGClipNode |
QSGNode::OpacityNodeType | 4 | El tipo de QSGOpacityNode |
QSGNode::RenderNodeType | 6 | El tipo de QSGRenderNode |
Véase también type().
Documentación de funciones de miembro
QSGNode::QSGNode()
Crea un nuevo nodo
[virtual noexcept] QSGNode::~QSGNode()
Elimina el nodo.
Todos los elementos hijos de este nodo que tengan activado el indicador « QSGNode::OwnedByParent » también se eliminarán.
void QSGNode::appendChildNode(QSGNode *node)
Añade « node » a la lista de hijos de este nodo.
El orden de los nodos es importante, ya que los nodos geométricos se renderizarán en el orden en que se añaden al grafo de escena.
QSGNode *QSGNode::childAtIndex(int i) const
Devuelve el elemento secundario situado en el índice i.
Los hijos se almacenan internamente como una lista enlazada, por lo que iterar sobre ellos mediante el índice no es la mejor opción.
int QSGNode::childCount() const
Devuelve el número de nodos secundarios.
QSGNode *QSGNode::firstChild() const
Devuelve el primer elemento secundario de este nodo.
Los hijos se almacenan en una lista enlazada.
QSGNode::Flags QSGNode::flags() const
Devuelve el conjunto de indicadores de este nodo.
Véase también setFlags().
void QSGNode::insertChildNodeAfter(QSGNode *node, QSGNode *after)
Inserta « node » en la lista de hijos de este nodo, después del nodo especificado con « after ».
El orden de los nodos es importante, ya que los nodos geométricos se renderizarán en el orden en que se añaden al grafo de escena.
void QSGNode::insertChildNodeBefore(QSGNode *node, QSGNode *before)
Inserta « node » en la lista de hijos de este nodo, antes del nodo especificado con « before ».
El orden de los nodos es importante, ya que los nodos geométricos se renderizarán en el orden en que se añaden al grafo de escena.
[virtual] bool QSGNode::isSubtreeBlocked() const
Devuelve si este nodo y su subárbol están disponibles para su uso.
Los subárboles bloqueados no verán actualizado su estado de cambios y no se renderizarán.
El método « QSGOpacityNode » devolverá un subárbol bloqueado cuando la opacidad acumulada sea 0, por ejemplo.
QSGNode *QSGNode::lastChild() const
Devuelve el último elemento secundario de este nodo.
Los hijos se almacenan como una lista enlazada.
void QSGNode::markDirty(QSGNode::DirtyState bits)
Notifica a todos los renderizadores conectados que el nodo tiene datos modificados bits.
QSGNode *QSGNode::nextSibling() const
Devuelve el nodo que se encuentra a continuación en la lista de hijos del nodo padre.
Los hijos se almacenan como una lista enlazada.
QSGNode *QSGNode::parent() const
Devuelve el nodo padre de este nodo.
void QSGNode::prependChildNode(QSGNode *node)
Añade « node » al principio de la lista de hijos de este nodo.
El orden de los nodos es importante, ya que los nodos geométricos se renderizarán en el orden en que se añaden al grafo de escena.
[virtual] void QSGNode::preprocess()
Sobrescribe esta función para realizar el procesamiento del nodo antes de que se renderice.
El preprocesamiento debe habilitarse explícitamente estableciendo el indicador ` QSGNode::UsePreprocess`. Este indicador debe establecerse antes de añadir el nodo al grafo de escena y hará que se llame a la función `preprocess()` en cada fotograma en el que se renderice el nodo.
Advertencia: Ten cuidado al eliminar nodos mientras se están preprocesando. Es posible, con una ligera pérdida de rendimiento, eliminar un único nodo durante su propia llamada a preprocess. Eliminar un subárbol que contenga nodos que también utilicen el preprocesamiento puede provocar un error de segmentación. Esto se hace por motivos de rendimiento.
QSGNode *QSGNode::previousSibling() const
Devuelve el nodo anterior a este en la lista de hijos del nodo padre.
Los hijos se almacenan como una lista enlazada.
void QSGNode::removeAllChildNodes()
Elimina todos los nodos hijos de la lista de hijos de este nodo.
void QSGNode::removeChildNode(QSGNode *node)
Elimina node de la lista de elementos secundarios de este nodo.
void QSGNode::setFlag(QSGNode::Flag f, bool enabled = true)
Establece el indicador « f » en este nodo si « enabled » es verdadero; en caso contrario, desactiva el indicador.
Véase también flags().
void QSGNode::setFlags(QSGNode::Flags f, bool enabled = true)
Establece los indicadores « f » en este nodo si « enabled » es verdadero; en caso contrario, desactiva dichos indicadores.
Véase también flags().
QSGNode::NodeType QSGNode::type() const
Devuelve el tipo de este nodo. El tipo del nodo debe ser uno de los tipos predefinidos que figuran en QSGNode::NodeType y puede utilizarse sin problema para realizar una conversión a la clase correspondiente.
© 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.