Custom3DItem QML 类型

向图中添加自定义项。更多...

导入声明	import QtDataVisualization 1.7
自	QtDataVisualization 1.1
实例化	QCustom3DItem
继承自	Custom3DLabel 和 Custom3DVolume

所有成员的列表，包括继承的成员

属性

meshFile : string
position : vector3d
positionAbsolute : bool
rotation : quaternion
scaling : vector3d
scalingAbsolute : bool (since QtDataVisualization 1.2)
shadowCasting : bool
textureFile : string
visible : bool

方法

void setRotationAxisAndAngle(vector3d axis, real angle)

详细说明

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

属性文档

meshFile : string

项目网格文件名。文件中的项必须是 Wavefront OBJ 格式，包括顶点、法线和 UV。它还需要是三角形。如果文件缺少法线或 UV，则加载失败，控制台输出错误消息，项目将不会渲染。

position : vector3d

项目位置，作为 vector3d 类型。默认值为 vector3d(0.0, 0.0, 0.0)。

项目位置是数据坐标或绝对坐标，具体取决于 positionAbsolute 属性的值。使用绝对坐标时，值在 -1.0...1.0 范围内。

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

另请参阅：positionAbsolute 和 scalingAbsolute。

positionAbsolute : bool

定义项目位置是否以数据坐标或以绝对坐标处理。默认为 false。具有绝对坐标的项目始终会渲染，而具有数据坐标的项目仅在它们在轴范围内时才渲染。

另请参阅：position。

rotation : quaternion

项目旋转作为一个 quaternion。默认为 quaternion(0.0, 0.0, 0.0, 0.0)。

scaling : vector3d

项目缩放作为一个 vector3d 类型的值。默认为 vector3d(0.1, 0.1, 0.1)。

项缩放是根据 scalingAbsolute 属性值的数据值或绝对值来指定的。默认向量作为绝对值设置项目的高度为图的10%，前提是项目网格已归一化，并且图表的纵横比尚未更改。

另请参阅：scalingAbsolute。

scalingAbsolute : bool [自 QtDataVisualization 1.2 以来]

定义项缩放是按数据值还是绝对值处理。默认为 true。具有绝对缩放的项目将按相同大小渲染，无论轴范围如何。具有数据缩放的项目将根据轴范围更改其外观大小。如果 positionAbsolute 设置为 true，则忽略此属性，并将缩放视为绝对值。如果项目有旋转，则数据缩放是在未旋转的项目上计算的。类似地，对于 Custom3DVolume 项目，范围裁剪是在未旋转的项目上计算的。

注意：仅对 Custom3DLabel 项目或在 polar 图中使用的自定义项支持绝对缩放。

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

此属性是在 QtDataVisualization 1.2 中引入的。

另请参阅：scaling 和 positionAbsolute。

shadowCasting : bool

定义是否为项启用阴影投射。默认为 true。如果 false，则无论 ShadowQuality 如何，项都不会投射阴影。

textureFile : string

项目的纹理文件名。如果未设置，将使用纯灰色纹理。

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

visible : bool

项目的可见性。默认为true。

方法文档

void setRotationAxisAndAngle(vector3d axis, real angle)

这是一个便利函数，用于从axis和angle构造旋转四元数。

另请参阅：rotation。