Q3DScene Class

属性文档

activeCamera : Q3DCamera*

此属性用于保存 3D 场景中当前活动的摄像机。

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

访问功能：

通知信号：

activeLight : Q3DLight*

该属性用于保存 3D 场景中当前激活的灯光。

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

访问功能：

通知信号：

devicePixelRatio : float

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

访问功能：

通知信号：

graphPositionQuery : QPoint

此属性保存用户输入的坐标，场景应将其作为图形位置查询进行处理。

如果此属性设置为invalidSelectionPoint() 以外的值，则图形会尝试将图形位置与主视口内的指定坐标相匹配。渲染结束后，该属性将返回默认状态invalidSelectionPoint() 。在下一次渲染后，可以从QAbstract3DGraph::queriedGraphPosition 属性中读取查询到的图形位置。

没有一个正确的三维坐标与特定的屏幕位置相匹配，因此为了保持一致，查询总是针对图形周围的一个不可见框的内侧进行。

访问功能：

通知信号：

另请参见 QAbstract3DGraph::queriedGraphPosition 。

primarySubViewport : QRect

该属性保存视口中的当前子视口矩形，数据可视化的主视口就在该子视口中。

如果isSlicingActive() 是false ，则主次视口等于viewport()。如果isSlicingActive() 是true ，且未明确设置主次视口，它将是viewport() 的五分之一。

访问功能：

通知信号

secondarySubViewport : QRect

该属性用于保存视口中的辅助视口矩形。

在某些可视化效果中，辅助视口用于绘制二维切片视图。如果没有明确设置，它将等于QRect 。如果isSlicingActive() 是true ，它将等于viewport 。

访问功能：

通知信号：

secondarySubviewOnTop : bool

此属性表示在顶部绘制的是二维切片视图还是三维视图。

访问功能：

通知信号：

selectionQueryPosition : QPoint

此属性用于保存用户输入的坐标，场景应将其作为选择项处理。

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

访问功能：

Notifier 信号：

另请参阅 QAbstract3DGraph::selectedElement 。

slicingActive : bool

此属性表示二维切片视图当前是否处于活动状态。

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

访问功能：

通知信号：

[read-only] viewport : const QRect

此属性为只读属性，包含当前视口矩形，所有 3D 渲染都以该矩形为目标。

访问功能：

通知信号：