Scene3D QML Type (Uncreatable)
Scene3D 类型用于描述正在可视化的 3D 场景。更多内容...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
注意：这是一个不可创建的类型。无法在 QML 中对其进行实例化。
- 所有成员列表（包括继承的成员）
- Scene3D 属于Qt Graphs 3D QML类型。
属性
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
信号
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
详细说明
该3D场景包含一个活动摄像机和一个活动光源。假设可视化数据位于固定位置。
该 3D 场景还会跟踪用于图形渲染的视口、视口内用于显示主 3D 图形视图的主子视口，以及用于显示数据 2D 切片视图的辅助子视口。
此外，该场景还设有标志，用于跟踪次要的 2D 切片视图当前是否处于活动状态。
注意：并非 所有图都支持辅助 2D 切片视图。
属性文档
devicePixelRatio : real
将输入坐标映射到像素坐标时所使用的当前设备像素比例。
graphPositionQuery : point
应由场景作为图位置查询进行处理的用户输入坐标。如果此属性设置为invalidSelectionPoint 以外的值，则图会尝试将图位置与主视口内的给定点进行匹配。 渲染通过后，该属性将恢复为默认状态invalidSelectionPoint 。在下次渲染通过后，可从GraphsItem3D::queriedGraphPosition 属性中读取查询到的图形位置。
由于不存在与特定屏幕位置完全对应的单一正确 3D 坐标，因此为了保持一致性，查询始终针对包围图表的不可见框体的内侧进行。
注意：条形图 仅允许在图表底边高度进行位置查询。
另请参阅 GraphsItem3D::queriedGraphPosition 。
invalidSelectionPoint : point [read-only]
一个常量属性，用于提供一个无效的选点。
primarySubViewport : rect
视口内当前的子视口矩形，图表的主视图即以此为目标。
如果未显式设置主子视口，则其大小将为视口的五分之一。
注意：若将 primarySubViewport设置为 大于或超出视口范围，视口会相应调整大小。
secondarySubViewport : rect
辅助视口用于在某些图中绘制 2D 切片视图。如果未显式设置，其大小将与主视口相同。
注意：如果 辅助子视口大于视口或超出视口范围，则视口会相应地调整大小。
secondarySubviewOnTop : bool
用于指定是将 2D 切片视图还是 3D 视图绘制在最上方。
selectionQueryPosition : point
应由场景作为选择范围处理的用户输入坐标。如果此属性设置为invalidSelectionPoint 以外的值，则图形会尝试在主视口内的指定位置选择一个数据项。渲染完成后，该属性将恢复为其默认状态invalidSelectionPoint 。
slicingActive : bool
用于指定当前是否启用了 2D 切片视图。如果true ，则 Graphs3D::selectionMode 的Graphs3D.SelectionRow 或Graphs3D.SelectionColumn 必须设置为一个有效的选择项。
注意：并非 所有图都支持 2D 切片视图。
信号文档
devicePixelRatioChanged(qreal pixelRatio)
当devicePixelRatio 变为pixelRatio 时，将触发此信号。
注意： 相应的处理程序 是onDevicePixelRatioChanged 。
graphPositionQueryChanged(point position)
当graphPositionQuery 变为position 时，会触发此信号。
注意： 相应的处理程序 是onGraphPositionQueryChanged 。
primarySubViewportChanged(rect subViewport)
当primarySubViewport 变为subViewport 时，会触发此信号。
注意： 相应的处理程序 是onPrimarySubViewportChanged 。
secondarySubViewportChanged(rect subViewport)
当secondarySubViewport 变为subViewport 时，会触发此信号。
注意： 相应的处理程序 为onSecondarySubViewportChanged 。
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
当secondarySubviewOnTop 变为isSecondaryOnTop 时，会触发此信号。
注意： 相应的处理程序 是onSecondarySubviewOnTopChanged 。
selectionQueryPositionChanged(point position)
当selectionQueryPosition 变为position 时，会发出此信号。
注意： 相应的处理程序 为onSelectionQueryPositionChanged 。
slicingActiveChanged(bool isSlicingActive)
当slicingActive 变更为isSlicingActive 时，会触发此信号。
注意： 相应的处理程序 是onSlicingActiveChanged 。
viewportChanged(rect viewport)
当视口切换至viewport 时，会触发此信号。
注意： 相应的处理程序 为onViewportChanged 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
