En esta página

Qt3DExtras::QSkyboxEntity Class

class Qt3DExtras::QSkyboxEntity

Qt3DExtras::QSkyboxEntity Es una subclase de « Qt3DCore::QEntity » que facilita la tarea y que se puede utilizar para insertar un skybox en una escena 3D. Más información...

Encabezado: #include <Qt3DExtras/QSkyboxEntity>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
En QML: SkyboxEntity
Heredado de: Qt3DCore::QEntity
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

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

Ranuras públicas

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

Señales

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

Descripción detallada

Al especificar un nombre base y una extensión, « Qt3DExtras::QSkyboxEntity » se encargará de generar un archivo « TextureCubeMap » que se renderizará en tiempo de ejecución. Las imágenes del directorio de origen deben seguir el siguiente patrón: nombre base + * «_posx|_posy|_posz|_negx|_negy|_negz» + extensión

Por defecto, la extensión predeterminada es .png.

Asegúrate de desactivar el culling de frustum en el FrameGraph a través del cual se realiza el renderizado del skybox.

Nota: Ten en cuenta que no debes intentar renderizar un skybox con una proyección ortográfica.

Documentación de propiedades

baseName : QString

Contiene el nombre base del skybox.

Funciones de acceso:

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

Señal de notificación:

void baseNameChanged(const QString &path)

extension : QString

Contiene la extensión del nombre del archivo de la imagen del skybox, incluido el «.» inicial.

El valor por defecto es: .png

Funciones de acceso:

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

Señal de notificación:

void extensionChanged(const QString &extension)

gammaCorrect : bool

Un valor booleano que indica si la corrección gamma está activada.

Funciones de acceso:

bool isGammaCorrectEnabled() const
void setGammaCorrectEnabled(bool enabled)

Señal de notificación:

void gammaCorrectEnabledChanged(bool enabled)

Documentación de las funciones de miembro

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

Crea un nuevo objeto ` Qt3DExtras::QSkyboxEntity ` con ` parent ` como padre.

QString QSkyboxEntity::baseName() const

Devuelve el nombre base del Skybox.

Nota: Funcióngetter para la propiedad baseName.

Véase también ` setBaseName()`.

QString QSkyboxEntity::extension() const

Devuelve la extensión

Nota: Funcióngetter para la propiedad «extension».

Véase también setExtension().

bool QSkyboxEntity::isGammaCorrectEnabled() const

Devuelve «true» si la corrección gamma está activada para este skybox.

Nota: Funcióngetter para la propiedad gammaCorrect.

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

Establece el nombre base en « baseName ».

Nota: Funciónde asignación para la propiedad baseName.

Véase también baseName().

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

Establece la extensión en extension.

Nota: Funciónde asignación para la propiedad extension.

Véase también extension().

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

Establece el estado de activación de la corrección gamma en « enabled ».

Nota: Funciónde asignación para la propiedad gammaCorrect.

Véase también ` 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.