Q3DScene Class

属性文档

activeCamera : Q3DCamera*

该属性存储3D场景中当前活动的摄像机。

当设置新的 Q3DCamera 对象时，它会自动作为场景的子节点添加。

访问函数：

通知信号：

activeLight : Q3DLight*

该属性存储3D场景中当前处于活动状态的光源。

当设置新的 Q3DLight 对象时，它会自动作为场景的子对象被添加。

访问函数：

通知信号：

devicePixelRatio : float

该属性存储了将输入坐标映射到像素坐标时所使用的设备像素比。

访问函数：

通知信号：

graphPositionQuery : QPoint

该属性存储了用户输入的坐标，场景将把这些坐标作为图形位置查询进行处理。

如果该属性被设置为invalidSelectionPoint() 以外的值，图形将尝试在主视口内将指定坐标与图形位置进行匹配。渲染过程完成后，该属性将恢复为默认状态invalidSelectionPoint()。在接下来的渲染过程之后，可从QAbstract3DGraph::queriedGraphPosition 属性中读取查询到的图形位置。

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

访问函数：

通知器信号：

另请参阅 QAbstract3DGraph::queriedGraphPosition 。

primarySubViewport : QRect

该属性保存数据可视化主视图所针对的视口内的当前子视口矩形。

如果 `isSlicingActive()` 的值为 `false`，则主子视口等于 `viewport()`。如果 `isSlicingActive()` 的值为 `true `，且主子视口尚未被显式设置，则其大小将为 `viewport()` 的五分之一。

访问函数：

通知器信号：

secondarySubViewport : QRect

该属性用于在视口内保存辅助视口矩形。

辅助视口用于在某些可视化中绘制 2D 切片视图。如果未显式设置，则其值将等于QRect 。如果isSlicingActive() 的返回值为true ，则其值将等于viewport 。

访问函数：

通知器信号：

secondarySubviewOnTop : bool

该属性决定了是2D切片视图还是3D视图显示在最上方。

访问函数：

通知信号：

selectionQueryPosition : QPoint

该属性存储用户输入的坐标，场景应将该坐标作为选区进行处理。

如果该属性设置为invalidSelectionPoint()以外的值，则图形将尝试在主视口内指定坐标处选中一个数据项、轴标签或自定义项。渲染过程结束后，该属性将恢复为默认状态invalidSelectionPoint()。

访问函数：

通知信号：

另请参阅 QAbstract3DGraph::selectedElement 。

slicingActive : bool

该属性表示 2D 切片视图当前是否处于活动状态。

如果true ，则QAbstract3DGraph::selectionMode 必须将QAbstract3DGraph::SelectionRow 或QAbstract3DGraph::SelectionColumn 设置为有效的选择项。

访问函数：

通知信号：

[read-only] viewport : QRect

该属性包含一个只读属性，其中存储了当前视口矩形，所有 3D 渲染均以此为目标。

访问函数：

通知器信号：