QTextureImage Class

(Qt3DRender::QTextureImage)

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

Header: #include <QTextureImage>
qmake: QT += 3drender
Since: Qt 5.5
Instantiated By: TextureImage
Inherits: QAbstractTextureImage

Public Types

enum Status { None, Loading, Ready, Error }

Properties

Public Functions

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

Public Slots

void setSource(const QUrl &source)

Signals

void sourceChanged(const QUrl &source)
void statusChanged(Status status)

Protected Functions

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

Additional Inherited Members

  • 1 public variable inherited from QObject
  • 10 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

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.

Member Type Documentation

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.

Property Documentation

source : QUrl

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

Access functions:

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.

Access functions:

Status status() const

Notifier signal:

void statusChanged(Status status)

Member Function Documentation

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

Default constructs an instance of QTextureImage.

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

Sets the scene change event to change. change

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

Sets the source url of the texture image to source.

Note: This triggers a call to update()

Note: Setter function for property source.

See also source().

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

Sets the status to status. status

See also 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.

See also setSource().

Status QTextureImage::status() const

Returns the current status.

Note: Getter function for property status.

See also setStatus().