Qt3DExtras::QSkyboxEntity Class
class Qt3DExtras::QSkyboxEntityQt3DExtras::QSkyboxEntity ist eine Unterklasse der Komfort Qt3DCore::QEntity, mit der sich eine Skybox in eine 3D-Szene einfügen lässt. Mehr...
| Header: | #include <Qt3DExtras/QSkyboxEntity> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| In QML: | SkyboxEntity |
| Erbt von: | Qt3DCore::QEntity |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
- baseName : QString
- extension : QString
- gammaCorrect : bool
Öffentliche Funktionen
| QSkyboxEntity(Qt3DCore::QNode *parent = nullptr) | |
| QString | baseName() const |
| QString | extension() const |
| bool | isGammaCorrectEnabled() const |
Öffentliche Slots
| void | setBaseName(const QString &baseName) |
| void | setExtension(const QString &extension) |
| void | setGammaCorrectEnabled(bool enabled) |
Signale
| void | baseNameChanged(const QString &path) |
| void | extensionChanged(const QString &extension) |
| void | gammaCorrectEnabledChanged(bool enabled) |
Detaillierte Beschreibung
Durch die Angabe eines Basisnamens und einer Dateiendung sorgt „ Qt3DExtras::QSkyboxEntity “ dafür, dass ein Bild „ TextureCubeMap “ erstellt wird, das zur Laufzeit gerendert wird. Die Bilder im Quellverzeichnis sollten dem folgenden Muster entsprechen: Basisname + * „_posx|_posy|_posz|_negx|_negy|_negz“ + Dateiendung
Standardmäßig lautet die Dateiendung .png.
Stellen Sie sicher, dass Sie das Frustum-Culling im FrameGraph deaktivieren, über den die Skybox-Rendering erfolgt.
Hinweis: Bitte beachten Sie, dass Sie nicht versuchen sollten, eine Skybox mit orthogonaler Projektion zu rendern.
Dokumentation zu den Eigenschaften
baseName : QString
Enthält den Basisnamen der Skybox.
Zugriffsfunktionen:
| QString | baseName() const |
| void | setBaseName(const QString &baseName) |
Notifier-Signal:
| void | baseNameChanged(const QString &path) |
extension : QString
Enthält die Dateiendung des Dateinamens für das Skybox-Bild, einschließlich des vorangestellten „.“.
Der Standardwert lautet: .png
Zugriffsfunktionen:
| QString | extension() const |
| void | setExtension(const QString &extension) |
Notifier-Signal:
| void | extensionChanged(const QString &extension) |
gammaCorrect : bool
Ein boolescher Wert, der angibt, ob die Gammakorrektur aktiviert ist.
Zugriffsfunktionen:
| bool | isGammaCorrectEnabled() const |
| void | setGammaCorrectEnabled(bool enabled) |
Benachrichtigungssignal:
| void | gammaCorrectEnabledChanged(bool enabled) |
Dokumentation der Member-Funktionen
[explicit] QSkyboxEntity::QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
Erstellt ein neues „ Qt3DExtras::QSkyboxEntity “-Objekt, dessen übergeordnetes Objekt „ parent “ ist.
QString QSkyboxEntity::baseName() const
Gibt den Basisnamen der Skybox zurück.
Hinweis: Getter -Funktion für die Eigenschaft „baseName“.
Siehe auch „ setBaseName()“.
QString QSkyboxEntity::extension() const
Gibt die Erweiterung zurück
Hinweis: Getter -Funktion für die Eigenschaft „extension“.
Siehe auch „ setExtension()“.
bool QSkyboxEntity::isGammaCorrectEnabled() const
Gibt „true“ zurück, wenn die Gammakorrektur für diese Skybox aktiviert ist.
Hinweis: Getter -Funktion für die Eigenschaft „ gammaCorrect “.
[slot] void QSkyboxEntity::setBaseName(const QString &baseName)
Legt den Basisnamen auf „ baseName “ fest.
Hinweis: Setter -Funktion für die Eigenschaft „ baseName “.
Siehe auch „ baseName()“.
[slot] void QSkyboxEntity::setExtension(const QString &extension)
Setzt die Erweiterung auf „ extension “.
Hinweis: Setter -Funktion für die Eigenschaft „ extension “.
Siehe auch extension().
[slot] void QSkyboxEntity::setGammaCorrectEnabled(bool enabled)
Setzt den Aktivierungsstatus der Gammakorrektur auf „ enabled “.
Hinweis: Setter -Funktion für die Eigenschaft „ gammaCorrect “.
Siehe auch „ isGammaCorrectEnabled()“.
© 2026 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.
