Scene3D QML Type
Scene3D 类型提供了可视化三维场景的描述。更多
| 导入声明： | import QtGraphs |
| 在 C++ 中： | Q3DScene |
- 所有成员（包括继承成员）的列表
- Scene3D 是Qt Graphs QML Types for 3D 的一部分。
属性
- 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)
详细说明
三维场景包含一个活动相机和一个活动光源。可视化数据假定位于固定位置。
三维场景还会跟踪进行图形渲染的视口、主三维图形视图所在的视口中的主子视口以及数据的二维切片视图所在的辅助子视口。
此外，该场景还有一个标记，用于跟踪辅助二维切片视图当前是否处于活动状态。
注意： 并非所有图形都支持辅助二维切片视图。
财产文件
设备像素比例： real |
将输入坐标映射到像素坐标时使用的当前设备像素比例。
graphPositionQuery： point |
用户输入的坐标，场景应将其作为图形位置查询进行处理。如果此属性设置为invalidSelectionPoint 以外的值，则图形会尝试将图形位置与主视口内的给定点相匹配。渲染结束后，该属性将返回默认状态invalidSelectionPoint 。下一次渲染结束后，可从GraphsItem3D::queriedGraphPosition 属性中读取查询到的图形位置。
没有一个正确的三维坐标可以与特定的屏幕位置相匹配，因此为了保持一致，查询总是针对图形周围的一个不可见方框的内侧进行。
注意： 条形图只允许在图形底层查询图形位置。
invalidSelectionPoint： point |
一个常量属性，提供一个无效的选择点。
primarySubViewport： rect |
视口中的当前子视口矩形，图形的主视口在此。
如果未明确设置主次视口，则该矩形将是视口的五分之一。
注意： 设置 primarySubViewport 大于或超出视口时，视口大小也会相应调整。
secondarySubViewport： rect |
辅助视口用于在某些图形中绘制二维切片视图。如果没有明确设置，它将等于视口的大小。
注意： 如果辅助子视口大于或超出视口，则会相应地调整视口大小。
secondarySubviewOnTop： bool |
定义是在顶部绘制二维切片视图还是三维视图。
selectionQueryPosition： point |
用户输入的坐标，场景应将其作为选择项处理。如果该属性设置为invalidSelectionPoint 以外的值，则图形会尝试在主视口内的给定点选择一个数据项。渲染结束后，该属性将返回默认状态invalidSelectionPoint 。
slicingActive： bool |
定义二维切片视图当前是否处于活动状态。如果true ，Graphs3D::selectionMode 必须将Graphs3D.SelectionRow 或Graphs3D.SelectionColumn 设置为有效选择。
注意： 并非所有图形都支持二维切片视图。
信号文件
devicePixelRatioChanged(qreal pixelRatio) |
当devicePixelRatio 更改为pixelRatio 时会发出该信号。
注： 相应的处理程序是onDevicePixelRatioChanged 。
graphPositionQueryChanged(point位置） |
当graphPositionQuery 更改为position 时会发出该信号。
注： 相应的处理程序是onGraphPositionQueryChanged 。
primarySubViewportChanged(rect子视口) |
当primarySubViewport 更改为subViewport 时会发出该信号。
注： 相应的处理程序是onPrimarySubViewportChanged 。
secondarySubViewportChanged(rect次视口) |
当secondarySubViewport 更改为subViewport 时会发出该信号。
注： 相应的处理程序是onSecondarySubViewportChanged 。
secondarySubviewOnTopChanged(boolisSecondaryOnTop) |
当secondarySubviewOnTop 更改为isSecondaryOnTop 时会发出该信号。
注： 相应的处理程序是onSecondarySubviewOnTopChanged 。
selectionQueryPositionChanged(point位置） |
当selectionQueryPosition 更改为position 时会发出该信号。
注： 相应的处理程序是onSelectionQueryPositionChanged 。
slicingActiveChanged(boolisSlicingActive) |
当slicingActive 更改为isSlicingActive 时会发出该信号。
注： 相应的处理程序是onSlicingActiveChanged 。
viewportChanged(rectviewport) |
视口更改为viewport 时发出此信号。
注： 相应的处理程序是onViewportChanged 。
© 2025 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.
