PySide6.QtGraphs.Q3DScene

class Q3DScene

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

PySide6.QtGraphs.Q3DScene 的继承图

概要

属性

方法

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

3D场景包含一个活动的摄像头和一个活动的光源。可视化的数据被假定在一个固定的位置。

3D场景还跟踪了进行图形渲染的视口,视口内的主要子视口是主3D图形视图所在的位置,而次要子视口则是数据的2D切片视图所在的位置。默认情况下,子视口由Q3DScene调整大小。要覆盖调整大小的行为,您需要监听viewportChanged()slicingActiveChanged()信号,并相应地重新计算子视口。

场景还有一个标志,用于跟踪辅助2D切片视图当前是否处于活动状态。

注意

并非所有图表都支持辅助的2D切片视图。

注意

当使用from __feature__ import true_property时,属性可以直接使用,否则通过访问器函数使用。

property devicePixelRatioᅟ: float

此属性保存用于将输入坐标映射到像素坐标时的设备像素比率。

Access functions:
property graphPositionQueryᅟ: QPoint

此属性保存用户输入的坐标,这些坐标应由场景处理为图形位置查询。

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

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

注意

条形图只允许在图的地板级别进行图位置查询。

另请参阅

queriedGraphPosition

Access functions:
property invalidSelectionPointᅟ: QPoint
Access functions:
property primarySubViewportᅟ: QRect

此属性保存视口内当前子视口矩形,其中图形的初始视图是目标。

如果主次视口未明确设置,它将是viewport()的五分之一。

注意

将primarySubViewport设置为大于或超出视口时,视口会相应调整大小。

Access functions:
property secondarySubViewportᅟ: QRect

此属性保存视口内的辅助视口矩形。

辅助视口用于在某些图表中绘制2D切片视图。如果未明确设置,它将等于视口的大小。

注意

如果次级子视口大于或超出视口,视口将相应调整大小。

Access functions:
property secondarySubviewOnTopᅟ: bool

此属性决定是2D切片视图还是3D视图绘制在顶部。

Access functions:
property selectionQueryPositionᅟ: QPoint

此属性保存应由场景作为选择处理的用户输入的坐标。

如果此属性设置为invalidSelectionPoint()以外的值,图表会尝试在主视口内的指定坐标处选择一个数据项、轴标签或自定义项。渲染完成后,该属性将恢复为默认状态invalidSelectionPoint()

另请参阅

selectedElement

Access functions:
property slicingActiveᅟ: bool

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

如果 trueselectionMode 必须将 RowColumn 设置为有效的选择。

注意

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

Access functions:
property viewportᅟ: QRect

此属性包含一个只读属性,其中包含当前视口矩形,所有3D渲染都针对此矩形。

Access functions:
__init__([parent=None])
Parameters:

父对象QObject

构建一个包含一个光源和一个相机的基本场景。可以提供一个可选的parent参数,然后将其传递给QObject构造函数。

devicePixelRatio()
Return type:

浮点数

另请参阅

setDevicePixelRatio()

属性 devicePixelRatioᅟ 的获取器。

devicePixelRatioChanged(pixelRatio)
Parameters:

pixelRatio – 浮点数

属性 devicePixelRatioᅟ 的通知信号。

graphPositionQuery()
Return type:

QPoint

属性 graphPositionQueryᅟ 的获取器。

graphPositionQueryChanged(position)
Parameters:

位置QPoint

属性 graphPositionQueryᅟ 的通知信号。

invalidSelectionPoint()
Return type:

QPoint

返回一个表示无效选择位置的QPoint。

属性 invalidSelectionPointᅟ 的获取器。

isPointInPrimarySubView(point)
Parameters:

QPoint

Return type:

布尔

返回给定的point是否位于主子视图内。如果该点位于主子视图内,则返回true

注意

如果子视图叠加在一起,并且给定的point位于两者内部,只有当主要子视图位于顶部时,结果才是true

isPointInSecondarySubView(point)
Parameters:

QPoint

Return type:

布尔

返回给定的point是否位于次级子视图中。如果该点位于次级子视图中,则返回true

注意

如果子视图叠加在一起,并且给定的point位于两者内部,只有当次子视图位于顶部时,结果才是true

isSecondarySubviewOnTop()
Return type:

布尔

属性 secondarySubviewOnTopᅟ 的获取器。

isSlicingActive()
Return type:

布尔

属性 slicingActiveᅟ 的获取器。

needRender()
primarySubViewport()
Return type:

QRect

属性 primarySubViewportᅟ 的获取器。

primarySubViewportChanged(subViewport)
Parameters:

子视口QRect

属性 primarySubViewportᅟ 的通知信号。

secondarySubViewport()
Return type:

QRect

属性 secondarySubViewportᅟ 的获取器。

secondarySubViewportChanged(subViewport)
Parameters:

子视口QRect

属性 secondarySubViewportᅟ 的通知信号。

secondarySubviewOnTopChanged(isSecondaryOnTop)
Parameters:

isSecondaryOnTop – 布尔值

属性 secondarySubviewOnTopᅟ 的通知信号。

selectionQueryPosition()
Return type:

QPoint

属性 selectionQueryPositionᅟ 的获取器。

selectionQueryPositionChanged(position)
Parameters:

位置QPoint

属性 selectionQueryPositionᅟ 的通知信号。

setDevicePixelRatio(pixelRatio)
Parameters:

pixelRatio – 浮点数

另请参阅

devicePixelRatio()

属性 devicePixelRatioᅟ 的设置器。

setGraphPositionQuery(point)
Parameters:

QPoint

另请参阅

graphPositionQuery()

属性 graphPositionQueryᅟ 的设置器。

setPrimarySubViewport(primarySubViewport)
Parameters:

primarySubViewportQRect

另请参阅

primarySubViewport()

属性 primarySubViewportᅟ 的设置器。

setSecondarySubViewport(secondarySubViewport)
Parameters:

secondarySubViewportQRect

另请参阅

secondarySubViewport()

属性 secondarySubViewportᅟ 的设置器。

setSecondarySubviewOnTop(isSecondaryOnTop)
Parameters:

isSecondaryOnTop – 布尔值

属性 secondarySubviewOnTopᅟ 的设置器。

setSelectionQueryPosition(point)
Parameters:

QPoint

属性 selectionQueryPositionᅟ 的设置器。

setSlicingActive(isSlicing)
Parameters:

isSlicing – 布尔值

另请参阅

isSlicingActive()

属性 slicingActiveᅟ 的设置器。

slicingActiveChanged(isSlicingActive)
Parameters:

isSlicingActive – 布尔值

属性 slicingActiveᅟ 的通知信号。

viewport()
Return type:

QRect

属性 viewportᅟ 的获取器。

viewportChanged(viewport)
Parameters:

视口QRect

属性 viewportᅟ 的通知信号。