Qt3DExtras::QSkyboxEntity Class
class Qt3DExtras::QSkyboxEntityQt3DExtras::QSkyboxEntity 是一个方便的 子类，可用于在 3D 场景中插入天空盒。Qt3DCore::QEntity 更多
| 头文件： | #include <Qt3DExtras/QSkyboxEntity> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3dextras)target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake： | QT += 3dextras |
| 在 QML 中： | SkyboxEntity |
| 继承： | Qt3DCore::QEntity |
| 状态： | 已废弃 |
属性
- baseName : QString
- extension : QString
- gammaCorrect : bool
公共功能
| QSkyboxEntity(Qt3DCore::QNode *parent = nullptr) | |
| QString | baseName() const |
| QString | extension() const |
| bool | isGammaCorrectEnabled() const |
公共插槽
| void | setBaseName(const QString &baseName) |
| void | setExtension(const QString &extension) |
| void | setGammaCorrectEnabled(bool enabled) |
信号
| void | baseNameChanged(const QString &path) |
| void | extensionChanged(const QString &extension) |
| void | gammaCorrectEnabledChanged(bool enabled) |
详细说明
通过指定基本名称和扩展名，Qt3DExtras::QSkyboxEntity 将负责构建运行时渲染的TextureCubeMap 。源代码目录中的图像应符合以下模式：基本名称 + * "_posx|_posy|_posz|_negx|_negy|_negz" + 扩展名
默认情况下，扩展名默认为 .png。
请确保在进行天空盒渲染的 FrameGraph 中禁用挫边剔除功能。
注意： 请注意不要尝试使用正投影法渲染天空盒。
属性文档
baseName : QString
包含 Skybox 的基本名称。
访问功能：
| QString | baseName() const |
| void | setBaseName(const QString &baseName) |
通知信号：
| void | baseNameChanged(const QString &path) |
extension : QString
包含天空盒图像文件名的扩展名，包括前导".
默认值为：.png
访问功能：
| QString | extension() const |
| void | setExtension(const QString &extension) |
通知信号：
| void | extensionChanged(const QString &extension) |
gammaCorrect : bool
布尔值，表示是否启用伽玛校正。
访问功能
| bool | isGammaCorrectEnabled() const |
| void | setGammaCorrectEnabled(bool enabled) |
通知信号：
| void | gammaCorrectEnabledChanged(bool enabled) |
成员函数 文档
[explicit] QSkyboxEntity::QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
构造一个新的Qt3DExtras::QSkyboxEntity 对象，父对象为parent 。
QString QSkyboxEntity::baseName() const
返回 Skybox 的基本名称。
注： 属性 baseName 的获取函数。
另请参阅 setBaseName().
QString QSkyboxEntity::extension() const
返回扩展名
注： 属性扩展名的获取函数。
另请参阅 setExtension().
bool QSkyboxEntity::isGammaCorrectEnabled() const
如果此天空盒已启用伽玛校正，则返回 true。
注： 属性gammaCorrect 的获取函数。
[slot] void QSkyboxEntity::setBaseName(const QString &baseName)
将基名设置为baseName 。
注： 属性baseName 的设置函数。
另请参阅 baseName() 。
[slot] void QSkyboxEntity::setExtension(const QString &extension)
将扩展名设置为extension 。
注： 属性extension 的设置函数。
另请参阅 extension().
[slot] void QSkyboxEntity::setGammaCorrectEnabled(bool enabled)
将伽玛校正启用状态设置为enabled 。
注： 属性gammaCorrect 的设置函数。
另请参阅 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.
