Scene3D QML Type

Scene3D 类型提供了对正在可视化的 3D 场景的描述。更多...

该类型已弃用。我们强烈建议不要在新代码中使用它。

• 所有成员列表（包括继承的成员）

属性

• activeCamera : Camera3D
• activeLight : Light3D
• devicePixelRatio : real
• graphPositionQuery : point
• invalidSelectionPoint : point
• primarySubViewport : rect
• secondarySubViewport : rect
• secondarySubviewOnTop : bool
• selectionQueryPosition : point
• slicingActive : bool
• viewport : rect

详细说明

该3D场景包含一个活动摄像机和一个活动光源。假设可视化数据位于固定位置。

该3D场景还会跟踪用于可视化渲染的视口、视口内包含主3D数据可视化视图的主子视口，以及包含数据2D切片视图的辅助子视口。

此外，该场景还设有一个标志，用于跟踪次要的 2D 切片视图当前是否处于活动状态。

属性文档

activeCamera : Camera3D

3D 场景中当前处于活动状态的摄像机。当在属性中设置 Camera3D 时，它会自动作为场景的子对象被添加进去。

activeLight : Light3D

3D 场景中当前处于活动状态的光源。当在属性中设置了 Light3D 时，它会自动作为场景的子对象添加进去。

devicePixelRatio : real

将输入坐标映射到像素坐标时所使用的当前设备像素比例。

graphPositionQuery : point

应由场景作为图形位置查询进行处理的用户输入坐标。如果该属性的值不是invalidSelectionPoint ，则图形会尝试将图形位置与主视口内的给定点进行匹配。 渲染通过后，该属性将恢复为其默认状态invalidSelectionPoint 。在下次渲染通过后，可从AbstractGraph3D::queriedGraphPosition 属性中读取被查询的图形位置。

由于不存在与特定屏幕位置完全对应的唯一正确 3D 坐标，因此为了保持一致性，查询始终针对包围图表的不可见框的内侧进行。

另请参阅 AbstractGraph3D::queriedGraphPosition 。

invalidSelectionPoint : point

一个常量属性，用于提供一个无效的选点。

primarySubViewport : rect

视口内当前的子视口矩形，数据可视化的主视图即以此为目标。

如果slicingActive 的值为false ，则主子视口将与视口大小相同。如果slicingActive 的值为true ，且主子视口未被显式设置，则其大小将为视口的五分之一。

secondarySubViewport : rect

* * * 视口内的二级视口矩形。二级视口 * 用于在某些可视化中绘制 2D 切片视图。如果未 * 显式设置，则该值将为 null。如果slicingActive 的值为true ，则 * 该值将与视口相同。*

secondarySubviewOnTop : bool

用于指定是绘制 2D 切片视图还是 3D 视图在最上方。

selectionQueryPosition : point

应由场景作为选区处理的用户输入坐标。如果此属性设置为invalidSelectionPoint 以外的值，则图形会尝试在主视口内的指定位置选择一个数据项。渲染过程完成后，该属性将恢复为默认状态invalidSelectionPoint 。

slicingActive : bool

用于确定当前是否启用了 2D 切片视图。如果true ，则AbstractGraph3D::selectionMode 必须将AbstractGraph3D.SelectionRow 或AbstractGraph3D.SelectionColumn 设置为有效的选项。

viewport : rect [read-only]

当前视口矩形，所有 3D 渲染均以此为目标。