QSkyboxEntity 类

class Qt3DExtras::QSkyboxEntity

Qt3D Extras::QSkyboxEntity 是一个便捷的 Qt3DCore::QEntity 子类,可用于在 3D 场景中插入天空盒。更多...

头文件 #include <Qt3D Extras/QSkyboxEntity>
CMakefind_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmakeQT += 3dextras
实例化 SkyboxEntity
继承自 Qt3DCore::QEntity

属性

公共函数

QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
QStringbaseName() const
QStringextension() const
boolisGammaCorrectEnabled() const

公共槽

voidsetBaseName(const QString &baseName)
voidsetExtension(const QString &extension)
voidsetGammaCorrectEnabled(bool enabled)

信号

voidbaseNameChanged(const QString &path)
voidextensionChanged(const QString &extension)
voidgammaCorrectEnabledChanged(bool enabled)

详细说明

通过指定基础名和扩展名,Qt3D Extras::QSkyboxEntity 将负责构建 TextureCubeMap,以便在运行时渲染。源目录中的图像应匹配以下模式:base名称 + * "_posx|_posy|_posz|_negx|_negy|_negz" + 扩展名

默认情况下,扩展名默认为 .png。

请确保禁用在 FrameGraph 中通过的天空盒渲染的透视剪切面裁剪。

注意:请记住,您不应该尝试使用正交投影渲染天空盒。

属性文档

baseName : QString

包含天空盒的基础名称。

访问函数

QStringbaseName() const
voidsetBaseName(const QString &baseName)

异常信号

voidbaseNameChanged(const QString &path)

extension : QString

包含用于天空盒图像的文件名扩展名,包括前导'.'。

默认值是:.png

访问函数

QStringextension() const
voidsetExtension(const QString &extension)

异常信号

voidextensionChanged(const QString &extension)

gammaCorrect : bool

一个布尔值,表示是否启用伽玛校正。

访问函数

boolisGammaCorrectEnabled() const
voidsetGammaCorrectEnabled(bool enabled)

异常信号

voidgammaCorrectEnabledChanged(bool enabled)

成员函数文档

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

构建一个新的 Qt3DExtras::QSkyboxEntity 对象,其中parent作为父对象。

QString QSkyboxEntity::baseName() const

返回天空盒的基本名称。

注意:是基本名称属性的获取器函数。

另请参阅:setBaseName()。

QString QSkyboxEntity::extension() const

返回扩展名

注意:是扩展名称属性的获取器函数。

另请参阅:setExtension()。

bool QSkyboxEntity::isGammaCorrectEnabled() const

如果此天空盒启用了伽玛校正,则返回true。

注意:是gammaCorrect属性的获取器函数。

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

将基本名称设置为baseName

注意:是基本名称属性的设置器函数。

另请参阅:baseName()。

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

将扩展设置为extension

注意:是扩展属性的设置器函数。

另请参阅:extension()。

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

将伽玛校正启用状态设置为enabled

注意:属性 gammaCorrect 的设置函数。

另见 isGammaCorrectEnabled()。

© 2024 Qt公司。本文件中包含的文档贡献版权属于其相应的所有者。本文件提供的文档根据自由软件基金会发表的 GNU Free Documentation License版本1.3 许可条款进行许可。Qt及其相关标志是芬兰的Qt公司及其它全球国家的商标。所有其他商标均为其相应所有者的财产。