PySide6.QtGraphs.Q3DScene¶
- class Q3DScene¶
Q3DScene
类提供了正在可视化的3D场景的描述。更多…概要¶
属性¶
devicePixelRatioᅟ
- 用于将输入坐标映射到像素坐标的设备像素比graphPositionQueryᅟ
- 用户输入的坐标,应由场景处理为图形位置查询primarySubViewportᅟ
- 当前子视口矩形,位于视口内,用于定位图表的主要视图secondarySubViewportᅟ
- 视口内的次要视口矩形secondarySubviewOnTopᅟ
- 是否将2D切片视图或3D视图绘制在顶部selectionQueryPositionᅟ
- 用户输入的坐标,应由场景作为选择进行处理slicingActiveᅟ
- 2D切片视图当前是否处于活动状态viewportᅟ
- 一个只读属性,包含当前视口矩形,所有3D渲染都针对此视口进行
方法¶
def
__init__()
def
viewport()
信号¶
注意
本文档可能包含从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:
此属性保存用户输入的坐标,这些坐标应由场景处理为图形位置查询。
如果此属性设置为除
invalidSelectionPoint()
以外的值,图形会尝试将图形位置与主视口内的指定坐标匹配。在渲染过程之后,此属性将返回到其默认状态invalidSelectionPoint()
。查询的图形位置可以在下一次渲染过程后从queriedGraphPosition
属性中读取。没有单一的3D坐标来匹配特定的屏幕位置,因此为了保持一致,查询总是针对围绕图形的不可见盒子的内侧面进行。
- Access functions:
- Access functions:
此属性保存视口内当前子视口矩形,其中图形的初始视图是目标。
如果主次视口未明确设置,它将是
viewport()
的五分之一。注意
将primarySubViewport设置为大于或超出视口时,视口会相应调整大小。
- Access functions:
此属性保存视口内的辅助视口矩形。
辅助视口用于在某些图表中绘制2D切片视图。如果未明确设置,它将等于视口的大小。
注意
如果次级子视口大于或超出视口,视口将相应调整大小。
- Access functions:
- property secondarySubviewOnTopᅟ: bool¶
此属性决定是2D切片视图还是3D视图绘制在顶部。
- Access functions:
此属性保存应由场景作为选择处理的用户输入的坐标。
如果此属性设置为
invalidSelectionPoint()
以外的值,图表会尝试在主视口内的指定坐标处选择一个数据项、轴标签或自定义项。渲染完成后,该属性将恢复为默认状态invalidSelectionPoint()
。另请参阅
- Access functions:
- property slicingActiveᅟ: bool¶
此属性表示2D切片视图当前是否处于活动状态。
如果
true
,selectionMode
必须将Row
或Column
设置为有效的选择。注意
并非所有图表都支持2D切片视图。
- Access functions:
此属性包含一个只读属性,其中包含当前视口矩形,所有3D渲染都针对此矩形。
- Access functions:
构建一个包含一个光源和一个相机的基本场景。可以提供一个可选的
parent
参数,然后将其传递给QObject构造函数。- devicePixelRatio()¶
- Return type:
浮点数
属性
devicePixelRatioᅟ
的获取器。- devicePixelRatioChanged(pixelRatio)¶
- Parameters:
pixelRatio – 浮点数
属性
devicePixelRatioᅟ
的通知信号。属性
graphPositionQueryᅟ
的获取器。属性
graphPositionQueryᅟ
的通知信号。返回一个表示无效选择位置的QPoint。
属性
invalidSelectionPointᅟ
的获取器。返回给定的
point
是否位于主子视图内。如果该点位于主子视图内,则返回true
。注意
如果子视图叠加在一起,并且给定的
point
位于两者内部,只有当主要子视图位于顶部时,结果才是true
。返回给定的
point
是否位于次级子视图中。如果该点位于次级子视图中,则返回true
。注意
如果子视图叠加在一起,并且给定的
point
位于两者内部,只有当次子视图位于顶部时,结果才是true
。- isSecondarySubviewOnTop()¶
- Return type:
布尔
属性
secondarySubviewOnTopᅟ
的获取器。- isSlicingActive()¶
- Return type:
布尔
属性
slicingActiveᅟ
的获取器。- needRender()¶
属性
primarySubViewportᅟ
的获取器。属性
primarySubViewportᅟ
的通知信号。属性
secondarySubViewportᅟ
的获取器。属性
secondarySubViewportᅟ
的通知信号。- secondarySubviewOnTopChanged(isSecondaryOnTop)¶
- Parameters:
isSecondaryOnTop – 布尔值
属性
secondarySubviewOnTopᅟ
的通知信号。属性
selectionQueryPositionᅟ
的获取器。属性
selectionQueryPositionᅟ
的通知信号。- setDevicePixelRatio(pixelRatio)¶
- Parameters:
pixelRatio – 浮点数
另请参阅
属性
devicePixelRatioᅟ
的设置器。属性
graphPositionQueryᅟ
的设置器。属性
primarySubViewportᅟ
的设置器。属性
secondarySubViewportᅟ
的设置器。- setSecondarySubviewOnTop(isSecondaryOnTop)¶
- Parameters:
isSecondaryOnTop – 布尔值
属性
secondarySubviewOnTopᅟ
的设置器。属性
selectionQueryPositionᅟ
的设置器。- setSlicingActive(isSlicing)¶
- Parameters:
isSlicing – 布尔值
另请参阅
属性
slicingActiveᅟ
的设置器。- slicingActiveChanged(isSlicingActive)¶
- Parameters:
isSlicingActive – 布尔值
属性
slicingActiveᅟ
的通知信号。属性
viewportᅟ
的获取器。属性
viewportᅟ
的通知信号。