Scene3D QML 类型

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

导入语句	import QtDataVisualization 1.7
自	QtDataVisualization 1.0
实例化	Q3DScene

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

属性

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

详细描述

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

3D 场景还跟踪着进行可视化渲染的视口，视口中的主要子视口（其中包含主要的 3D 数据可视化视图）以及数据 2D 切片视图所在的次要子视口。

场景还有一个标志来跟踪次要的 2D 切片视图当前是否活动。

注意：并非所有可视化都支持次要的 2D 切片视图。

属性文档

activeCamera : Camera3D

3D 场景中的当前活动相机。当在属性中设置 Camera3D 时，它会自动作为场景的子项添加。

activeLight : Light3D

3D 场景中的当前活动光源。当在属性中设置 Light3D 时，它会自动作为场景的子项添加。

devicePixelRatio : float

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

graphPositionQuery : point

用户输入的坐标，该坐标由场景作为图形位置查询进行处理。如果此属性设置为 invalidSelectionPoint 之外的值，则图表尝试将图形位置匹配给定的点在主视口中。在渲染过程中，此属性返回到默认状态 invalidSelectionPoint。在下一个渲染周期后，可以从 AbstractGraph3D::queriedGraphPosition 属性中读取所查询的图形位置。

没有单个正确的3D坐标来匹配特定的屏幕位置，因此为了保持一致，查询总是针对围绕着图表的不可见矩形的内部侧面进行。

注意： 条形图仅在图表地板级别允许图形位置查询。

另请参阅 AbstractGraph3D::queriedGraphPosition。

invalidSelectionPoint : point

提供一个无效选择点的常量属性。

primarySubViewport : rect

当前子视窗矩形，在视口中，数据可视化的主要视图被定位在视口中。

如果 slicingActive 设置为 false，则主要子视窗将与视口相同。如果 slicingActive 设置为 true 且主要子视窗尚未显式设置，则它将是视口的五分之一。

注意： 如果主要子视口设置超过或超出视口，则相应调整视口大小。

secondarySubViewport : rect

* * * 视口内的辅助视口矩形。辅助视口 * 在某些可视化中用于绘制2D切片视图。如果它没有 * 被显式设置，则将为空。如果 slicingActive 为 * true，则它 * 将与视口相等。 *

注意： 如果辅助子视口大于或超出视口，则相应调整视口大小。

secondarySubviewOnTop : bool

定义是否是将2D切片视图或3D视图绘制在顶部。

selectionQueryPosition : point

用户输入的坐标，该坐标由场景作为选择进行处理。如果此属性设置为 invalidSelectionPoint 之外的值，则图表尝试在主视口中的给定点选择数据项。在渲染周期后，属性返回到默认状态 invalidSelectionPoint。

slicingActive : bool

定义当前是否激活了2D切片视图。如果 true，则 AbstractGraph3D::selectionMode 必须将 AbstractGraph3D.SelectionRow 或 AbstractGraph3D.SelectionColumn 设置为有效的选择。

注意： 并非所有可视化都支持2D切片视图。

viewport : rect [只读]

所有3D渲染都针对的当前视口矩形。