class QTextureImage#

封装了从图像源创建OpenGL纹理图像所需的信息。 更多

Inheritance diagram of PySide6.Qt3DRender.Qt3DRender.QTextureImage

摘要#

属性#

方法#

#

信号#

注意

此文档可能包含从C++自动转换为Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告诉我们。

详细介绍#

它包含将数据加载到OpenGL纹理的正确位置所需的信息:mipmap级别、层、立方面和源URL。

class 状态#

此枚举指定了纹理图像加载的状态值。

常数

说明

Qt3DRender.QTextureImage.None

纹理图像加载尚未开始。

Qt3DRender.QTextureImage.Loading

已开始加载纹理图像,但尚未完成。

Qt3DRender.QTextureImage.Ready

纹理图像加载已完成。

Qt3DRender.QTextureImage.Error

加载纹理图像时遇到了错误。

注意

当使用 from __feature__ import true_property 时,可以直接使用属性;否则可以通过访问函数使用。

property mirrored: bool#

此属性指定在加载图像时应产生镜像效果,这是一个便捷功能,以避免在使用渲染API的纹理坐标原点时需要手动操作图像。默认情况下,此属性设置为true。当使用GPU压缩纹理格式时,此设置无效。

注意

此属性在加载PNG等未压缩或CPU压缩的图像格式(如PNG)时,将在运行时付出性能代价。为了避免这种性能损失,最好将此属性设置为false,并加载预先进行镜像处理的纹理资产。

注意

OpenGL指定纹理坐标原点位于左下角,而DirectX使用的是左上角的原点。

注意

在切换到立方体贴图纹理时,通常会希望禁用镜像效果,因为立方体贴图采样器接受的是方向而不是常规的纹理坐标。

访问函数
property source: QUrl#

此属性包含用于加载纹理图像数据的源URL。

访问函数
property status: Qt3DRender.QTextureImage.Status#

此属性包含纹理图像加载状态。

访问函数
__init__([parent=None])#
参数:

parent - QNode

使用父对象 parent 构造一个新的 QTextureImage 实例。

isMirrored()#
返回类型:

布尔值

返回是否启用镜像功能。

属性 mirrored_属性 的获取器。

mirroredChanged(mirrored)
参数:

mirrored – bool

属性 mirrored_属性 的通知信号。

setMirrored(mirrored)
参数:

mirrored – bool

将镜像设置为 mirrored

注意

这会内部触发一个更新数据生成器的调用。

另请参阅

isMirrored()

属性 mirrored_属性 的设置器。

setSource(source)
参数:

sourceQUrl

将纹理图的源 URL 设置为 source

注意

这会内部触发一个更新数据生成器的调用。

另请参阅

source()

属性 source_属性 的设置器。

setStatus(status)
参数:

statusStatus

将状态设置为 statusstatus

另请参阅

status()

source()
返回类型:

QUrl

返回用于加载纹理图数据的源 URL。

另请参阅

setSource()

属性 source_属性 的获取器。

sourceChanged(source)
参数:

sourceQUrl

属性 source_属性 的通知信号。

status()
返回类型:

Status

返回当前状态。

另请参阅

setStatus()

属性 status_属性 的获取器。

statusChanged(status)
参数:

statusStatus

属性 status_属性 的通知信号。