Q3DLight Class

Representation of a light source in 3D space. More...

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

Properties

Public Functions

Q3DLight(QObject *parent = nullptr)
virtual ~Q3DLight()
bool isAutoPosition()
void setAutoPosition(bool enabled)

Signals

void autoPositionChanged(bool autoPosition)

Detailed Description

Q3DLight represents a monochrome light source in 3D space.

Note: Default light has isAutoPosition() true.

Property Documentation

[since QtDataVisualization 5.9] autoPosition : bool

This property holds whether the light position follows the camera automatically.

Note: Has no effect if shadows are enabled. Remember to disable shadows before setting light's position, or it will be overwritten by automatic positioning if isAutoPosition() is false.

This property was introduced in QtDataVisualization 5.9.

Access functions:

bool isAutoPosition()
void setAutoPosition(bool enabled)

Notifier signal:

void autoPositionChanged(bool autoPosition)

Member Function Documentation

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

Constructs a new 3D light located at origin. An optional parent parameter can be given and is then passed to QObject constructor.

[virtual noexcept] Q3DLight::~Q3DLight()

Destroys the light object.