Graphs3D QML Type
Graphs3D 命名空间枚举。更多
| Import Statement: | import QtGraphs |
- 所有成员（包括继承成员）的列表
- Graphs3D 是Qt Graphs QML Types for 3D 的一部分。
详细说明
Graphs3D 命名空间提供了QtGraphs' 3D API 使用的以下枚举。
Graphs3D.SelectionFlag
项目选择模式。此枚举的值可与 OR 运算符结合使用。
| 常量 | 说明 |
|---|---|
None | 禁用选择模式。 |
Item | 选择突出显示单个项目。 |
Row | 选择突出显示单行。 |
ItemAndRow | 组合标记用于用不同颜色高亮显示项目和行。 |
Column | 选择突出显示单列。 |
ItemAndColumn | 以不同颜色突出显示项和列的组合标记。 |
RowAndColumn | 高亮显示行和列的组合标记。 |
ItemRowAndColumn | 组合标记用于突出显示项、行和列。 |
Slice | 设置该模式标记表示图形应自动处理切片视图。如果希望通过Q3DScene 自行控制切片视图，请不要设置此标记。设置此模式标志时，必须同时设置Row 或Column ，但不能同时设置。切片模式仅由Bars3D 和Surface3D 支持。设置此标记后，在以下情况下将进入切片模式：
|
MultiSeries | 设置该模式意味着同一位置的所有系列的项目都会突出显示，而不仅仅是选中的项目。其他序列中的实际选择不会改变。设置该模式标记时，必须同时设置一个或多个基本选择标记（Item,Row, 或Column ）。Scatter3D 不支持多序列选择。 |
Graphs3D.ShadowQuality 阴影质量
阴影的质量和柔和度。
| 常量 | 说明 |
|---|---|
None | 禁用阴影。 |
Low | 以低质量渲染阴影。 |
Medium | 阴影以中等质量呈现。 |
High | 阴影以高质量渲染。 |
SoftLow | 阴影以软化边缘的低质量渲染。 |
SoftMedium | 阴影以中等质量渲染，边缘柔化。 |
SoftHigh | 阴影以软化边缘的高质量渲染。 |
Graphs3D.ElementType
图形中元素的类型。
| 常量 | 说明 |
|---|---|
None | 未定义元素。 |
Series | 系列中的一个项目。 |
AxisXLabel | x 轴标签。 |
AxisYLabel | y 轴标签 |
AxisZLabel | z 轴标签 |
CustomItem | 自定义项 |
Graphs3D.OptimizationHint 优化提示
渲染的优化提示。
| 常量 | 说明 |
|---|---|
Default | 以良好的性能提供具有实例化功能的完整功能集。 |
Legacy | 以合理的性能提供完整的功能集。在 OptimizationHint.Default 性能较差或无法正常工作时使用。 |
Graphs3D.CameraPreset
预定义的相机位置。
| 常量 | 说明 |
|---|---|
NoPreset | 用于表示未设置预置或场景已自由旋转。 |
FrontLow | 摄像机的 X 和 Y 轴旋转均为 0。 |
Front | X 旋转角度为 0，Y 旋转角度为 22.5 度。 |
FrontHigh | X 旋转为 0，Y 旋转为 45 度。 |
LeftLow | X 旋转 90 度，Y 旋转 0 度。 |
Left | X 旋转 90 度，Y 旋转 22.5 度。 |
LeftHigh | X 旋转 90 度，Y 旋转 45 度。 |
RightLow | X 旋转为 -90，Y 旋转为 0 度。 |
Right | X 旋转为 -90，Y 旋转为 22.5 度。 |
RightHigh | X 旋转为 -90，Y 旋转为 45 度。 |
BehindLow | X 旋转 180，Y 旋转 0 度。 |
Behind | X 旋转 180，Y 旋转 22.5 度。 |
BehindHigh | X 旋转 180 度，Y 旋转 45 度。 |
IsometricLeft | X 旋转 45 度，Y 旋转 22.5 度。 |
IsometricLeftHigh | X 旋转 45 度，Y 旋转 45 度。 |
IsometricRight | X 旋转为 -45，Y 旋转为 22.5 度。 |
IsometricRightHigh | X 轴旋转为 -45，Y 轴旋转为 45 度。 |
DirectlyAbove | X 轴旋转为 0，Y 轴旋转为 90 度。 |
DirectlyAboveCW45 | X 旋转为 -45，Y 旋转为 90 度。 |
DirectlyAboveCCW45 | X 旋转 45 度，Y 旋转 90 度。 |
FrontBelow | X 轴旋转为 0，Y 轴旋转为 -45 度。在Bars3D FrontBelow 以后的版本中，这些参数仅适用于包含负值的图形。它们的作用与 CameraPreset...Low 相同，仅适用于正值。 |
LeftBelow | X 旋转 90 度，Y 旋转 -45 度。 |
RightBelow | X 轴旋转 90 度，Y 轴旋转 -45 度。 |
BehindBelow | X 旋转 180 度，Y 旋转 -45 度。 |
DirectlyBelow | X 轴旋转为 0，Y 轴旋转为 -90 度。对于纯正条形图，作用与 FrontLow 相同。 |
Graphs3D.GridLineType（网格线类型
| 常量 | 说明 |
|---|---|
Shader | 网格线在着色器中通过 GPU 渲染。 |
Geometry | 网格线与 3D 模型一起渲染。 |
Graphs3D.渲染模式
| 常量 | 说明 |
|---|---|
DirectToBackground | 表示图形将直接渲染在窗口背景上，而 QML 项则渲染在其顶部。使用非透明的 QML 项作为背景将隐藏图形。在渲染图形前清除整个窗口，包括图形以外的区域。如果窗口的表面格式支持抗锯齿，则会使用抗锯齿（请参阅QQuick3D::idealSurfaceFormat() ）。这种渲染模式提供了最佳性能，但却牺牲了非标准的 QML 行为。例如，图形不遵守 QML 项的 Z 排序，不透明度值对图形也没有影响。 |
Indirect | 表示图形将首先渲染到屏幕外表面，然后在正常的 QML 项目渲染过程中绘制。如果当前环境支持多采样方法，且msaaSamples 属性值大于零，则会使用多采样方法对渲染图像进行抗锯齿处理。这种渲染模式提供了良好的质量和正常的 QML 项目行为，但牺牲了性能。 |
Graphs3D.TransparencyTechnique（图形透明技术
| 常量 | 说明 |
|---|---|
Default | 表示不使用与顺序无关的透明技术。提供最佳性能。当图形不包含透明度或条形图或散点图也使用实例化时使用，即optimizationHint为 {QtGraphs3D::OptimizationHint::Default}。 |
Approximate | 表示图形尝试近似与阶无关的透明度。这种方法比Accurate 更快，而且可以在较旧的硬件上运行，但可能产生不准确的结果。当需要与阶次无关的透明度，但性能成本必须低于使用精确的与阶次无关的透明度时，可以使用这种方法。 |
Accurate | 表示使用与阶次无关的精确透明度。在需要完美的透明度渲染时使用。 |
注： 精确透明度尚未实现，将在QtQuick3D 中添加所需功能后启用。
© 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.
