Scene3D QML 类型

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

导入声明	import QtGraphs
实例化	Q3DScene
状态	技术预览

包括继承成员的所有成员列表
Scene3D 是 Qt 绘图 QML 3D 类型之一的一个部分。

属性

devicePixelRatio : float
graphPositionQuery : point
invalidSelectionPoint : point
primarySubViewport : rect
secondarySubViewport : rect
secondarySubviewOnTop : bool
selectionQueryPosition : point
slicingActive : bool
viewport : rect

详细描述

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

3D场景还跟踪图形渲染所进行的视口，视口内部的主要3D图形视图所在的主要子视口，以及数据2D切分视图所在的次级子视口。

场景还有一个标志，用于跟踪当前的次级2D切分视图是否处于活动状态。

注意：并非所有图形都支持次级2D切分视图。

属性文档

devicePixelRatio : float

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

graphPositionQuery : point

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

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

注意：条形图只允许在图表地板层面进行图表位置查询。

另见：AbstractGraph3D::queriedGraphPosition.

invalidSelectionPoint : point [只读]

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

primarySubViewport : rect

视图在其内部绘制主要图表的当前子视口矩形。

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

注意：将 primarySubViewport 设置得大于视口或超出视口范围，将相应地调整视口大小。

secondarySubViewport : rect

视口内部用于绘制某些图表的 2D 切片视图的次级视口矩形。如果没有显式设置，则将为 null。如果 slicingActive 为 true，则将与视口相等。

注意：如果次级子视口大于或超出视口，将相应地调整视口大小。

secondarySubviewOnTop : bool

定义是否绘制 2D 切片视图或 3D 视图在最上面。

selectionQueryPosition : point

用作选择处理用户输入的坐标。如果此属性设置为invalidSelectionPoint以外的值，则图表尝试在主视口内给定点处选择数据项目。在渲染传递后，该属性将返回invalidSelectionPoint的默认状态。

slicingActive : bool

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

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

viewport : rect [只读]

当前视口矩形，所有 3D 渲染均针对此矩形。