QSkyboxEntity Class

class Qt3DExtras ::QSkyboxEntity

Qt3DExtras::QSkyboxEntity is a convenience Qt3DCore::QEntity subclass that can be used to insert a skybox in a 3D scene. 更多...

头: #include <Qt3DExtras/QSkyboxEntity>
CMake: find_package(Qt6 COMPONENTS 3dextras REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Since: Qt 5.5
实例化: SkyboxEntity
继承: Qt3DCore::QEntity

特性

公共函数

  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 )

详细描述

By specifying a base name and an extension, Qt3DExtras::QSkyboxEntity will take care of building a TextureCubeMap to be rendered at runtime. The images in the source directory should match the pattern: base name + * "_posx|_posy|_posz|_negx|_negy|_negz" + extension

By default the extension defaults to .png.

Be sure to disable frustum culling in the FrameGraph through which the skybox rendering happens.

注意: Please note that you shouldn't try to render a skybox with an orthographic projection.

特性文档编制

baseName : QString

Contains the base name of the Skybox.

访问函数:

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

通知程序信号:

void baseNameChanged (const QString & path )

extension : QString

Contains the extension of the filename for the skybox image, including the leading '.'.

The default value is: .png

访问函数:

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

通知程序信号:

void extensionChanged (const QString & extension )

[since 5.9] gammaCorrect : bool

A boolean indicating whether gamma correction is enabled.

该特性在 Qt 5.9 引入。

访问函数:

bool isGammaCorrectEnabled () const
void setGammaCorrectEnabled (bool enabled )

通知程序信号:

void gammaCorrectEnabledChanged (bool enabled )

成员函数文档编制

QSkyboxEntity:: QSkyboxEntity ( Qt3DCore::QNode * parent = nullptr)

构造新的 Qt3DExtras::QSkyboxEntity 对象采用 parent 作为父级。

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

Sets the base name to baseName .

注意: setter 函数对于特性 baseName .

另请参阅 baseName ().

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

Sets the extension to extension .

注意: setter 函数对于特性 extension .

另请参阅 extension ().

[slot, since 5.9] void QSkyboxEntity:: setGammaCorrectEnabled ( bool enabled )

Sets the gamma correction enable state to enabled .

注意: setter 函数对于特性 gammaCorrect .

该函数在 Qt 5.9 引入。

另请参阅 isGammaCorrectEnabled ().

QString QSkyboxEntity:: baseName () const

Returns the base name of the Skybox.

注意: Getter function for property baseName.

另请参阅 setBaseName ().

QString QSkyboxEntity:: extension () const

Returns the extension

注意: Getter function for property extension.

另请参阅 setExtension ().

[since 5.9] bool QSkyboxEntity:: isGammaCorrectEnabled () const

Returns true if gamma correction is enabled for this skybox.

注意: getter 函数对于特性 gammaCorrect .

该函数在 Qt 5.9 引入。