QTextureImage Class

class Qt3DRender ::QTextureImage

Encapsulates the necessary information to create an OpenGL texture image from an image source. 更多...

頭: #include <QTextureImage>
qmake: QT += 3drender
Since: Qt 5.5
實例化: TextureImage
繼承: Qt3DRender::QAbstractTextureImage

該類在 Qt 5.5 引入。

公共類型

enum Status { None, Loading, Ready, Error }

特性

公共函數

QTextureImage (Qt3DCore::QNode * parent = nullptr)
bool isMirrored () const
QUrl source () const
Qt3DRender::QTextureImage::Status status () const

公共槽

void setMirrored (bool mirrored )
void setSource (const QUrl & source )

信號

void mirroredChanged (bool mirrored )
void sourceChanged (const QUrl & source )
void statusChanged (Qt3DRender::QTextureImage::Status status )

保護函數

void setStatus (Qt3DRender::QTextureImage::Status status )

重實現保護函數

virtual void sceneChangeEvent (const Qt3DCore::QSceneChangePtr & change ) override

詳細描述

It contains the necessary information mipmap level, layer, cube face and source URL to load at the proper place data into an OpenGL texture.

成員類型文檔編製

enum QTextureImage:: Status

This enumeration specifies the status values for texture image loading.

常量 描述
Qt3DRender::QTextureImage::None 0 The texture image loading has not been started yet.
Qt3DRender::QTextureImage::Loading 1 The texture image loading has started, but not finised.
Qt3DRender::QTextureImage::Ready 2 The texture image loading has finished.
Qt3DRender::QTextureImage::Error 3 The texture image loading confronted an error.

特性文檔編製

mirrored : bool

This property specifies whether the image should be mirrored when loaded. This is a convenience to avoid having to manipulate images to match the origin of the texture coordinates used by the rendering API. By default this property is set to true. This has no effect when using GPU compressed texture formats.

警告: This property results in a performance price payed at runtime when loading uncompressed or CPU compressed image formats such as PNG. To avoid this performance price it is better to set this property to false and load texture assets that have been pre-mirrored.

注意: OpenGL specifies the origin of texture coordinates from the lower left hand corner whereas DirectX uses the the upper left hand corner.

注意: When using cube map texture you'll probably want mirroring disabled as the cube map sampler takes a direction rather than regular texture coordinates.

訪問函數:

bool isMirrored () const
void setMirrored (bool mirrored )

通知程序信號:

void mirroredChanged (bool mirrored )

source : QUrl

This property holds the source url from which data for the texture image will be loaded.

訪問函數:

QUrl source () const
void setSource (const QUrl & source )

通知程序信號:

void sourceChanged (const QUrl & source )

status : const Status

This property holds the status of the texture image loading.

訪問函數:

Qt3DRender::QTextureImage::Status status () const

通知程序信號:

void statusChanged (Qt3DRender::QTextureImage::Status status )

成員函數文檔編製

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

構造新的 Qt3DRender::QTextureImage 實例與 parent 作為父級。

[slot] void QTextureImage:: setMirrored ( bool mirrored )

Sets mirroring to mirrored .

注意: This internally triggers a call to update the data generator.

注意: setter 函數對於特性 mirrored .

另請參閱 isMirrored ().

[slot] void QTextureImage:: setSource (const QUrl & source )

Sets the source url of the texture image to source .

注意: This internally triggers a call to update the data generator.

注意: setter 函數對於特性 source .

另請參閱 source ().

bool QTextureImage:: isMirrored () const

Returns whether mirroring is enabled or not.

注意: getter 函數對於特性 mirrored .

[override virtual protected] void QTextureImage:: sceneChangeEvent (const Qt3DCore::QSceneChangePtr & change )

重實現: QNode::sceneChangeEvent (const Qt3DCore::QSceneChangePtr &change).

Sets the scene change event to change . change

[protected] void QTextureImage:: setStatus ( Qt3DRender::QTextureImage::Status status )

Sets the status to status . status

另請參閱 status ().

QUrl QTextureImage:: source () const

Returns the source url from which data for the texture image will be loaded.

注意: getter 函數對於特性 source。

另請參閱 setSource ().

Qt3DRender::QTextureImage::Status QTextureImage:: status () const

Returns the current status.

注意: getter 函數對於特性 status。

另請參閱 setStatus ().