内容

• 公共类型
• 特性
• 公共函数
• 公共槽
• 信号
• 静态公共成员
• 保护函数
• 重实现保护函数
• 详细描述

QTextureImage 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

• 所有成员列表，包括继承成员
• 过时成员

公共类型

enum	Status { None, Loading, Ready, Error }

特性

• mirrored : bool
• source : QUrl
• status : const Status

• 3 特性继承自 Qt3DRender::QAbstractTextureImage
• 3 特性继承自 Qt3DCore::QNode
• 1 特性继承自 QObject

公共函数

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

• 3 公共函数继承自 Qt3DRender::QAbstractTextureImage
• 13 公共函数继承自 Qt3DCore::QNode
• 31 公共函数继承自 QObject

公共槽

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

• 3 公共槽继承自 Qt3DRender::QAbstractTextureImage
• 3 公共槽继承自 Qt3DCore::QNode
• 1 公共槽继承自 QObject

信号

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

• 3 信号继承自 Qt3DRender::QAbstractTextureImage
• 4 信号继承自 Qt3DCore::QNode
• 2 信号继承自 QObject

静态公共成员

const QMetaObject

staticMetaObject

• 9 静态公共成员继承自 QObject

保护函数

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

重实现保护函数

virtual void

sceneChangeEvent (const Qt3DCore::QSceneChangePtr & change ) override

• 2 保护函数继承自 Qt3DRender::QAbstractTextureImage
• 2 保护函数继承自 Qt3DCore::QNode
• 9 保护函数继承自 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.

常量	值	描述
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.

• TextureImage .None
• TextureImage .Loading
• TextureImage .Ready
• TextureImage .Error

访问函数：

Qt3DRender::QTextureImage::Status

status () const

通知程序信号：

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

成员函数文档编制

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

构造新的 Qt3DRender::QTextureImage 实例与 parent 作为父级。

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 ().

Sets the scene change event to change . change

[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 ().

[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 ().