QCustom3DItem Class

属性文档

meshFile : QString

该属性存储对象的网格文件名。

文件中的对象必须为 Wavefront OBJ 格式，并包含顶点、法线和 UV 坐标。此外，该对象必须由三角面组成。如果文件缺少法线或 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) 。

访问函数：

通知信号：

scaling : QVector3D

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

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

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

访问函数：

通知信号：

另请参阅 scalingAbsolute 。

[since QtDataVisualization 1.2] scalingAbsolute : bool

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

默认值为true 。

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

此枚举在 QtDataVisualization 1.2 中引入。

访问函数：

通知器信号：

另请参阅 scaling 和positionAbsolute 。

shadowCasting : bool

该属性控制该项是否启用投射阴影。

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

访问函数：

通知信号：

textureFile : QString

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

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

访问函数：

通知器信号：

visible : bool

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

默认值为true 。

访问函数：

通知器信号：