QAbstract3DGraph 类

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

属性文档

activeInputHandler : QAbstract3DInputHandler*

此属性包含图表中使用的活动输入处理器。

访问函数

通知信号

activeTheme : Q3DTheme*

此属性包含图表的活动主题。

将 activeTheme 设置为用于图表的活动主题。隐式调用 addTheme（）以将主题的所有权传输到此图表。

如果 activeTheme 为空，则创建一个临时默认主题。如果以后明确设置了任何主题，则销毁此临时主题。即使设置了主题，也可以修改其属性，且修改会立即生效。

访问函数

通知信号

aspectRatio : qreal

此属性表示水平平面最长轴与y轴之间的图形缩放比率。

默认值为 2.0。

访问函数

通知信号

另请参阅 horizontalAspectRatio。

cameraTargetPosition : QVector3D

此属性表示在3D空间中，摄像机目标位置的向量或顶点。

默认值为 QVector3D(0.0, 0.0, 0.0)。

有效的坐标值在 -1.0...1.0 之间，其中边缘值表示相应轴的边缘。任何超出此范围的值都会被钳位到边缘。

访问函数

通知信号

cameraXRotation : float

此属性表示摄像机围绕目标点在X轴旋转的角度（以度为单位）。

访问函数

通知信号

cameraYRotation : float

此属性表示摄像机围绕目标点在Y轴旋转的角度（以度为单位）。

访问函数

通知信号

cameraZoomLevel : float

此属性表示摄像机缩放级别（百分比）。

默认值 100.0f 表示摄像机没有设置放大或缩小。此值受限于 minCameraZoomLevel 和 maxCameraZoomLevel 属性。

访问函数

通知信号

另请参阅 minCameraZoomLevel 和 maxCameraZoomLevel。

[只读] currentFps : const int

此属性持有上一秒的渲染结果。

当启用FPS测量时，将此只读属性存储在结果中。在启动测量后，至少需要一秒才能更新此值。

访问函数

通知信号

另请参阅 measureFps。

horizontalAspectRatio : qreal

此属性表示x轴和z轴之间图形缩放的比率。

值为 0.0 表示根据轴范围自动缩放。默认为 0.0。

对Q3DBars没有影响，它通过barThickness和barSpacing属性在水平面上进行处理。极坐标图也忽略此属性。

访问函数

通知信号

另请参阅aspectRatio，polar，Q3DBars::barThickness和Q3DBars::barSpacing。

locale : QLocale

此属性保留用于格式化各种数字标签的区域设置。

默认为"C"区域设置。

访问函数

通知信号

另请参阅QValue3DAxis::labelFormat。

margin : qreal

此属性保留用于绘图区域边缘和图形背景边缘之间空间的绝对值。

如果边缘值是负数，则自动确定边缘，并可以根据系列中项目的大小和图形类型进行变化。如果图元的纵横比没有从默认值更改，则该值解释为y轴范围的分数。默认为-1.0。

访问函数

通知信号

maxCameraZoomLevel : float

此属性保留允许的最大相机缩放级别。

如果将最大级别设置为新的值，该值低于现有最小级别，则将调整最小级别以与新最大值相对应。如果当前的cameraZoomLevel在新的范围外，它将相应地进行调整。默认为500.0f。

访问函数

通知信号

另请参阅cameraZoomLevel和minCameraZoomLevel。

measureFps : bool

此属性保留渲染是否是连续的而不是按需进行的。

如果true，则渲染是连续的，并且currentFps属性的值会更新。默认为false。

访问函数

通知信号

另请参阅currentFps。

minCameraZoomLevel : float

此属性保留允许的最小相机缩放级别。

如果将最小级数设置为比现有最大级数更高的新值，则最大级数也调整为新的最小级数。如果当前缩放级数超出新界限，它也将进行调整。minCameraZoomLevel不能设置为小于1.0f。默认为10.0f。

访问函数

通知信号

另请参阅cameraZoomLevel和maxCameraZoomLevel。

msaaSamples : int

此属性包含在MSAA中使用的样本数。

将使用的MSAA样本数设置为samples。样本数可以是0、2、4或8。

访问函数

通知信号

optimizationHint : QAbstract3DGraph::OptimizationHint

此属性包含是否使用默认模式、静态模式或传统模式进行渲染优化。

默认模式使用实例化渲染，并在大多数系统上提供最佳性能水平下的完整功能集。静态模式优化图形渲染，非常适合大型不更改的数据集。对于动态数据和项目旋转的更改，速度较慢。选择未进行优化，因此不建议与大量数据集一起使用静态模式。静态优化仅在散点图中有效。传统模式单独渲染图中所有项目，不使用实例化。仅在默认模式不起作用时（即目标系统不支持实例化）才应使用。默认为默认。

访问函数

通知信号

另请参阅QAbstract3DSeries::mesh。

orthoProjection : bool

此属性包含是否使用正交投影显示图形。

默认为false。

访问函数

通知信号

另请参阅QAbstract3DAxis::labelAutoRotation。

polar : bool

此属性包含是否将水平轴更改成极坐标轴。

如果true，x轴变为角度轴，z轴变为径向轴。极坐标模式不适合条形图。

默认为false。

访问函数

通知信号

另请参阅orthoProjection和radialLabelOffset。

[只读] queriedGraphPosition : const QVector3D

此属性存储沿着每个轴的最新已查询的图位置值。

此只读属性包含 Q3DScene::graphPositionQuery 的结果。数值已归一化到 [-1, 1] 范围内。如果查询的位置超出图边界，则值将不会反映实际位置，而将指示范围外未定义的位置 [-1, 1] 之外。直到进行查询，该值将未定义。

没有单个正确的 3D 坐标与特定的屏幕位置相匹配，因此为了保持一致，查询始终针对围绕图的不可见盒子的内侧进行。

访问函数

通知信号

另请参阅Q3DScene::graphPositionQuery.

radialLabelOffset : float

此属性存储径向极坐标轴标签的归一化水平偏移量。

值 0.0 表示标签应该绘制在 0 度角度轴向网格线的旁边。值 1.0 表示标签在图背景边缘的正常位置处绘制。默认为 1.0。

如果 polar 属性值为 false，则忽略此属性。

访问函数

通知信号

另请参阅polar.

[只读] scene : Q3DScene* const

此属性存储可以用来操作场景和访问场景元素的 Q3DScene 指针。

此属性为只读。

访问函数

[只读] selectedElement : const QAbstract3DGraph::ElementType

此属性存储图中选中的元素。

可以使用此属性查询选中的元素类型。类型在新选定的元素和 selectedElementChanged 信号发出之间有效。

可以将信号用于实现自定义输入处理等，例如在 Scatter Graph 选项卡下的 Graph Gallery 示例中演示。

访问函数

通知信号

另请参阅 selectedLabelIndex()，selectedAxis()，selectedCustomItemIndex()，selectedCustomItem()，Q3DBars::selectedSeries()，Q3DScatter::selectedSeries()，Q3DSurface::selectedSeries()，以及 Q3DScene::setSelectionQueryPosition。

selectionMode : QAbstract3DGraph::SelectionFlags

项目选择模式。

是SelectionFlags的组合。默认情况下，SelectionItem。不同的图形类型支持不同的选择模式。

访问函数

通知信号

另请参阅 SelectionFlags。

shadowQuality : QAbstract3DGraph::ShadowQuality

此属性存储阴影的质量。

是ShadowQuality枚举值之一。默认情况下，Medium。

访问函数

通知信号

另请参阅 ShadowQuality。

wrapCameraXRotation : bool

此属性存储X-旋转中的最小和最大限制的行为。

如果设置为true，则相机的X-旋转从最小值包裹到最大值，从最大值包裹到最小值。如果设置为false，则相机的X-旋转限制在由最小值和最大值确定的区域。默认设置为true。

访问函数

通知信号

wrapCameraYRotation : bool

此属性存储Y-旋转中的最小和最大限制的行为。

如果设置为true，则相机器的Y-旋转从最小值包裹到最大值，从最大值包裹到最小值。如果设置为false，则相机的Y-旋转限制由最小值和最大值确定的区域。默认设置为true。

访问函数

通知信号

#include <QtGraphs/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

#include <QtGraphs/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));