Graphs3D QML Type
Graphs3D 命名空间中的枚举。更多内容...
| Import Statement: | import QtGraphs |
- 所有成员列表，包括继承的成员
- Graphs3D 是Qt Graphs 3D QML 类型库的一部分。
详细说明
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.RenderingMode
| 常量 | 描述 |
|---|---|
DirectToBackground | 表示图表将直接渲染在窗口背景上，而 QML 项则渲染在其上方。使用不透明的 QML 项作为背景会隐藏图表。在渲染图表之前会清空整个窗口，包括图表外的区域。 如果窗口的渲染表面格式支持抗锯齿，则会启用该功能（参见QQuick3D::idealSurfaceFormat()）。此渲染模式能提供最佳性能，但会牺牲 QML 的标准行为。例如，图表不遵循 QML 项的 z 轴排序规则，且不透明度值对其无效。 |
Indirect | 表示图将首先渲染到一个离屏表面，然后在常规 QML 项渲染过程中进行绘制。如果当前环境支持多采样方法，且msaaSamples 属性值大于零，则渲染的图像将使用多采样方法进行抗锯齿处理。此渲染模式能提供良好的画质和正常的 QML 项行为，但会牺牲性能。 |
Graphs3D.TransparencyTechnique
| 常量 | 描述 |
|---|---|
Default | 表示不使用与顺序无关的透明度技术。可提供最佳性能。当图不包含透明度，或者条形图或散点图同时使用实例化（即 `optimizationHint` 为 `{QtGraphs3D::OptimizationHint::Default}`）时，请使用此选项。 |
Approximate | 表示图将尝试实现对顺序无关透明度的近似渲染。此方法比 `Accurate ` 更快，且可在较旧的硬件上运行，但可能会产生不准确的结果。当需要顺序无关透明度，但性能开销必须低于使用精确顺序无关透明度时，请使用此方法。 |
Accurate | 表示使用精确的顺序无关透明度。当需要完美的透明度渲染时使用。 |
© 2026 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.
