PySide6.QtQuick.QSGSimpleTextureNode

class QSGSimpleTextureNode

QSGSimpleTextureNode 类是为了方便使用 QML 场景图轻松绘制纹理内容而提供的。更多

PySide6.QtQuick.QSGSimpleTextureNode 的继承图

概要

方法

注意

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

详细描述

警告

简单的纹理节点类在添加到场景图进行渲染之前必须具有纹理。

警告

此实用程序类仅在运行Qt Quick场景图的默认或软件后端时有效。作为替代方案,建议通过createImageNode()使用QSGImageNode。然而,当通过子类化使用并且应用程序知道不会涉及特殊的场景图后端时,这个独立的类仍然有用。

class TextureCoordinatesTransformFlag

(继承自 enum.Flag) TextureCoordinatesTransformFlag 枚举用于指定为纹理四边形生成纹理坐标的模式。

常量

描述

QSGSimpleTextureNode.NoTransform

纹理坐标与窗口坐标对齐,即原点位于左上角。

QSGSimpleTextureNode.MirrorHorizontally

纹理坐标在水平轴上相对于窗口坐标进行了反转

QSGSimpleTextureNode.MirrorVertically

纹理坐标在垂直轴上相对于窗口坐标进行了反转

__init__()

构造一个新的简单纹理节点

filtering()
Return type:

过滤

返回当前在此纹理节点上设置的过滤

另请参阅

setFiltering()

ownsTexture()
Return type:

布尔

如果节点拥有纹理的所有权,则返回 true;否则返回 false

另请参阅

setOwnsTexture()

rect()
Return type:

QRectF

返回此纹理节点的目标矩形。

另请参阅

setRect()

setFiltering(filtering)
Parameters:

过滤Filtering

设置用于此纹理节点的过滤为 filtering

为了实现平滑缩放,请使用Linear;对于普通缩放,请使用Nearest

另请参阅

filtering()

setOwnsTexture(owns)
Parameters:

owns – 布尔值

设置节点是否拥有纹理的所有权为owns

默认情况下,节点不拥有纹理的所有权。

setRect(rect)
Parameters:

矩形QRectF

将此纹理节点的目标矩形设置为 r

另请参阅

rect()

setRect(x, y, w, h)
Parameters:
  • x – 浮点数

  • y – 浮点数

  • w – 浮点数

  • h – 浮点数

这是一个重载函数。

设置此纹理节点的矩形从(x, y)开始,宽度为w,高度为h

setSourceRect(r)
Parameters:

rQRectF

将此纹理节点的源矩形设置为 r

另请参阅

sourceRect()

setSourceRect(x, y, w, h)
Parameters:
  • x – 浮点数

  • y – 浮点数

  • w – 浮点数

  • h – 浮点数

这是一个重载函数。

设置此纹理节点的矩形,以从(x, y)显示其纹理,并相对于textureSize具有宽度w和高度h

setTexture(texture)
Parameters:

纹理QSGTexture

将此纹理节点的纹理设置为 texture

使用setOwnsTexture()来设置节点是否应该拥有纹理的所有权。默认情况下,节点不拥有所有权。

警告

在将纹理节点添加到场景图以进行渲染之前,必须具有纹理。

另请参阅

texture()

setTextureCoordinatesTransform(mode)
Parameters:

modeTextureCoordinatesTransformFlag 的组合

设置用于生成纹理坐标的方法为mode。这可以用于获得正确的纹理方向。在使用第三方OpenGL库渲染到纹理时,通常需要这样做,因为OpenGL的y轴相对于Qt Quick是倒置的。

sourceRect()
Return type:

QRectF

返回此纹理节点的源矩形。

另请参阅

setSourceRect()

texture()
Return type:

QSGTexture

返回此纹理节点的纹理

另请参阅

setTexture()

textureCoordinatesTransform()
Return type:

TextureCoordinatesTransformFlag的组合

返回用于为此节点生成纹理坐标的模式。