QCustom3DItem Class

属性文档

meshFile : QString

该属性存储物品网格文件的名称。

文件中的对象必须为网格格式。其他类型可通过Balsam资源导入工具进行转换。建议网格文件包含顶点、法线和 UV 坐标。

访问函数：

通知器信号：

position : QVector3D

该属性将项目位置存储为QVector3D 。

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

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

访问函数：

通知信号：

另请参阅 positionAbsolute 。

positionAbsolute : bool

该属性决定了项目位置是采用数据坐标还是绝对坐标进行处理。

默认值为false 。采用绝对坐标的项将始终被渲染，而采用数据坐标的项仅在位于轴范围之内时才会被渲染。

访问函数：

通知信号：

另请参阅 position 。

rotation : QQuaternion

该属性将项目的旋转值存储为QQuaternion 。

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

访问函数：

通知信号：

[since 6.11] rotationAbsolute : bool

该属性用于指定项目旋转应基于数据轴坐标还是绝对坐标进行处理。

定义项目旋转应基于数据值还是绝对值进行处理。默认值为true 。采用绝对旋转的项目将使用默认坐标进行旋转，无论轴向如何；而采用数据旋转的项目则将根据轴向坐标进行旋转。

该枚举在 Qt 6.11 中引入。

访问函数：

通知信号：

另请参阅 rotation 。

scaling : QVector3D

该属性将项目缩放率存储为QVector3D 。

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

项的缩放采用数据值或绝对值，具体取决于scalingAbsolute 属性。默认向量被解释为绝对值，会将项设置为图表高度的10%，前提是项网格已归一化，且图表的宽高比未从默认值更改。

访问函数：

通知器信号：

另请参阅 scalingAbsolute 。

scalingAbsolute : bool

此属性用于指定项目缩放应基于数据值还是绝对值进行处理。

默认值为true 。

采用绝对缩放的图元将始终以相同大小渲染，无论坐标轴范围如何。 采用数据缩放的项目将根据轴范围改变其显示大小。如果positionAbsolute 为true ，则此属性将被忽略，缩放将被解释为绝对值。如果项目进行了旋转，则数据缩放是基于未旋转的项目计算的。同样，对于QCustom3DVolume 项目，范围裁剪也是基于未旋转的项目计算的。

访问函数：

通知器信号：

另请参阅 scaling 和positionAbsolute 。

shadowCasting : bool

该属性决定该物品是否启用投射阴影。

默认值为true 。如果false ，则无论Q3DGraphsWidgetItem::ShadowQuality的设置如何，该项均不会投射阴影。

访问函数：

通知器信号：

textureFile : QString

该属性存储了该项的纹理文件名。

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

访问函数：

通知器信号：

visible : bool

该属性用于存储该项的可见性。

默认值为true 。

访问函数：

通知器信号：