En esta página

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

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.

ConstanteValorDescripción
QSGNode::DirtyMatrix0x0100La matriz de un « QSGTransformNode » ha cambiado.
QSGNode::DirtyNodeAdded0x0400Se ha añadido un nodo.
QSGNode::DirtyNodeRemoved0x0800Se ha eliminado un nodo.
QSGNode::DirtyGeometry0x1000Ha cambiado la geometría de un « QSGGeometryNode ».
QSGNode::DirtyMaterial0x2000El material de un « QSGGeometryNode » ha cambiado.
QSGNode::DirtyOpacity0x4000Ha cambiado la opacidad de un « QSGOpacityNode ».
QSGNode::DirtySubtreeBlocked0x0080Se 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

ConstanteValorDescripción
QSGNode::OwnedByParent0x0001El nodo es propiedad de su padre y se eliminará cuando se elimine este.
QSGNode::UsePreprocess0x0002La función virtual preprocess() del nodo se llamará antes de que comience la representación.
QSGNode::OwnsGeometry0x00010000Solo 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::OwnsMaterial0x00020000Válido únicamente para QSGGeometryNode. El nodo es propietario del material y lo eliminará cuando se destruya el nodo o se asigne un material.
QSGNode::OwnsOpaqueMaterial0x00040000Solo 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::InternalReserved0x01000000Reservado 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.

ConstanteValorDescripción
QSGNode::BasicNodeType0El tipo de QSGNode
QSGNode::GeometryNodeType1El tipo de QSGGeometryNode
QSGNode::TransformNodeType2El tipo de QSGTransformNode
QSGNode::ClipNodeType3El tipo de QSGClipNode
QSGNode::OpacityNodeType4El tipo de QSGOpacityNode
QSGNode::RenderNodeType6El 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.