AbstractGraph3D QML 类型

3D可视化的基类。 更多...

导入语句import QtDataVisualization 1.7
自QtDataVisualization 1.0
继承自

Bars3D、Scatter3D 和 Surface3D

属性

方法

详细描述

QtDataVisualization 中所有 3D 可视化的基类。

此类型无法创建，但它包含 3D 可视化之间共享的属性。

参见：Bars3D，Scatter3D，Surface3D 和 Qt Data Visualization C++ 类。

属性文档

aspectRatio : 实数 [自 QtDataVisualization 1.1]

图形在水平平面上最长轴和 y 轴之间缩放的比率。默认值为 2.0。

注意：对 Bars3D 没有影响。

此属性自 QtDataVisualization 1.1 引入。

参见：horizontalAspectRatio。


currentFps : 整数 [自 QtDataVisualization 1.1]

启用 FPS 测量时，最后 1 秒钟的结果存储在此只读属性中。测量激活后，此值至少要过 1 秒钟才会更新。

此属性自 QtDataVisualization 1.1 引入。

参见：measureFps。


customItemList : 列表<Custom3DItem> [自 QtDataVisualization 1.1]

添加到图形中的 Custom3DItem 项目列表。图形会获取所添加项的所有权。

此属性自 QtDataVisualization 1.1 引入。


horizontalAspectRatio : real [自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 [自QtDataVisualization 1.2起]

设置用于格式化各种数字标签的区域设置。默认为 "C" 区域设置。

此属性自QtDataVisualization 1.2中引入。

另请参阅：ValueAxis3D::labelFormat。


margin : real [自QtDataVisualization 1.2起]

用于在可绘制的图形区域的边缘和图形背景边缘之间的空间中的绝对值。

如果边距值为负，则边距将自动确定，并可根据系列中项目的大小和图形的类型而变化。如果图形纵横比未从默认值更改，则值为y轴范围的分数。默认为 -1.0。

注意：设置比自动确定的边距小的散点图边距可能导致图例边缘的项目与图形背景重叠。

注意：在散点图和曲面图上，如果边距与轴标签大小的比较很小，则将调整轴边缘标签的位置，以避免与相邻轴的边依标签重叠。

此属性自QtDataVisualization 1.2中引入。


measureFps : bool [自QtDataVisualization 1.1起]

如果 true，则连续渲染而不是按需渲染，并更新 currentFps 属性的值。默认为 false。

此属性自 QtDataVisualization 1.1 引入。

另请参阅：currentFps。


msaaSamples : int

当渲染模式为 RenderIndirect 时，在多重采样抗锯齿中使用的样本数。当渲染模式为 RenderDirectToBackground 或 RenderDirectToBackground_NoClear 时，此属性值是只读的，并返回由窗口表面格式指定的样本数。默认为 4。

另请参阅：renderingMode。


optimizationHints : AbstractGraph3D.OptimizationHints [自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]。如果查询的位置在图形边界之外，这些值将不会反映真实位置，而是范围之外的某个未定义位置。在查询之前，该值将是未定义的。

没有单个正确的3D坐标可以匹配特定的屏幕位置，因此为了保持一致，查询始终是对围绕图形的无形框的内侧进行的。

注意：柱状图只允许在图形地板级别查询图形位置，因此柱状图的y值始终为零，并且只能在包含图形地板的屏幕位置进行有效查询。

此属性自QtDataVisualization 1.2中引入。

另请参阅：Scene3D::graphPositionQuery。


radialLabelOffset : real [since QtDataVisualization 1.2]

该属性指定了径向极坐标轴轴标签的归一化水平偏移量。值0.0表示标签应该绘制在0角度角度轴网格线的旁边。值1.0表示标签将绘制在它们通常的位置，即在图形背景的边缘。如果极坐标属性值是false，则忽略此属性。默认为1.0。

此属性自QtDataVisualization 1.2中引入。

另请参阅：polar。


反射 : 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 项添加到图中。图将获得添加项的所有权。

如果添加成功，则返回添加项的索引，如果尝试添加空项，则返回-1，如果尝试添加已添加的项，则返回该项的索引。

此方法自在QtDataVisualization 1.1中引入。

另见removeCustomItems()，removeCustomItem()和removeCustomItemAt()。


void clearSelection()

清除所有附加序列的选择。


[自6.3以来] bool hasSeries(Abstract3DSeries series)

返回序列是否已添加到图中。

此方法自在Qt 6.3以来引入。


[自QtDataVisualization 1.1以来] void releaseCustomItem(Custom3DItem item)

重新获取项的所有权并从图中删除项。

注意：如果将相同的项再次添加到图中，需要重新设置纹理文件。

此方法自在QtDataVisualization 1.1中引入。

另见Custom3DItem::textureFile。


[自QtDataVisualization 1.1以来] void removeCustomItem(Custom3DItem item)

删除自定义项。删除分配给它的资源。

此方法自在QtDataVisualization 1.1中引入。


[自QtDataVisualization 1.1以来] void removeCustomItemAt(vector3d position)

删除位于位置的所有自定义项。删除分配给它们的资源。

此方法自在QtDataVisualization 1.1中引入。


[自QtDataVisualization 1.1以来] void removeCustomItems()

删除所有自定义项。删除分配给它们的资源。

此方法自在QtDataVisualization 1.1中引入。


[自QtDataVisualization 1.1以来] Abstract3DAxis selectedAxis()

可以在收到任何带有标签类型的selectedElementChanged信号后使用，以获取所选轴。选择在下一个selectedElementChanged信号之前有效。

返回所选轴，或null。

此方法自在QtDataVisualization 1.1中引入。

另见selectedElement。


[自QtDataVisualization 1.1以来] Custom3DItem selectedCustomItem()

可以在收到selectedElementChanged信号并与ElementCustomItem类型一同选择后使用，以获取所选自定义项。项的所有权仍然属于图。选择在下一个selectedElementChanged信号之前有效。

返回所选自定义项，或null。

此方法自在QtDataVisualization 1.1中引入。

另见selectedElement。


[自QtDataVisualization 1.1以来] int selectedCustomItemIndex()

可以在收到selectedElementChanged信号并与ElementCustomItem类型一同选择后使用，以查询所选自定义项的索引。选择在下一个selectedElementChanged信号之前有效。

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

此方法自在QtDataVisualization 1.1中引入。

另见selectedElement。


[自QtDataVisualization 1.1以来] int selectedLabelIndex()

可在接收到任何标签类型的 selectedElementChanged 信号后查询所选标签的索引。选择有效，直到下一个 selectedElementChanged 信号。

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

此方法自在QtDataVisualization 1.1中引入。

另见selectedElement。


© 2024 The Qt Company Ltd。本文档中的文档贡献属于各自所有者的版权。本文档是根据自由软件基金会发布的GNU自由文档许可第1.3版条款许可的。Qt 和相应商标是芬兰及世界其他地区 The Qt Company Ltd 的商标。所有其他商标均为其各自所有者的财产。