Qt3DExtras::QSkyboxEntity Class
class Qt3DExtras::QSkyboxEntityQt3DExtras::QSkyboxEntity 这是一个便捷的Qt3DCore::QEntity 子类，可用于在 3D 场景中插入天空盒。更多内容...
| 头文件： | #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 中禁用 frustum culling。
注意：请 注意，不应尝试使用正交投影渲染天空盒。
属性文档
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
返回扩展名
注意： 这是属性 extension 的获取 函数。
另请参阅 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()。
© 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.
