PySide6.QtGraphs.QCustom3DItem

class QCustom3DItem

QCustom3DItem 类向图表添加了一个自定义项目。更多

PySide6.QtGraphs.QCustom3DItem 的继承图

继承者: QCustom3DVolume, QCustom3DLabel

概要

属性

方法

信号

注意

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

详细描述

自定义项目具有自定义网格、位置、缩放、旋转和可选的纹理。

另请参阅

addCustomItem()

注意

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

property meshFileᅟ: str

此属性保存项目网格文件名。

文件中的项目必须是网格格式。其他类型可以通过Balsam资产导入工具进行转换。建议网格文件包括顶点、法线和UV。

Access functions:
property positionᅟ: QVector3D

此属性保存项目位置为QVector3D。

默认为 QVector3D(0.0, 0.0, 0.0)

项目位置可以在数据坐标或绝对坐标中指定,具体取决于positionAbsolute属性。当使用绝对坐标时,-1.0...1.0之间的值在轴范围内。

注意

如果positionAbsolutefalse,则位于任何轴范围之外的项不会被渲染,除非该项是部分可见的QCustom3DVolume并且scalingAbsolute也为false。在这种情况下,体积的可见部分将被渲染。

另请参阅

positionAbsolute

Access functions:
property positionAbsoluteᅟ: bool

此属性决定项目位置是在数据坐标中处理还是在绝对坐标中处理。

默认为 false。具有绝对坐标的项目将始终被渲染,而具有数据坐标的项目只有在它们位于轴范围内时才会被渲染。

另请参阅

position

Access functions:
property rotationᅟ: QQuaternion

此属性保存项目旋转为QQuaternion。

默认为 QQuaternion(0.0, 0.0, 0.0, 0.0)

Access functions:
property scalingᅟ: QVector3D

此属性保存项目缩放为QVector3D。

默认为 QVector3D(0.1, 0.1, 0.1)

项目缩放可以是数据值或绝对值,取决于scalingAbsolute属性。默认向量被解释为绝对值,将项目设置为图形高度的10%,前提是项目网格已归一化且图形的纵横比未从默认值更改。

另请参阅

scalingAbsolute

Access functions:
property scalingAbsoluteᅟ: bool

此属性表示项目缩放是在数据值中处理还是在绝对值中处理。

默认为 true

具有绝对缩放的项目将以相同的大小呈现,无论轴范围如何。具有数据缩放的项目将根据轴范围改变其表观大小。如果positionAbsolutetrue,则忽略此属性,并将缩放解释为绝对值。如果项目有旋转,则数据缩放是在未旋转的项目上计算的。同样,对于QCustom3DVolume项目,范围裁剪是在未旋转的项目上计算的。

注意

仅支持对QCustom3DLabel项目或在polar图表中使用的自定义项目进行绝对缩放。

注意

自定义项目的网格必须归一化到范围[-1 ,1],否则数据缩放将不准确。

另请参阅

scaling positionAbsolute

Access functions:
property shadowCastingᅟ: bool

此属性保存项目的阴影投射是否启用。

默认为 true。如果为 false,则无论 Q3DGraphsWidgetItem::ShadowQuality 如何,该项目都不会投射阴影。

Access functions:
property textureFileᅟ: str

此属性保存项目的纹理文件名。

如果此属性和纹理图像均未设置,则将使用纯灰色纹理。

注意

为了节省内存,从文件加载的QImage在创建纹理后被清除。

Access functions:
property visibleᅟ: bool

此属性保存项目的可见性。

默认为 true

Access functions:
__init__([parent=None])
Parameters:

父对象QObject

使用指定的parent构建一个自定义的3D项目。

__init__(meshFile, position, scaling, rotation, texture[, parent=None])
Parameters:

使用指定的meshFilepositionscalingrotationtexture图像和可选的parent构建一个自定义的3D项目。

isPositionAbsolute()
Return type:

布尔

属性 positionAbsoluteᅟ 的获取器。

isScalingAbsolute()
Return type:

布尔

属性 scalingAbsoluteᅟ 的获取器。

isShadowCasting()
Return type:

布尔

属性 shadowCastingᅟ 的获取器。

isVisible()
Return type:

布尔

属性 visibleᅟ 的获取器。

meshFile()
Return type:

字符串

另请参阅

setMeshFile()

属性 meshFileᅟ 的获取器。

meshFileChanged(meshFile)
Parameters:

meshFile – str

属性 meshFileᅟ 的通知信号。

needUpdate()
position()
Return type:

QVector3D

另请参阅

setPosition()

属性 positionᅟ 的获取器。

positionAbsoluteChanged(positionAbsolute)
Parameters:

positionAbsolute – 布尔值

属性 positionAbsoluteᅟ 的通知信号。

positionChanged(position)
Parameters:

位置QVector3D

属性 positionᅟ 的通知信号。

rotation()
Return type:

QQuaternion

另请参阅

setRotation()

属性 rotationᅟ 的获取器。

rotationChanged(rotation)
Parameters:

旋转QQuaternion

属性 rotationᅟ 的通知信号。

scaling()
Return type:

QVector3D

另请参阅

setScaling()

属性 scalingᅟ 的获取器。

scalingAbsoluteChanged(scalingAbsolute)
Parameters:

scalingAbsolute – 布尔值

属性 scalingAbsoluteᅟ 的通知信号。

scalingChanged(scaling)
Parameters:

缩放QVector3D

属性 scalingᅟ 的通知信号。

setMeshFile(meshFile)
Parameters:

meshFile – str

另请参阅

meshFile()

属性 meshFileᅟ 的设置器。

setPosition(position)
Parameters:

位置QVector3D

另请参阅

position()

属性 positionᅟ 的设置器。

setPositionAbsolute(positionAbsolute)
Parameters:

positionAbsolute – 布尔值

另请参阅

isPositionAbsolute()

属性 positionAbsoluteᅟ 的设置器。

setRotation(rotation)
Parameters:

旋转QQuaternion

另请参阅

rotation()

属性 rotationᅟ 的设置器。

setRotationAxisAndAngle(axis, angle)
Parameters:

一个方便的函数,用于从axisangle构造旋转四元数。

另请参阅

rotation

setScaling(scaling)
Parameters:

缩放QVector3D

另请参阅

scaling()

属性 scalingᅟ 的设置器。

setScalingAbsolute(scalingAbsolute)
Parameters:

scalingAbsolute – 布尔值

另请参阅

isScalingAbsolute()

属性 scalingAbsoluteᅟ 的设置器。

setShadowCasting(enabled)
Parameters:

enabled – 布尔值

另请参阅

isShadowCasting()

属性 shadowCastingᅟ 的设置器。

setTextureFile(textureFile)
Parameters:

textureFile – str

另请参阅

textureFile()

属性 textureFileᅟ 的设置器。

setTextureImage(textureImage)
Parameters:

textureImageQImage

textureImage的值设置为项目的QImage。纹理默认为纯灰色。

注意

为了节省内存,创建纹理后,给定的QImage将被清除。

setVisible(visible)
Parameters:

visible – 布尔值

另请参阅

isVisible()

属性 visibleᅟ 的设置器。

shadowCastingChanged(shadowCasting)
Parameters:

shadowCasting – 布尔值

属性 shadowCastingᅟ 的通知信号。

textureFile()
Return type:

字符串

另请参阅

setTextureFile()

属性 textureFileᅟ 的获取器。

textureFileChanged(textureFile)
Parameters:

textureFile – str

属性 textureFileᅟ 的通知信号。

visibleChanged(visible)
Parameters:

visible – 布尔值

属性 visibleᅟ 的通知信号。