Skip to content

Kuesa::Qt3D::Skybox

Module: Kuesa Qt 3D API

Kuesa::Qt3D::SkyBox is a convenience Qt3DCore::QEntity subclass used to insert a skybox in a 3D scene. Unlike Qt3DExtras::SkyboxEntity, its implementation is compatible with the Kuesa provided default framegraph. More...

#include <Kuesa/Qt3D/api/skybox.h>

Inherits from Qt3DCore::QEntity

Public Slots

Name
void setBaseName(const QString & baseName)
void setExtension(const QString & extension)

Public Signals

Name
void baseNameChanged(const QString & path)
void extensionChanged(const QString & extension)

Public Functions

Name
Skybox(Qt3DCore::QNode * parent =nullptr)
~Skybox()
QString baseName() const
Skybox::baseName The skybox base name.
QString extension() const
Skybox::extension The skybox extension.

Public Properties

Name
QString baseName
QString extension

Detailed Description

1
class Kuesa::Qt3D::Skybox;

Kuesa::Qt3D::SkyBox is a convenience Qt3DCore::QEntity subclass used to insert a skybox in a 3D scene. Unlike Qt3DExtras::SkyboxEntity, its implementation is compatible with the Kuesa provided default framegraph.

See:

Since: Kuesa 2.0

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

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

Kuesa::Qt3D::Skybox uses a baseName and an extension for the textures that will be used for the skybox. Depending on the skybox extension, Kuesa will create different textures to be used as skybox.

  • *.dds Kuesa tries to load a texture called baseName + extension and uses a Qt3DRender::QTextureLoader to generate the texture
  • Anything else: Kuesa tries to load 6 different textures and creates a Qt3DRender::QTextureCubeMap from them
1
2
3
4
5
6
- baseName + _posx + extension
- baseName + _negx + extension
- baseName + _posy + extension
- baseName + _negy + extension
- baseName + _posz + extension
- baseName + _negz + extension

Public Slots Documentation

slot setBaseName

1
2
3
void setBaseName(
    const QString & baseName
)

Sets the base name for the texture(s) that will be used as skybox to baseName.

slot setExtension

1
2
3
void setExtension(
    const QString & extension
)

Sets the extension for the texture(s) that will be used as skybox

Public Signals Documentation

signal baseNameChanged

1
2
3
void baseNameChanged(
    const QString & path
)

signal extensionChanged

1
2
3
void extensionChanged(
    const QString & extension
)

Public Functions Documentation

function Skybox

1
2
3
explicit Skybox(
    Qt3DCore::QNode * parent =nullptr
)

function ~Skybox

1
~Skybox()

function baseName

1
QString baseName() const

Skybox::baseName The skybox base name.

function extension

1
QString extension() const

Skybox::extension The skybox extension.

Public Property Documentation

property baseName

1
QString baseName;

property extension

1
QString extension;

Updated on 2023-07-03 at 11:02:09 +0000