Custom3DItem QML Type

Adds a custom item to a graph. 更多...

import 语句: import QtDataVisualization 1.15
Since: QtDataVisualization 1.1
实例化: QCustom3DItem
继承者:

Custom3DLabel and Custom3DVolume

特性

方法

详细描述

A custom item has a custom mesh, position, scaling, rotation, and an optional texture.

特性文档编制

meshFile : string

The item mesh file name. The item in the file must be in Wavefront OBJ format and include vertices, normals, and UVs. It also needs to be in triangles.

位置 : vector3d

The item position as a vector3d type. Defaults to vector3d(0.0, 0.0, 0.0) .

Item position is specified either in data coordinates or in absolute coordinates, depending on the value of the positionAbsolute property. When using absolute coordinates, values between -1.0...1.0 are within axis ranges.

注意: Items positioned outside any axis range are not rendered if positionAbsolute is false , unless the item is a Custom3DVolume that would be partially visible and scalingAbsolute is also false . In that case, the visible portion of the volume will be rendered.

另请参阅 positionAbsolute and scalingAbsolute .

positionAbsolute : bool

Defines whether item position is to be handled in data coordinates or in absolute coordinates. Defaults to false . Items with absolute coordinates will always be rendered, whereas items with data coordinates are only rendered if they are within axis ranges.

另请参阅 position .

rotation : quaternion

The item rotation as a quaternion 。默认为 quaternion(0.0, 0.0, 0.0, 0.0) .

scaling : vector3d

The item scaling as a vector3d type. Defaults to vector3d(0.1, 0.1, 0.1) .

Item scaling is specified either in data values or in absolute values, depending on the value of the scalingAbsolute property. The default vector interpreted as absolute values sets the item to 10% of the height of the graph, provided the item mesh is normalized and the graph aspect ratios have not been changed from the defaults.

另请参阅 scalingAbsolute .

scalingAbsolute : bool

Defines whether item scaling is to be handled in data values or in absolute values. Defaults to true . Items with absolute scaling will be rendered at the same size, regardless of axis ranges. Items with data scaling will change their apparent size according to the axis ranges. If positionAbsolute is true , this property is ignored and scaling is interpreted as an absolute value. If the item has rotation, the data scaling is calculated on the unrotated item. Similarly, for Custom3DVolume items, the range clipping is calculated on the unrotated item.

注意: Only absolute scaling is supported for Custom3DLabel items or for custom items used in polar 图形。

注意: The custom item's mesh must be normalized to the range [-1 ,1] , or the data scaling will not be accurate.

该特性在 QtDataVisualization 1.2 引入。

另请参阅 scaling and positionAbsolute .

shadowCasting : bool

Defines whether shadow casting for the item is enabled. Defaults to true 。若 false , the item does not cast shadows regardless of ShadowQuality .

textureFile : string

The texture file name for the item. If left unset, a solid gray texture will be used.

注意: To conserve memory, the QImage loaded from the file is cleared after a texture is created.

visible : bool

The visibility of the item. Defaults to true .

方法文档编制

void setRotationAxisAndAngle ( vector3d axis , real angle )

A convenience function to construct the rotation quaternion from axis and angle .

另请参阅 rotation .