Graphs3D QML Type

Graphs3D namespace enums. More...

Import Statement: import QtGraphs

Detailed Description

The Graphs3D namespace provides the following enums used by QtGraphs' 3D API.

Graphs3D.SelectionFlag

Item selection modes. Values of this enumeration can be combined with OR operator.

ConstantDescription
NoneSelection mode disabled.
ItemSelection highlights a single item.
RowSelection highlights a single row.
ItemAndRowCombination flag for highlighting both item and row with different colors.
ColumnSelection highlights a single column.
ItemAndColumnCombination flag for highlighting both item and column with different colors.
RowAndColumnCombination flag for highlighting both row and column.
ItemRowAndColumnCombination flag for highlighting item, row, and column.
SliceSetting this mode flag indicates that the graph should take care of the slice view handling automatically. If you wish to control the slice view yourself via Q3DScene, do not set this flag. When setting this mode flag, either Row or Column must also be set, but not both. Slicing is supported by Bars3D and Surface3D only. When this flag is set, slice mode is entered in the following situations:
  • When selection is changed explicitly via series API to a visible item
  • When selection is changed by clicking on the graph
  • When the selection mode changes and the selected item is visible
MultiSeriesSetting this mode means that items for all series at same position are highlighted, instead of just the selected item. The actual selection in the other series doesn't change. When setting this mode flag, one or more of the basic selection flags (Item, Row, or Column) must also be set. Multi-series selection is not supported for Scatter3D.

Graphs3D.ShadowQuality

Quality and softness of shadows.

ConstantDescription
NoneShadows are disabled.
LowShadows are rendered in low quality.
MediumShadows are rendered in medium quality.
HighShadows are rendered in high quality.
SoftLowShadows are rendered in low quality with softened edges.
SoftMediumShadows are rendered in medium quality with softened edges.
SoftHighShadows are rendered in high quality with softened edges.

Graphs3D.ElementType

Type of an element in the graph.

ConstantDescription
NoneNo defined element.
SeriesAn item in a series.
AxisXLabelThe x-axis label.
AxisYLabelThe y-axis label.
AxisZLabelThe z-axis label.
CustomItemA custom item.

Graphs3D.OptimizationHint

The optimization hint for rendering.

ConstantDescription
DefaultProvides the full feature set with instancing at a good performance.
LegacyProvides the full feature set at a reasonable performance. To be used if OptimizationHint.Default performs poorly or does not work.

Graphs3D.CameraPreset

Predefined positions for camera.

ConstantDescription
NoPresetUsed to indicate a preset has not been set, or the scene has been rotated freely.
FrontLowBoth x and y rotations of the camera are 0.
FrontX rotation is 0 and y rotation is 22.5 degrees.
FrontHighX rotation is 0 and y rotation is 45 degrees.
LeftLowX rotation is 90 and y rotation is 0 degrees.
LeftX rotation is 90 and y rotation is 22.5 degrees.
LeftHighX rotation is 90 and y rotation is 45 degrees.
RightLowX rotation is -90 and y rotation is 0 degrees.
RightX rotation is -90 and y rotation is 22.5 degrees.
RightHighX rotation is -90 and y rotation is 45 degrees.
BehindLowX rotation is 180 and y rotation is 0 degrees.
BehindX rotation is 180 and y rotation is 22.5 degrees.
BehindHighX rotation is 180 and y rotation is 45 degrees.
IsometricLeftX rotation is 45 and y rotation is 22.5 degrees.
IsometricLeftHighX rotation is 45 and y rotation is 45 degrees.
IsometricRightX rotation is -45 and y rotation is 22.5 degrees.
IsometricRightHighX rotation is -45 and y rotation is 45 degrees.
DirectlyAboveX rotation is 0 and y rotation is 90 degrees.
DirectlyAboveCW45X rotation is -45 and y rotation is 90 degrees.
DirectlyAboveCCW45X rotation is 45 and y rotation is 90 degrees.
FrontBelowX rotation is 0 and y rotation is -45 degrees. In Bars3D from FrontBelow onward these only work for graphs including negative values. They act as CameraPreset...Low for positive-only values.
LeftBelowX rotation is 90 and y rotation is -45 degrees.
RightBelowX rotation is -90 and y rotation is -45 degrees.
BehindBelowX rotation is 180 and y rotation is -45 degrees.
DirectlyBelowX rotation is 0 and y rotation is -90 degrees. Acts as FrontLow for positive-only bars.

Graphs3D.GridLineType

ConstantDescription
ShaderGrid lines are rendered with GPU in a shader.
GeometryGrid lines are rendered with 3D models.

Graphs3D.RenderingMode

ConstantDescription
DirectToBackgroundIndicates that the graph will be rendered directly on the window background and QML items are rendered on top of it. Using non-transparent QML item as a background will hide the graph. Clears the whole window before rendering the graph, including the areas outside the graph. If the surface format of the window supports antialiasing, it will be used (see qDefaultSurfaceFormat()). This rendering mode offers the best performance at the expense of non-standard QML behavior. For example, the graphs do not obey the z ordering of QML items and the opacity value has no effect on them.
IndirectIndicates the graph will be first rendered to an offscreen surface that is then drawn during normal QML item rendering. The rendered image is antialiased using the multisampling method if it is supported in the current environment and the msaaSamples property value is greater than zero. This rendering mode offers good quality and normal QML item behavior at the expense of performance.

© 2024 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.