PySide6.QtGraphs.QCustom3DItem¶

class QCustom3DItem¶

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

继承者： QCustom3DVolume, QCustom3DLabel

概要¶

属性¶

meshFileᅟ - 项目网格文件名
positionᅟ - 项目位置作为 QVector3D
positionAbsoluteᅟ - 项目位置是在数据坐标中处理还是在绝对坐标中处理
rotationᅟ - 项目旋转作为一个QQuaternion
scalingᅟ - 项目缩放作为一个 QVector3D
scalingAbsoluteᅟ - 项目缩放是否以数据值或绝对值处理
shadowCastingᅟ - 是否启用项目的阴影投射
textureFileᅟ - 物品的纹理文件名
visibleᅟ - 项目的可见性

方法¶

def __init__()
def isPositionAbsolute()
def isScalingAbsolute()
def isShadowCasting()
def isVisible()
def meshFile()
def position()
def rotation()
def scaling()
def setMeshFile()
def setPosition()
def setPositionAbsolute()
def setRotation()
def setRotationAxisAndAngle()
def setScaling()
def setScalingAbsolute()
def setShadowCasting()
def setTextureFile()
def setTextureImage()
def setVisible()
def textureFile()

注意

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

详细描述¶

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

另请参阅

addCustomItem()

注意

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

property meshFileᅟ: str¶

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

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

Access functions:

meshFile()
setMeshFile()
信号 meshFileChanged()

property positionᅟ: QVector3D¶

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

默认为 QVector3D(0.0, 0.0, 0.0)。

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

注意

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

另请参阅

positionAbsolute

Access functions:

position()
setPosition()
信号 positionChanged()

property positionAbsoluteᅟ: bool¶

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

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

另请参阅

position

Access functions:

isPositionAbsolute()
setPositionAbsolute()
信号 positionAbsoluteChanged()

property rotationᅟ: QQuaternion¶

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

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

Access functions:

rotation()
setRotation()
信号 rotationChanged()

property scalingᅟ: QVector3D¶

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

默认为 QVector3D(0.1, 0.1, 0.1)。

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

另请参阅

scalingAbsolute

Access functions:

scaling()
setScaling()
信号 scalingChanged()

property scalingAbsoluteᅟ: bool¶

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

默认为 true。

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

注意

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

注意

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

另请参阅

scaling positionAbsolute

Access functions:

isScalingAbsolute()
setScalingAbsolute()
信号 scalingAbsoluteChanged()

property shadowCastingᅟ: bool¶

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

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

Access functions:

isShadowCasting()
setShadowCasting()
信号 shadowCastingChanged()

property textureFileᅟ: str¶

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

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

注意

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

Access functions:

textureFile()
setTextureFile()
信号 textureFileChanged()

property visibleᅟ: bool¶

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

默认为 true。

Access functions:

isVisible()
setVisible()
信号 visibleChanged()

__init__([parent=None])¶

Parameters:: 父对象 – QObject

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

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

Parameters:

meshFile – str
position – QVector3D
缩放 – QVector3D
rotation – QQuaternion
纹理 – QImage
parent – QObject

使用指定的meshFile、position、scaling、rotation、texture图像和可选的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:

axis – QVector3D
angle – 浮点数

一个方便的函数，用于从axis和angle构造旋转四元数。

另请参阅

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:: textureImage – QImage

将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ᅟ 的通知信号。