Scene3D QML Type
Scene3D 类型提供了可视化三维场景的描述。更多
| Import Statement: | import QtDataVisualization 1.9 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DScene |
属性
- activeCamera : Camera3D
- activeLight : Light3D
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
- viewport : rect
详细说明
三维场景包含一个活动相机和一个活动光源。可视化数据假定位于固定位置。
三维场景还会跟踪进行可视化渲染的视口、主三维数据可视化视图所在的视口中的主子视口以及数据的二维切片视图所在的辅助子视口。
此外，场景中还有用于跟踪辅助 2D 切片视图当前是否处于活动状态的标记。
注意： 并非所有可视化都支持辅助二维切片视图。
属性文档
devicePixelRatio : real |
将输入坐标映射到像素坐标时使用的当前设备像素比例。
graphPositionQuery : point |
用户输入的坐标，场景应将其作为图形位置查询进行处理。如果此属性设置为invalidSelectionPoint 以外的值，则图形会尝试将图形位置与主视口内的给定点相匹配。渲染结束后，该属性将返回默认状态invalidSelectionPoint 。下一次渲染结束后，可从AbstractGraph3D::queriedGraphPosition 属性中读取查询到的图形位置。
没有一个正确的三维坐标与特定的屏幕位置相匹配，因此为了保持一致，查询总是针对图形周围的一个不可见方框的内侧进行。
注意： 条形图只允许在图形底层进行图形位置查询。
invalidSelectionPoint : point |
提供无效选择点的常量属性。
primarySubViewport : rect |
数据可视化主视图所在视口中的当前子视口矩形。
如果slicingActive 是false ，主次视口将等于视口。如果slicingActive 是true ，且未明确设置主次视口，则主次视口将是视口的五分之一。
注： 设置 primarySubViewport 大于或小于视口时，视口大小也会相应调整。
secondarySubViewport : rect |
* 视口中的辅助视口矩形。辅助视口 * 在某些可视化中用于绘制二维切片视图。如果没有明确设置，它将为空。如果slicingActive 是true ，它将 * 等于视口。*
注意： 如果二级子视口大于或超出视口，视口大小将相应调整。
secondarySubviewOnTop : bool |
定义是在顶部绘制二维切片视图还是三维视图。
selectionQueryPosition : point |
用户输入的坐标，场景应将其作为选区处理。如果该属性设置为invalidSelectionPoint 以外的值，则图形会尝试在主视口内的给定点选择一个数据项。渲染结束后，该属性将返回默认状态invalidSelectionPoint 。
slicingActive : bool |
定义二维切片视图当前是否处于活动状态。如果true,AbstractGraph3D::selectionMode 必须将AbstractGraph3D.SelectionRow 或AbstractGraph3D.SelectionColumn 设置为有效选择。
注： 并非所有可视化都支持二维切片视图。
viewport : rect |
当前视口矩形，所有三维渲染都以该矩形为目标。
© 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.
