PySide6.QtGraphs.Q3DScene¶

class Q3DScene¶

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

概要¶

属性¶

devicePixelRatioᅟ - 用于将输入坐标映射到像素坐标的设备像素比
graphPositionQueryᅟ - 用户输入的坐标，应由场景处理为图形位置查询
invalidSelectionPointᅟ
primarySubViewportᅟ - 当前子视口矩形，位于视口内，用于定位图表的主要视图
secondarySubViewportᅟ - 视口内的次要视口矩形
secondarySubviewOnTopᅟ - 是否将2D切片视图或3D视图绘制在顶部
selectionQueryPositionᅟ - 用户输入的坐标，应由场景作为选择进行处理
slicingActiveᅟ - 2D切片视图当前是否处于活动状态
viewportᅟ - 一个只读属性，包含当前视口矩形，所有3D渲染都针对此视口进行

方法¶

def __init__()
def devicePixelRatio()
def graphPositionQuery()
def invalidSelectionPoint()
def isPointInPrimarySubView()
def isPointInSecondarySubView()
def isSecondarySubviewOnTop()
def isSlicingActive()
def primarySubViewport()
def secondarySubViewport()
def selectionQueryPosition()
def setDevicePixelRatio()
def setGraphPositionQuery()
def setPrimarySubViewport()
def setSecondarySubViewport()
def setSecondarySubviewOnTop()
def setSelectionQueryPosition()
def setSlicingActive()
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:

devicePixelRatio()
setDevicePixelRatio()
信号 devicePixelRatioChanged()

property graphPositionQueryᅟ: QPoint¶

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

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

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

注意

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

另请参阅

queriedGraphPosition

Access functions: