PySide6.QtGraphs.QCustom3DItem¶
- class QCustom3DItem¶
QCustom3DItem
类向图表添加了一个自定义项目。更多…继承者:
QCustom3DVolume
,QCustom3DLabel
概要¶
属性¶
meshFileᅟ
- 项目网格文件名positionᅟ
- 项目位置作为 QVector3DpositionAbsoluteᅟ
- 项目位置是在数据坐标中处理还是在绝对坐标中处理rotationᅟ
- 项目旋转作为一个QQuaternionscalingᅟ
- 项目缩放作为一个 QVector3DscalingAbsoluteᅟ
- 项目缩放是否以数据值或绝对值处理shadowCastingᅟ
- 是否启用项目的阴影投射textureFileᅟ
- 物品的纹理文件名visibleᅟ
- 项目的可见性
方法¶
def
__init__()
def
isVisible()
def
meshFile()
def
position()
def
rotation()
def
scaling()
def
setMeshFile()
def
setPosition()
def
setRotation()
def
setScaling()
def
setTextureFile()
def
setVisible()
def
textureFile()
信号¶
def
needUpdate()
def
scalingChanged()
def
visibleChanged()
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
自定义项目具有自定义网格、位置、缩放、旋转和可选的纹理。
另请参阅
注意
当使用
from __feature__ import true_property
时,属性可以直接使用,否则通过访问器函数使用。- property meshFileᅟ: str¶
此属性保存项目网格文件名。
文件中的项目必须是网格格式。其他类型可以通过Balsam资产导入工具进行转换。建议网格文件包括顶点、法线和UV。
- Access functions:
此属性保存项目位置为QVector3D。
默认为
QVector3D(0.0, 0.0, 0.0)
。项目位置可以在数据坐标或绝对坐标中指定,具体取决于
positionAbsolute
属性。当使用绝对坐标时,-1.0...1.0
之间的值在轴范围内。注意
如果
positionAbsolute
为false
,则位于任何轴范围之外的项不会被渲染,除非该项是部分可见的QCustom3DVolume
并且scalingAbsolute
也为false
。在这种情况下,体积的可见部分将被渲染。另请参阅
positionAbsolute
- Access functions:
- property positionAbsoluteᅟ: bool¶
此属性决定项目位置是在数据坐标中处理还是在绝对坐标中处理。
默认为
false
。具有绝对坐标的项目将始终被渲染,而具有数据坐标的项目只有在它们位于轴范围内时才会被渲染。另请参阅
- Access functions:
- property rotationᅟ: QQuaternion¶
此属性保存项目旋转为QQuaternion。
默认为
QQuaternion(0.0, 0.0, 0.0, 0.0)
。- Access functions:
此属性保存项目缩放为QVector3D。
默认为
QVector3D(0.1, 0.1, 0.1)
。项目缩放可以是数据值或绝对值,取决于
scalingAbsolute
属性。默认向量被解释为绝对值,将项目设置为图形高度的10%,前提是项目网格已归一化且图形的纵横比未从默认值更改。另请参阅
scalingAbsolute
- Access functions:
- property scalingAbsoluteᅟ: bool¶
此属性表示项目缩放是在数据值中处理还是在绝对值中处理。
默认为
true
。具有绝对缩放的项目将以相同的大小呈现,无论轴范围如何。具有数据缩放的项目将根据轴范围改变其表观大小。如果
positionAbsolute
为true
,则忽略此属性,并将缩放解释为绝对值。如果项目有旋转,则数据缩放是在未旋转的项目上计算的。同样,对于QCustom3DVolume
项目,范围裁剪是在未旋转的项目上计算的。注意
仅支持对
QCustom3DLabel
项目或在polar
图表中使用的自定义项目进行绝对缩放。- Access functions:
- property shadowCastingᅟ: bool¶
此属性保存项目的阴影投射是否启用。
默认为
true
。如果为false
,则无论 Q3DGraphsWidgetItem::ShadowQuality 如何,该项目都不会投射阴影。- Access functions:
- property textureFileᅟ: str¶
此属性保存项目的纹理文件名。
如果此属性和纹理图像均未设置,则将使用纯灰色纹理。
注意
为了节省内存,从文件加载的QImage在创建纹理后被清除。
- Access functions:
- property visibleᅟ: bool¶
此属性保存项目的可见性。
默认为
true
。- Access functions:
使用指定的
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:
字符串
另请参阅
属性
meshFileᅟ
的获取器。- meshFileChanged(meshFile)¶
- Parameters:
meshFile – str
属性
meshFileᅟ
的通知信号。- needUpdate()¶
- position()¶
- Return type:
另请参阅
属性
positionᅟ
的获取器。- positionAbsoluteChanged(positionAbsolute)¶
- Parameters:
positionAbsolute – 布尔值
属性
positionAbsoluteᅟ
的通知信号。属性
positionᅟ
的通知信号。- rotation()¶
- Return type:
另请参阅
属性
rotationᅟ
的获取器。- rotationChanged(rotation)¶
- Parameters:
旋转 –
QQuaternion
属性
rotationᅟ
的通知信号。- scaling()¶
- Return type:
另请参阅
属性
scalingᅟ
的获取器。- scalingAbsoluteChanged(scalingAbsolute)¶
- Parameters:
scalingAbsolute – 布尔值
属性
scalingAbsoluteᅟ
的通知信号。属性
scalingᅟ
的通知信号。- setMeshFile(meshFile)¶
- Parameters:
meshFile – str
另请参阅
属性
meshFileᅟ
的设置器。属性
positionᅟ
的设置器。- setPositionAbsolute(positionAbsolute)¶
- Parameters:
positionAbsolute – 布尔值
另请参阅
属性
positionAbsoluteᅟ
的设置器。- setRotation(rotation)¶
- Parameters:
旋转 –
QQuaternion
另请参阅
属性
rotationᅟ
的设置器。一个方便的函数,用于从
axis
和angle
构造旋转四元数。另请参阅
属性
scalingᅟ
的设置器。- setScalingAbsolute(scalingAbsolute)¶
- Parameters:
scalingAbsolute – 布尔值
另请参阅
属性
scalingAbsoluteᅟ
的设置器。- setShadowCasting(enabled)¶
- Parameters:
enabled – 布尔值
另请参阅
属性
shadowCastingᅟ
的设置器。- setTextureFile(textureFile)¶
- Parameters:
textureFile – str
另请参阅
属性
textureFileᅟ
的设置器。将
textureImage
的值设置为项目的QImage。纹理默认为纯灰色。注意
为了节省内存,创建纹理后,给定的QImage将被清除。
- setVisible(visible)¶
- Parameters:
visible – 布尔值
另请参阅
属性
visibleᅟ
的设置器。- shadowCastingChanged(shadowCasting)¶
- Parameters:
shadowCasting – 布尔值
属性
shadowCastingᅟ
的通知信号。- textureFile()¶
- Return type:
字符串
另请参阅
属性
textureFileᅟ
的获取器。- textureFileChanged(textureFile)¶
- Parameters:
textureFile – str
属性
textureFileᅟ
的通知信号。- visibleChanged(visible)¶
- Parameters:
visible – 布尔值
属性
visibleᅟ
的通知信号。