AbstractGraph3D QML Type

三维可视化的基本类型。更多

Import Statement: import QtDataVisualization 1.9
Since: QtDataVisualization 1.0
Inherited By:

Bars3D, Scatter3D, and Surface3D

属性

方法

详细说明

QtDataVisualization 中所有三维可视化的基础类型。

该类型不可创建,但包含三维可视化之间共享的属性。

另请参阅 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 没有影响,它通过barThicknessbarSpacing 属性处理水平面的缩放。极坐标图也忽略此属性。

此属性在 QtDataVisualization 1.2 中引入。

另请参见 aspectRatio,polar,Bars3D::barThickness, 和Bars3D::barSpacing


inputHandler : AbstractInputHandler3D

图形中使用的活动输入处理程序。通过将此属性设置为空,可以禁用默认输入处理程序。


locale : locale [since QtDataVisualization 1.2]

设置用于格式化各种数字标签的本地语言。默认为"C" locale。

此属性在 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 为RenderDirectToBackgroundRenderDirectToBackground_NoClear 时,此属性值为只读,并返回窗口表面格式指定的样本数。默认值为4

另请参阅 renderingMode


optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]

渲染优化使用默认模式还是静态模式。

默认模式以合理的性能水平提供完整的功能集。静态模式可优化图形渲染,是大型非变化数据集的理想选择。但在动态数据变化和项目旋转时,速度会变慢。选择模式未进行优化,因此不建议在使用大量数据集时使用静态模式。静态优化仅适用于散点图。默认为OptimizationDefault

注意: 在某些环境下,使用静态优化的大型图形可能无法渲染,因为所有项目都是通过单次绘制调用渲染的,而不同的图形驱动程序支持不同的每次调用最大顶点数。这个问题主要出现在 32 位和 OpenGL ES2 平台上。要解决这个问题,可以选择顶点数较少的项目网格或使用点网格。

此属性在 QtDataVisualization 1.1 中引入。

另请参见 Abstract3DSeries::meshQAbstract3DGraph::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 中引入。

另请参阅 orthoProjectionradialLabelOffset


queriedGraphPosition : vector3d [since QtDataVisualization 1.2]

此只读属性包含使用Scene3D::graphPositionQuery 查询到的沿各轴的最新图形位置值。这些值被归一化为[-1, 1] 。如果所查询的位置超出了图形边界,则该值将不反映真实位置,而是在[-1, 1] 范围之外的某个未定义位置。在进行查询之前,该值都是未定义的。

没有一个正确的三维坐标与特定的屏幕位置相匹配,因此为了保持一致,查询总是针对图形周围的一个不可见方框的内侧进行。

注意: 条形图只允许在图形底层查询图形位置,因此条形图的 y 值始终为零,并且只能在包含图形底层的屏幕位置进行有效查询。

此属性在 QtDataVisualization 1.2 中引入。

另请参阅 Scene3D::graphPositionQuery


radialLabelOffset : real [since QtDataVisualization 1.2]

该属性指定径向极轴的轴标签的归一化水平偏移。0.0 表示标签应绘制在 0 角网格线旁边。1.0 表示标签绘制在图形背景边缘的常规位置。如果极坐标属性值为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)

向图表添加Custom3DItem item 。图形拥有添加项的所有权。

如果添加成功,则返回已添加项的索引;如果试图添加一个空项,则返回-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()

可用于在接收到selectedElementChanged 信号后获取所选的自定义项目,信号类型为ElementCustomItem 。项目的所有权仍归图表所有。选择有效期至下一个selectedElementChanged 信号发出为止。

返回选中的自定义项或 null。

此方法在 QtDataVisualization 1.1 中引入。

另请参阅 selectedElement


[since QtDataVisualization 1.1] int selectedCustomItemIndex()

在接收到selectedElementChanged 信号(类型为ElementCustomItem )后,可用于查询所选自定义项的索引。选择有效期至下一个selectedElementChanged 信号发出。

返回所选自定义项的索引或-1。

此方法在 QtDataVisualization 1.1 中引入。

另请参阅 selectedElement


[since QtDataVisualization 1.1] int selectedLabelIndex()

可用于在接收到selectedElementChanged 信号后查询所选标签的索引,标签类型不限。选择有效期至下一个selectedElementChanged 信号发出。

返回选中标签的索引或-1。

此方法在 QtDataVisualization 1.1 中引入。

另请参阅 selectedElement


© 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.