- Qt 6.9
- Qt Data Visualization
- C++ Classes
- Q3DLight
- Qt Data Visualization | Commercial or GPLv3

# 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

- List of all members, including inherited members

## Properties

- `(since QtDataVisualization 5.9)` autoPosition : bool

## 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.