Q3DObject Class

The Q3DObject class is a simple base class for all the objects in a 3D scene. More...

Header: #include <Q3DObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
In QML: Object3D
Inherits: QObject
Inherited By:

Q3DCamera and Q3DLight


Public Functions

Q3DObject(QObject *parent = nullptr)
virtual ~Q3DObject()
virtual void copyValuesFrom(const Q3DObject &source)
Q3DScene *parentScene()
QVector3D position() const
void setPosition(const QVector3D &position)


void positionChanged(const QVector3D &position)

Protected Functions

bool isDirty() const
void setDirty(bool dirty)

Detailed Description

Contains position information for an object in a 3D scene. The object is considered to be a single point in the coordinate space without dimensions.

Property Documentation

[read-only] parentScene : Q3DScene* const

This property holds the parent scene as a read only value.

If the object has no parent scene, the value is 0.

Access functions:

Q3DScene *parentScene()

position : QVector3D

This property holds the 3D position of the object.

Note: Currently setting this property has no effect for Q3DCamera, as the position is handled internally.

Access functions:

QVector3D position() const
void setPosition(const QVector3D &position)

Notifier signal:

void positionChanged(const QVector3D &position)

Member Function Documentation

[explicit] Q3DObject::Q3DObject(QObject *parent = nullptr)

Constructs a new 3D object with the position set to origin by default. An optional parent parameter can be given and is then passed to the QObject constructor.

[virtual noexcept] Q3DObject::~Q3DObject()

Destroys the 3D object.

[virtual] void Q3DObject::copyValuesFrom(const Q3DObject &source)

Copies the 3D object position from the given source 3D object to this 3D object instance.

[protected] bool Q3DObject::isDirty() const

Returns whether the 3D object has changed.

[protected] void Q3DObject::setDirty(bool dirty)

Sets dirty to true if the 3D object has changed since the last update.

See also isDirty().

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