AbstractGraph3D QML Type
3D 可视化的基础类型。更多...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
此类型已弃用。我们强烈建议不要在新代码中使用它。
属性
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
方法
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
详细说明
QtDataVisualization 中所有 3D 可视化的基础类型。
该类型无法创建，但包含各 3D 可视化之间共有的属性。
另请参阅 Bars3D 、Scatter3D 、Surface3D 以及 Qt Data Visualization C++ Classes。
属性文档
aspectRatio : real [since QtDataVisualization 1.1]
水平平面上的最长轴与y轴之间的图表缩放比例。默认值为2.0 。
注意： 对 Bars3D无效 。
该属性自 QtDataVisualization 1.1 起引入。
另请参阅 horizontalAspectRatio 。
currentFps : int [since QtDataVisualization 1.1]
启用 FPS 测量后，过去一秒的测量结果将存储在此只读属性中。在测量激活后，该值至少需要一秒钟才会更新。
该属性自 QtDataVisualization 1.1 起引入。
另请参阅 measureFps 。
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
添加到图中的Custom3DItem 项的列表。图将接管这些已添加项的所有权。
该属性在 QtDataVisualization 1.1 中引入。
horizontalAspectRatio : real [since QtDataVisualization 1.2]
x 轴与 z 轴之间图表缩放的比例。0.0 的值表示根据轴范围自动缩放。默认值为0.0 。
注意： 此属性对 Bars3D无效， 因为 Bars3D 通过barThickness 和barSpacing 属性处理水平面的缩放。极坐标图也会忽略此属性。
该属性在 QtDataVisualization 1.2 中引入。
另请参阅 aspectRatio 、polar 、Bars3D::barThickness 以及Bars3D::barSpacing 。
inputHandler : AbstractInputHandler3D
图中使用的活动输入处理程序。您可以通过将此属性设置为 null 来禁用默认输入处理程序。
locale : locale [since QtDataVisualization 1.2]
设置用于格式化各种数字标签的区域设置。默认使用"C" 区域设置。
该属性自 QtDataVisualization 1.2 起引入。
另请参阅 ValueAxis3D::labelFormat 。
margin : real [since QtDataVisualization 1.2]
用于确定可绘制图表区域边缘与图表背景边缘之间留白区域的绝对值。
如果边距值为负数，则边距将由系统自动确定，并可能根据数据系列中数据点的大小以及图表类型而有所不同。如果图表的纵横比未从默认值进行更改，则该值将被解释为 y 轴范围的百分比。默认值为-1.0 。
注意：若 为散点图设置的 边距小于自动确定的边距，可能会导致位于图表边缘的散点与图表背景发生重叠。
注意：在 散点图和表面图中 ，如果边距相对于坐标轴标签的大小较小，则会调整坐标轴边缘标签的位置，以避免与相邻坐标轴的边缘标签重叠。
该属性自 QtDataVisualization 1.2 起引入。
measureFps : bool [since QtDataVisualization 1.1]
如果true ，则渲染将持续进行，而非按需进行，并且currentFps 属性的值也会随之更新。默认值为false 。
该属性在 QtDataVisualization 1.1 中引入。
另请参阅 currentFps 。
msaaSamples : int
当 renderingMode 为RenderIndirect 时，多采样抗锯齿所使用的采样数。当 renderingMode 为RenderDirectToBackground 或RenderDirectToBackground_NoClear 时，该属性值为只读，并返回由窗口表面格式指定的采样数。默认值为4 。
另请参阅 renderingMode 。
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
是否使用默认模式或静态模式进行渲染优化。
默认模式在合理的性能水平下提供完整的功能集。静态模式优化了图表渲染，非常适合大型且数据内容固定不变的数据集。但在数据动态变化和项目旋转时，其运行速度会变慢。由于选择功能未经过优化，因此不建议在海量数据集上使用静态模式。 静态优化仅适用于散点图。默认值为OptimizationDefault 。
注意：在 某些环境中 ，使用静态优化的庞大图表可能无法渲染，因为所有项目均通过单个绘制调用进行渲染，而不同的图形驱动程序对每次调用支持的最大顶点数各不相同。此问题主要出现在 32 位和 OpenGL ES2 平台上。 要解决此问题，请选择顶点数较少的项目网格，或使用点网格。
该属性在 QtDataVisualization 1.1 中引入。
另请参阅 Abstract3DSeries::mesh 和QAbstract3DGraph::OptimizationHint 。
orthoProjection : bool [since QtDataVisualization 1.1]
如果设置为true ，则将使用正交投影来显示图形。默认值为false 。
注意： 当设置为true 时，阴影 将被禁用。
该属性自 QtDataVisualization 1.1 起引入。
polar : bool [since QtDataVisualization 1.2]
如果true ，则水平坐标轴将变为极坐标轴。x轴变为角度轴，z轴变为半径轴。极坐标模式不适用于条形图。
默认值为false 。
该属性自 QtDataVisualization 1.2 起引入。
另请参阅 orthoProjection 和radialLabelOffset 。
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
此只读属性包含通过 `Scene3D::graphPositionQuery` 查询得到的、沿各轴的最新图表位置值。这些值已归一化至范围[-1, 1] 。如果查询的位置超出图表边界，则这些值不会反映实际位置，而是会显示为范围[-1, 1] 之外的某个未定义位置。在进行查询之前，该值将为未定义。
由于不存在与特定屏幕位置完全对应的唯一正确 3D 坐标，因此为了保持一致性，查询始终针对包围图表的不可见矩形框的内侧进行。
注意：条形图 仅允许在图表底边高度查询位置，因此条形图的 y 值始终为零，且只有包含图表底边的屏幕位置才能进行有效的查询。
该属性在 QtDataVisualization 1.2 中引入。
另请参阅 Scene3D::graphPositionQuery 。
radialLabelOffset : real [since QtDataVisualization 1.2]
该属性指定径向极坐标轴上轴标签的归一化水平偏移量。值0.0 表示应将标签绘制在0角的角轴网格线旁边。值1.0 表示将标签绘制在其通常的位置——即图表背景的边缘。如果polar属性的值为false ，则该属性将被忽略。默认值为1.0 。
该属性自 QtDataVisualization 1.2 起引入。
另请参阅 polar 。
reflection : bool [since QtDataVisualization 1.2]
开启或关闭地面反射。默认值为false 。
注意： 仅影响 Bars3D。但在同时包含正值和负值的 Bars3D 图表中，对于与底面相交的自定义项目，不支持镜像效果。在这种情况下，应关闭镜像效果以避免渲染错误。
该属性在 QtDataVisualization 1.2 中引入。
另请参阅 reflectivity 。
reflectivity : real [since QtDataVisualization 1.2]
设置地板的反射率。数值越大，地板的反射率越高。有效范围为[0...1] 。默认值为0.5 。
注意： 仅影响 Bars3D。
该属性于 QtDataVisualization 1.2 版本中引入。
另请参阅 reflection 。
scene : Scene3D
Scene3D 指针，可用于操作场景并访问场景元素，例如活动摄像机。
该属性为只读。
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
图中选中的元素。
该属性可用于查询所选元素的类型。该类型在图表中进行新选择并触发selectedElementChanged 信号之前一直有效。
该信号可用于实现自定义输入处理，如“轴处理”示例所示。
该属性在 QtDataVisualization 1.1 中引入。
另请参阅 selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Bars3D::selectedSeries 、Scatter3D::selectedSeries 、Scene3D::selectionQueryPosition 以及QAbstract3DGraph::ElementType 。
selectionMode : AbstractGraph3D.SelectionMode
可视化中的活动选择模式。属于QAbstract3DGraph::SelectionFlag 枚举值之一。
另请参阅 QAbstract3DGraph::SelectionFlag 。
shadowQuality : AbstractGraph3D.ShadowQuality
阴影质量。QAbstract3DGraph::ShadowQuality 枚举值之一。
另请参阅 QAbstract3DGraph::ShadowQuality 。
shadowsSupported : bool
此只读属性用于指示当前配置是否支持阴影。OpenGL ES2 配置不支持阴影。
theme : Theme3D
图表的当前主题。
另请参阅 Theme3D 。
方法文档
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
将 Custom3DItemitem 添加到图形中。图形将拥有该添加项的所有权。
若添加成功，则返回所添加项的索引；若尝试添加空项，则返回 -1；若尝试添加已存在的项，则返回该项的索引。
此方法在 QtDataVisualization 1.1 中引入。
另请参阅 removeCustomItems()、removeCustomItem() 和removeCustomItemAt()。
void clearSelection()
清除所有关联系列中的选定内容。
[since 6.3] bool hasSeries(Abstract3DSeries series)
返回series 是否已添加到图中。
该方法在 Qt 6.3 中引入。
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
取回item 的所有权，并将item 从图中移除。
注意：如果 将同一项重新添加到图表中，则需要重新设置纹理文件。
此方法在 QtDataVisualization 1.1 中引入。
另请参阅 Custom3DItem::textureFile 。
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
移除自定义的item 。删除分配给它的资源。
该方法自 QtDataVisualization 1.1 起引入。
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
删除位于position 下的所有自定义项。并释放分配给这些项的资源。
该方法自 QtDataVisualization 1.1 版本起引入。
[since QtDataVisualization 1.1] void removeCustomItems()
删除所有自定义项。释放分配给这些项的资源。
该方法在 QtDataVisualization 1.1 中引入。
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
可用于在接收到selectedElementChanged 信号后获取所选轴，该信号的标签类型不限。选定状态有效直至接收到下一个selectedElementChanged 信号。
返回所选轴，或返回 null。
该方法自 QtDataVisualization 1.1 起引入。
另请参阅 selectedElement 。
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
可在接收类型为ElementCustomItem 的selectedElementChanged 信号后，用于获取所选的自定义项。该项的所有权仍归图所有。选中状态有效直至下一个selectedElementChanged 信号触发。
返回所选的自定义项，或返回 null。
此方法在 QtDataVisualization 1.1 中引入。
另请参阅 selectedElement 。
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
可在接收到类型为ElementCustomItem 的selectedElementChanged 信号后，用于查询所选自定义项的索引。该选择在收到下一个selectedElementChanged 信号之前一直有效。
返回所选自定义项的索引，或返回 -1。
该方法在 QtDataVisualization 1.1 中引入。
另请参阅 selectedElement 。
[since QtDataVisualization 1.1] int selectedLabelIndex()
可在接收到selectedElementChanged 信号后，用于查询所选标签的索引，该信号可为任意标签类型。选定状态有效直至下一个selectedElementChanged 信号发出。
返回所选标签的索引，或 -1。
该方法在 QtDataVisualization 1.1 中引入。
另请参阅 selectedElement 。
© 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.
