QSkyboxEntity Class

class Qt3DExtras::QSkyboxEntity

Qt3DExtras::QSkyboxEntity ist eine bequeme Qt3DCore::QEntity Unterklasse, die zum Einfügen einer Skybox in eine 3D-Szene verwendet werden kann. Mehr...

Kopfzeile: #include <Qt3DExtras/QSkyboxEntity>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
In QML: SkyboxEntity
Vererbt: Qt3DCore::QEntity
Status: Veraltet

Eigenschaften

Ö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 Angabe eines Basisnamens und einer Erweiterung kümmert sich Qt3DExtras::QSkyboxEntity um die Erstellung einer TextureCubeMap, die zur Laufzeit gerendert wird. Die Bilder im Quellverzeichnis sollten dem folgenden Muster entsprechen: base name + * "_posx|_posy|_posz|_negx|_negy|_negz" + extension

Standardmäßig wird die Erweiterung .png verwendet.

Stellen Sie sicher, dass Sie das Frustum Culling im FrameGraph, durch den das Skybox-Rendering erfolgt, deaktivieren.

Hinweis: Bitte beachten Sie, dass Sie nicht versuchen sollten, eine Skybox mit einer orthografischen Projektion zu rendern.

Dokumentation der Eigenschaft

baseName : QString

Enthält den Basisnamen der Skybox.

Zugriffsfunktionen:

QString baseName() const
void setBaseName(const QString &baseName)

Melder-Signal:

void baseNameChanged(const QString &path)

extension : QString

Enthält die Erweiterung des Dateinamens für das Skybox-Bild, einschließlich des führenden '.'.

Der Standardwert ist: .png

Zugriffsfunktionen:

QString extension() const
void setExtension(const QString &extension)

Benachrichtigungssignal:

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)

Melder-Signal:

void gammaCorrectEnabledChanged(bool enabled)

Member Function Dokumentation

[explicit] QSkyboxEntity::QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)

Konstruiert ein neues Qt3DExtras::QSkyboxEntity Objekt mit parent als Elternteil.

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)

Setzt den Basisnamen auf baseName.

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().

© 2025 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.