Sur cette page

Qt3DExtras::QSkyboxEntity Class

class Qt3DExtras::QSkyboxEntity

Qt3DExtras::QSkyboxEntity est une sous-classe de commodité de Qt3DCore::QEntity qui peut être utilisée pour insérer une boîte à ciel dans une scène 3D. Plus d'informations...

En-tête : #include <Qt3DExtras/QSkyboxEntity>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake : QT += 3dextras
En QML : SkyboxEntity
Hérite : Qt3DCore::QEntity
Statut : Déclassé

Propriétés

Fonctions publiques

QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
QString baseName() const
QString extension() const
bool isGammaCorrectEnabled() const

Emplacements publics

void setBaseName(const QString &baseName)
void setExtension(const QString &extension)
void setGammaCorrectEnabled(bool enabled)

Signaux

void baseNameChanged(const QString &path)
void extensionChanged(const QString &extension)
void gammaCorrectEnabledChanged(bool enabled)

Description détaillée

En spécifiant un nom de base et une extension, Qt3DExtras::QSkyboxEntity se chargera de construire un TextureCubeMap qui sera rendu au moment de l'exécution. Les images du répertoire source doivent correspondre au modèle : nom de base + * "_posx|_posy|_posz|_negx|_negy|_negz" + extension

Par défaut, l'extension est .png.

Veillez à désactiver le frustum culling dans le FrameGraph à travers lequel le rendu de la skybox est effectué.

Note : Veuillez noter qu'il ne faut pas essayer de rendre une boîte à ciel avec une projection orthographique.

Documentation sur les propriétés

baseName : QString

Contient le nom de base de la Skybox.

Fonctions d'accès :

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

Signal de notification :

void baseNameChanged(const QString &path)

extension : QString

Contient l'extension du nom de fichier de l'image de la boîte à ciel, y compris le "." initial.

La valeur par défaut est : .png

Fonctions d'accès :

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

Signal de notification :

void extensionChanged(const QString &extension)

gammaCorrect : bool

Un booléen indiquant si la correction gamma est activée.

Fonctions d'accès :

bool isGammaCorrectEnabled() const
void setGammaCorrectEnabled(bool enabled)

Signal du notificateur :

void gammaCorrectEnabledChanged(bool enabled)

Member Function Documentation

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

Construit un nouvel objet Qt3DExtras::QSkyboxEntity avec parent comme parent.

QString QSkyboxEntity::baseName() const

Renvoie le nom de base de la Skybox.

Remarque : fonction Getter pour la propriété baseName.

Voir également setBaseName().

QString QSkyboxEntity::extension() const

Renvoie l'extension

Note : Fonction Getter pour l'extension de la propriété.

Voir également setExtension().

bool QSkyboxEntity::isGammaCorrectEnabled() const

Retourne true si la correction gamma est activée pour cette skybox.

Remarque : fonction Getter pour la propriété gammaCorrect.

[slot] void QSkyboxEntity::setBaseName(const QString &baseName)

Fixe le nom de base à baseName.

Remarque : fonction de définition de la propriété baseName.

Voir aussi baseName().

[slot] void QSkyboxEntity::setExtension(const QString &extension)

Définit l'extension à extension.

Note : Fonction de définition de la propriété extension.

Voir aussi extension().

[slot] void QSkyboxEntity::setGammaCorrectEnabled(bool enabled)

Attribue la valeur enabled à l'état d'activation de la correction gamma.

Remarque : fonction de définition de la propriété gammaCorrect.

Voir également 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.