QNode¶

Description¶

QNode is the base class of all Qt3D node classes used to build a Qt3D scene.

The owernship of QNode is determined by the QObject parent/child relationship between nodes. By itself, a QNode has no visual appearance and no particular meaning, it is there as a way of building a node based tree structure.

The parent of a QNode instance can only be another QNode instance.

Each QNode instance has a unique id that allows it to be recognizable from other instances.

When properties are defined on a QNode subclass, their NOTIFY signal will automatically generate notifications that the Qt3D backend aspects will receive.

See also

QEntity, QComponent.

Enums¶

PropertyTrackingMode

TODO

Member	Value	Description
DontTrackValues	TODO	TODO
TrackAllValues	TODO	TODO
TrackFinalValues	TODO	TODO

Methods¶

__init__(parent: QNode = None)

Creates a new QNode instance with parent parent.

Note: The backend aspects will be notified that a QNode instance is part of the scene only if it has a parent; unless this is the root node of the Qt3D scene.

See also

setParent().

blockNotifications(bool) → bool

If block is true, property change notifications sent by this object to aspects are blocked. If block is false, no such blocking will occur.

The return value is the previous value of notificationsBlocked().

Note that the other notification types will be sent even if the notifications for this object have been blocked.

See also

notificationsBlocked().

childNodes() → List[QNode]: Returns a list filled with the QNode children of the current QNode instance.

clearPropertyTracking(str): TODO

clearPropertyTrackings(): TODO

defaultPropertyTrackingMode() → PropertyTrackingMode: See also

setDefaultPropertyTrackingMode().

id() → QNodeId: Returns the id that uniquely identifies the QNode instance.

isEnabled() → bool: TODO

notificationsBlocked() → bool: Returns true if aspect notifications are blocked; otherwise returns false. By default, notifications are not blocked.

See also

blockNotifications().

notifyObservers(QSceneChange)

Sends the change QSceneChangePtr to any QBackendNodes in the registered aspects that correspond to this QNode.

For the common case of a QObject property change, QNode handles this for you automatically by sending a QPropertyUpdatedChange event to the backend nodes. You only need to call this function if you wish to send a specific type of change in place of the automatic handling.

parentNode() → QNode: TODO

propertyTracking(str) → PropertyTrackingMode: See also

setPropertyTracking().

sceneChangeEvent(QSceneChange)

Called when one or more backend aspects sends a notification change to the current QNode instance.

Note: This method should be reimplemented in your subclasses to properly handle the change.

sendCommand(str, data: Any = None, replyTo: int = Qt3DCore.QNodeCommand.CommandId()) → int: TODO

sendReply(QNodeCommand)

Send a command back to the backend node.

Assumes the command is to be to sent back in reply to itself to the backend node.

See also

QNodeCommand, QNode::sendCommand.

setDefaultPropertyTrackingMode(PropertyTrackingMode): See also

defaultPropertyTrackingMode().

setEnabled(bool): See also

isEnabled().

setParent(QNode): TODO

setPropertyTracking(str, PropertyTrackingMode): See also

propertyTracking().

Signals¶

defaultPropertyTrackingModeChanged(PropertyTrackingMode): TODO

enabledChanged(bool): TODO

nodeDestroyed(): TODO

parentChanged(QObject): TODO