Custom3DItem QML 类型

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

导入声明	import QtGraphs
实例化	QCustom3DItem
继承自	Custom3DLabel 和 Custom3DVolume
状态	技术预览

所有成员的列表，包括继承的成员
Custom3DItem 是 Qt Graphs QML Types for 3D 的一部分。

属性

meshFile : string
position : vector3d
positionAbsolute : bool
rotation : quaternion
scaling : vector3d
scalingAbsolute : bool
shadowCasting : bool
textureFile : string
visible : bool

方法

void setRotationAxisAndAngle(vector3d axis, real angle)

详细描述

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

属性文档

meshFile : string

项网格文件名。文件中的项必须是网格格式。建议网格文件包括顶点、法线和 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

定义项缩放是否以数据值或绝对值处理。默认为 true。具有绝对缩放的项将在相同大小下渲染，不管轴范围如何。具有数据缩放的项将根据轴范围改变其可见大小。如果 positionAbsolute 是 true，则此属性将被忽略，并且缩放被解释为绝对值。如果项有旋转，则数据缩放是在未旋转的项上计算的。同样，对于 Custom3DVolume 项，范围裁剪是在未旋转的项上计算的。

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

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

参见 scaling 和 positionAbsolute.

shadowCasting : bool

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

textureFile : string

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

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

visible : bool

项的可见性。默认为 true。

方法文档

void setRotationAxisAndAngle(vector3d axis, real angle)

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

参见 rotation.