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.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qt3dextras-qskyboxentity.html