QSkyboxEntity Class
class Qt3DExtras::QSkyboxEntityQt3DExtras::QSkyboxEntity is a convenience Qt3DCore::QEntity subclass that can be used to insert a skybox in a 3D scene. More...
| Header: | #include <Qt3DExtras/QSkyboxEntity> |
| CMake: | find_package(Qt6 COMPONENTS 3dextras REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| Since: | Qt 5.5 |
| Instantiated By: | SkyboxEntity |
| Inherits: | Qt3DCore::QEntity |
Properties
- baseName : QString
- extension : QString
- gammaCorrect : bool
Public Functions
| QSkyboxEntity(Qt3DCore::QNode *parent = nullptr) | |
| QString | baseName() const |
| QString | extension() const |
| bool | isGammaCorrectEnabled() const |
Public Slots
| void | setBaseName(const QString &baseName) |
| void | setExtension(const QString &extension) |
| void | setGammaCorrectEnabled(bool enabled) |
Signals
| void | baseNameChanged(const QString &path) |
| void | extensionChanged(const QString &extension) |
| void | gammaCorrectEnabledChanged(bool enabled) |
Detailed Description
By specifying a base name and an extension, Qt3DExtras::QSkyboxEntity will take care of building a TextureCubeMap to be rendered at runtime. The images in the source directory should match the pattern: base name + * "_posx|_posy|_posz|_negx|_negy|_negz" + extension
By default the extension defaults to .png.
Be sure to disable frustum culling in the FrameGraph through which the skybox rendering happens.
Note: Please note that you shouldn't try to render a skybox with an orthographic projection.
Property Documentation
baseName : QString
Contains the base name of the Skybox.
Access functions:
| QString | baseName() const |
| void | setBaseName(const QString &baseName) |
Notifier signal:
| void | baseNameChanged(const QString &path) |
extension : QString
Contains the extension of the filename for the skybox image, including the leading '.'.
The default value is: .png
Access functions:
| QString | extension() const |
| void | setExtension(const QString &extension) |
Notifier signal:
| void | extensionChanged(const QString &extension) |
[since 5.9] gammaCorrect : bool
A boolean indicating whether gamma correction is enabled.
This property was introduced in Qt 5.9.
Access functions:
| bool | isGammaCorrectEnabled() const |
| void | setGammaCorrectEnabled(bool enabled) |
Notifier signal:
| void | gammaCorrectEnabledChanged(bool enabled) |
Member Function Documentation
QSkyboxEntity::QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
Constructs a new Qt3DExtras::QSkyboxEntity object with parent as parent.
[slot] void QSkyboxEntity::setBaseName(const QString &baseName)
Sets the base name to baseName.
Note: Setter function for property baseName.
See also baseName().
[slot] void QSkyboxEntity::setExtension(const QString &extension)
Sets the extension to extension.
Note: Setter function for property extension.
See also extension().
[slot, since 5.9] void QSkyboxEntity::setGammaCorrectEnabled(bool enabled)
Sets the gamma correction enable state to enabled.
Note: Setter function for property gammaCorrect.
This function was introduced in Qt 5.9.
See also isGammaCorrectEnabled().
QString QSkyboxEntity::baseName() const
Returns the base name of the Skybox.
Note: Getter function for property baseName.
See also setBaseName().
QString QSkyboxEntity::extension() const
Returns the extension
Note: Getter function for property extension.
See also setExtension().
[since 5.9] bool QSkyboxEntity::isGammaCorrectEnabled() const
Returns true if gamma correction is enabled for this skybox.
Note: Getter function for property gammaCorrect.
This function was introduced in Qt 5.9.