QTextureImage Class

(Qt3DRender::QTextureImage)

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

头文件: #include <QTextureImage>
qmake: QT += 3drender
开始支持版本: Qt 5.5
Instantiated By: TextureImage
基类: Qt3DRender::QAbstractTextureImage

公有类型

enum Status { None, Loading, Ready, Error }

属性

公有函数

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

公有槽函数

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

信号

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

受保护的函数

void sceneChangeEvent(const Qt3DCore::QSceneChangePtr &change)
void setStatus(Status status)

其他继承的成员

  • 1 个公有变量继承自 QObject
  • 10 个静态公有成员继承自 QObject
  • 2 个受保护的变量继承自 QObject

详细描述

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

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.

ConstantValueDescription
Qt3DRender::QTextureImage::None0The texture image loading has not been started yet.
Qt3DRender::QTextureImage::Loading1The texture image loading has started, but not finised.
Qt3DRender::QTextureImage::Ready2The texture image loading has finished.
Qt3DRender::QTextureImage::Error3The 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 compressed texture formats.

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

Note: 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)

Notifier signal:

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)

Notifier signal:

void sourceChanged(const QUrl &source)

status : const Status

This property holds the status of the texture image loading.

访问函数:

Status status() const

Notifier signal:

void statusChanged(Status status)

成员函数

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

Default constructs an instance of QTextureImage.

bool QTextureImage::isMirrored() const

Returns whether mirroring is enabled or not.

Note: Getter function for property mirrored.

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

Sets the scene change event to change. change

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

Sets mirroring to mirrored.

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

Note: Setter function for property mirrored.

参见 isMirrored().

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

Sets the source url of the texture image to source.

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

Note: Setter function for property source.

参见 source().

[protected] void QTextureImage::setStatus(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.

Note: Getter function for property source.

参见 setSource().

Status QTextureImage::status() const

Returns the current status.

Note: Getter function for property status.

参见 setStatus().