QGraphs3D Namespace

The QGraphs3D module provides enums used by QtGraphs' 3D API. More...

Header: #include <QGraphs3D>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs

Types

enum class CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
enum class ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class OptimizationHint { Default, Legacy }
enum class SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags SelectionFlags
enum class ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }

Detailed Description

Type Documentation

enum class QGraphs3D::CameraPreset

Predefined positions for camera.

ConstantValueDescription
QGraphs3D::CameraPreset::NoPreset0Used to indicate a preset has not been set, or the scene has been rotated freely.
QGraphs3D::CameraPreset::FrontLow1 
QGraphs3D::CameraPreset::Front2 
QGraphs3D::CameraPreset::FrontHigh3 
QGraphs3D::CameraPreset::LeftLow4 
QGraphs3D::CameraPreset::Left5 
QGraphs3D::CameraPreset::LeftHigh6 
QGraphs3D::CameraPreset::RightLow7 
QGraphs3D::CameraPreset::Right8 
QGraphs3D::CameraPreset::RightHigh9 
QGraphs3D::CameraPreset::BehindLow10 
QGraphs3D::CameraPreset::Behind11 
QGraphs3D::CameraPreset::BehindHigh12 
QGraphs3D::CameraPreset::IsometricLeft13 
QGraphs3D::CameraPreset::IsometricLeftHigh14 
QGraphs3D::CameraPreset::IsometricRight15 
QGraphs3D::CameraPreset::IsometricRightHigh16 
QGraphs3D::CameraPreset::DirectlyAbove17 
QGraphs3D::CameraPreset::DirectlyAboveCW4518 
QGraphs3D::CameraPreset::DirectlyAboveCCW4519 
QGraphs3D::CameraPreset::FrontBelow20In Q3DBarsWidget from FrontBelow onward these only work for graphs including negative values. They act as Preset...Low for positive-only values.
QGraphs3D::CameraPreset::LeftBelow21 
QGraphs3D::CameraPreset::RightBelow22 
QGraphs3D::CameraPreset::BehindBelow23 
QGraphs3D::CameraPreset::DirectlyBelow24Acts as FrontLow for positive-only bars.

enum class QGraphs3D::ElementType

Type of an element in the graph.

ConstantValueDescription
QGraphs3D::ElementType::None0No defined element.
QGraphs3D::ElementType::Series1An item in a series.
QGraphs3D::ElementType::AxisXLabel2The x-axis label.
QGraphs3D::ElementType::AxisYLabel3The y-axis label.
QGraphs3D::ElementType::AxisZLabel4The z-axis label.
QGraphs3D::ElementType::CustomItem5A custom item.

enum class QGraphs3D::OptimizationHint

The optimization hint for rendering.

ConstantValueDescription
QGraphs3D::OptimizationHint::Default0Provides the full feature set with instancing at a good performance.
QGraphs3D::OptimizationHint::Legacy1Provides the full feature set at a reasonable performance. To be used if OptimizationHint.Default performs poorly or does not work.

enum class QGraphs3D::SelectionFlag
flags QGraphs3D::SelectionFlags

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

ConstantValueDescription
QGraphs3D::SelectionFlag::None0Selection mode disabled.
QGraphs3D::SelectionFlag::Item1Selection highlights a single item.
QGraphs3D::SelectionFlag::Row2Selection highlights a single row.
QGraphs3D::SelectionFlag::ItemAndRowItem | RowCombination flag for highlighting both item and row with different colors.
QGraphs3D::SelectionFlag::Column4Selection highlights a single column.
QGraphs3D::SelectionFlag::ItemAndColumnItem | ColumnCombination flag for highlighting both item and column with different colors.
QGraphs3D::SelectionFlag::RowAndColumnRow | ColumnCombination flag for highlighting both row and column.
QGraphs3D::SelectionFlag::ItemRowAndColumnItem | Row | ColumnCombination flag for highlighting item, row, and column.
QGraphs3D::SelectionFlag::Slice8Setting 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 Q3DBarsWidget and Q3DSurfaceWidget 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
QGraphs3D::SelectionFlag::MultiSeries16Setting 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 Q3DScatterWidget.

The SelectionFlags type is a typedef for QFlags<SelectionFlag>. It stores an OR combination of SelectionFlag values.

enum class QGraphs3D::ShadowQuality

Quality of shadows.

ConstantValueDescription
QGraphs3D::ShadowQuality::None0Shadows are disabled.
QGraphs3D::ShadowQuality::Low1Shadows are rendered in low quality.
QGraphs3D::ShadowQuality::Medium2Shadows are rendered in medium quality.
QGraphs3D::ShadowQuality::High3Shadows are rendered in high quality.
QGraphs3D::ShadowQuality::SoftLow4Shadows are rendered in low quality with softened edges.
QGraphs3D::ShadowQuality::SoftMedium5Shadows are rendered in medium quality with softened edges.
QGraphs3D::ShadowQuality::SoftHigh6Shadows are rendered in high quality with softened edges.