GraphsItem3D QML Type

整个图形的环境光强度。该值决定了无论光线位置如何，颜色在整个图形中显示的均匀度和亮度。该值必须介于0.0 和1.0 之间。

水平面最长轴与 Y 轴之间的图形缩放比例。默认为2.0 。

另请参阅 horizontalAspectRatio 。

当前激活的摄像机预设，即Graphs3D.CameraPreset 中的一个。如果没有激活预设，则值为Graphs3D.CameraPreset.NoPreset 。

作为向量 3d 的摄像机目标。默认为vector3d(0.0, 0.0, 0.0) 。

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

摄像机围绕目标点的 X 旋转角度（以当前基准位置为起点，单位为度）。

摄像机围绕目标点的 Y 轴旋转角度（以度为单位，从当前基准位置开始）。

摄像机缩放级别（百分比）。默认值为100.0 ，表示摄像机没有缩放设置。该值受minCameraZoomLevel 和maxCameraZoomLevel 属性的限制。

另请参阅 minCameraZoomLevel 和maxCameraZoomLevel 。

启用 FPS 测量后，最后一秒的结果将存储在此只读属性中。激活测量后，该值至少需要一秒钟才能更新。

另请参阅 measureFps 。

添加到图表中的Custom3DItem 项目列表。图形拥有已添加项的所有权。

定义网格线类型是Graphs3D.GridLineType.Shader 还是Graphs3D.GridLineType.Geometry 。

该值会影响所有网格线。

另请参阅 Graphs3D.GridLineType 。

x 轴和 z 轴之间的图形缩放比例。0.0 表示根据坐标轴范围自动缩放。默认值为0.0 。

另请参阅 aspectRatio,polar,Bars3D::barThickness, 和Bars3D::barSpacing 。

该属性指定了轴标签放置的边距。

负值用于将标签置于绘图区域内，正值用于将标签置于绘图区域外。当值为负数时，将禁用标签自动旋转功能。默认值为0.1

另请参阅 QAbstract3DAxis::labelAutoAngle 。

Scene3D 中定义的环境光和镜面光的颜色。

整个图形的镜面反射光强度。该值必须介于0.0 和10.0 之间。

该值会影响Scene3D 中指定的光线。

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

另请参阅 Value3DAxis::labelFormat 。

可绘图区域边缘与图形背景边缘之间留出空间的绝对值。

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

摄像机围绕目标点的最大 X 旋转角度（单位：度）。默认值为180.0

此属性在 Qt 6.9 中引入。

摄像机围绕目标点的最大 Y 旋转角度（度）。默认值为90.0

此属性在 Qt 6.9 中引入。

设置允许的最大摄像机缩放级别。如果新的最大级别低于现有的最小级别，则最小级别也会调整为新的最大级别。如果当前的cameraZoomLevel 在新范围之外，也会进行调整。默认为500.0f 。

另请参阅 cameraZoomLevel 和minCameraZoomLevel 。

如果true ，渲染将持续进行，而不是按需进行，并且currentFps 属性的值也会更新。默认为false 。

另请参阅 currentFps 。

摄像机围绕目标点的最小 X 旋转角度（度）。默认值为-180.0

此属性在 Qt 6.9 中引入。

摄像机围绕目标点的最小 Y 旋转角度（度）。默认值为0.0

此属性在 Qt 6.9 中引入。

设置允许的最小摄像机缩放级别。如果新的最小级别高于现有的最大级别，则最大级别也会调整为新的最小级别。如果当前的cameraZoomLevel 超出了新的范围，也会进行调整。minCameraZoomLevel 不能设置为低于1.0 。默认为10.0 。

另请参阅 cameraZoomLevel 和maxCameraZoomLevel 。

当renderingMode 为Indirect 时，多采样抗锯齿中使用的采样数目。当renderingMode 为DirectToBackground 时，此属性值为只读值，并返回窗口表面格式指定的采样数目。默认值为4 。

另请参阅 renderingMode 。

指定渲染优化是使用默认模式还是传统模式。

默认模式使用实例渲染，可在大多数系统上以最佳性能提供完整的功能集。静态模式可优化图形渲染，是大型非变化数据集的理想选择。但在动态数据变化和项目旋转的情况下，该模式的运行速度较慢。选择模式未进行优化，因此不建议在海量数据集上使用静态模式。传统模式会单独渲染图形中的所有项目，而不会实例化。只有在默认模式不工作时，即目标系统不支持实例化时，才应使用该模式。默认值为Default 。

另请参见 Abstract3DSeries::mesh 和Graphs3D.OptimizationHint 。

如果true ，将使用正投影法显示图形。默认为false 。

如果设置为true ，水平轴将变为极坐标轴。x 轴变为角度轴，z 轴变为径向轴。极轴模式不适用于条形图。

默认为false 。

另请参阅 orthoProjection 和radialLabelOffset 。

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

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

另请参阅 Scene3D::graphPositionQuery 。

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

另请参阅 polar 。

图形的渲染方式。默认为Indirect 。

另请参阅 msaaSamples 和Graphs3D.RenderingMode 。

返回指向三维图形根节点的指针。使用importScene 将 3D 图形注入到单独的View3D 中时，请使用此属性：

Bars3D {
  id: bars
}
View3D {
  importScene: bars.rootNode
}

此属性在 Qt 6.9 中引入。

另请参阅 View3D 。

此输入处理程序是否允许图形旋转。

默认为true 。

Scene3D 指针，可用于操作场景和访问场景元素。

此属性为只读。

在图形中选择的元素。

该属性可用于查询所选元素类型。该类型一直有效，直到在图形中做出新的选择并发出selectedElementChanged 信号。

例如，该信号可用于实现自定义输入处理，如轴处理示例所示。

另请参阅 selectedLabelIndex(),selectedAxis(),selectedCustomItemIndex(),selectedCustomItem(),Bars3D::selectedSeries,Scatter3D::selectedSeries,Scene3D::selectionQueryPosition, 和Graphs3D.ElementType 。

此输入处理程序是否允许从图形中进行选择。

默认为true 。

图表中的活动选择模式。Graphs3D.SelectionFlag 枚举值之一。

阴影质量。Graphs3D.ShadowQuality 枚举值之一。

整个图形的阴影强度。数值越大，阴影越暗。该值必须介于0.0 和100.0 之间。

该值会影响Scene3D 中指定的光线。

图形的活动主题。

另请参阅 GraphsTheme 。

指定要使用的透明度技术。默认值为Default 。渲染透明曲面图形时，请使用Approximate 或Accurate 。

此属性在 Qt 6.9 中引入。

X 旋转中最小和最大限制的行为。默认情况下，X-rotation 从最小值包转到最大值，从最大值包转到最小值。

如果设置为true ，摄像机的 X 旋转会从最小值包络到最大值，从最大值包络到最小值。如果设置为false ，摄像机的 X 轴旋转将限制在由最小值和最大值确定的扇形范围内。

Y 轴旋转的最小值和最大值限制的行为。默认情况下，Y 轴旋转限制在最小值和最大值之间，没有任何包络。

如果true ，摄像机的 Y 轴旋转将从最小值到最大值以及从最大值到最小值进行包络。如果false ，摄像机的 Y 轴旋转将限制在由最小值和最大值确定的区域内。

缩放是否应改变摄像机目标，以便图形的缩放点在缩放后保持在同一位置。

默认为true 。

此输入处理程序是否允许图形缩放。

默认为true 。

当图形项在短时间内被点击两次时，就会发出该信号。eventPoint 信号参数包含释放事件中有关被点击点的信息，而button 是被点击的mouse button ，或触摸屏上的NoButton 。

另请参阅 QEventPoint 、Qt::MouseButtons 和TapHandler::doubleTapped 。

当执行捏合手势时，图形上点群的平移发生变化时，就会发出该信号。delta 向量给出了平移的变化。

另请参阅 PinchHandler::translationChanged 。

当parent 项目按下并保持的时间超过TapHandler::longPressThreshold 时，将发出该信号。

另请参见 TapHandler::longPressed 。

当图形接收到 mouseMove 事件时会发出该信号。mousePos 值给出了鼠标移动时的位置。

另请参见 QQuickItem::mouseMoveEvent 。

当执行捏合手势时，图形上的比例因子发生变化时，就会发出该信号。delta 值表示缩放比例的乘法变化。

另请参阅 PinchHandler::scaleChanged 。

该信号在图形项被点击一次时发出。eventPoint 信号参数包含释放事件中有关被点击点的信息，而button 是被点击的mouse button ，或触摸屏上的NoButton 。

另请参阅 QEventPoint 、Qt::MouseButtons 和TapHandler::singleTapped 。

每次图形接收到event 类型的QWheelEvent 时，即每次移动滚轮或更新滚动手势时，都会发出该信号。

另请参阅 WheelEvent 和WheelHandler::wheel 。

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

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

另请参阅 removeCustomItems()、removeCustomItem() 和removeCustomItemAt()。

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

使用point 中的视图坐标对图形元素执行拾取，选择第一个命中的项目。默认输入处理会在接收到 onTapped 事件时执行此操作。

另请参阅 selectedElement 。

从origin 开始，在direction 中对图形元素执行拾取，选择第一个命中的项目。

另请参阅 selectedElement 。

返回series 是否已添加到图形中。

取回item 的所有权，并从图中删除item 。

另请参阅 Custom3DItem::textureFile 。

取回item 的所有权，并从图形中删除item 。

另请参阅 Custom3DItem::textureFile 。

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

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

删除所有自定义项目。删除为其分配的资源。

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

返回选中的轴或空值。

另请参阅 selectedElement 。

在收到selectedElementChanged 信号后，可使用ElementType.CustomItem 类型获取选定的自定义项。项目的所有权仍归图形所有。在下一个selectedElementChanged 信号发出之前，选择有效。

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

另请参阅 selectedElement 。

在收到selectedElementChanged 信号（类型为ElementType.CustomItem ）后，可用于查询所选自定义项的索引。选择有效期至下一个selectedElementChanged 信号发出为止。

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

另请参阅 selectedElement 。

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

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

另请参阅 selectedElement 。