QtGraphs3D Namespace

Das Modul „QtGraphs3D“ stellt Aufzählungslisten bereit, die von der 3D-API von „ QtGraphs “ verwendet werden. Mehr dazu...

Header:	`#include <qgraphs3dnamespace.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`

Veraltete Mitglieder
QtGraphs3D ist Teil von „Qt Graphs “ – C++-Klassen für 3D.

Typen

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
`(since 6.12)` enum class	DragMode { Rotate, Pan }
enum class	ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class	GridLineType { Shader, Geometry }
enum class	OptimizationHint { Default, Legacy }
enum class	RenderingMode { DirectToBackground, Indirect }
enum class	SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags	SelectionFlags
enum class	ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }
`(since 6.10)` enum class	SliceCaptureType { NoImage, RowImage, ColumnImage }
`(since 6.9)` enum class	TransparencyTechnique { Default, Approximate, Accurate }

Ausführliche Beschreibung

Typdokumentation

enum class QtGraphs3D::CameraPreset

Vordefinierte Positionen für die Kamera.

Konstante	Wert	Beschreibung
`QtGraphs3D::CameraPreset::NoPreset`	`0`	Wird verwendet, um anzuzeigen, dass keine Voreinstellung festgelegt wurde oder die Szene frei gedreht wurde.
`QtGraphs3D::CameraPreset::FrontLow`	`1`	Sowohl die x- als auch die y-Drehung der Kamera betragen 0.
`QtGraphs3D::CameraPreset::Front`	`2`	Die X-Drehung beträgt 0 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::FrontHigh`	`3`	Die X-Drehung beträgt 0 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::LeftLow`	`4`	Die X-Drehung beträgt 90 und die Y-Drehung 0 Grad.
`QtGraphs3D::CameraPreset::Left`	`5`	Die X-Drehung beträgt 90 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::LeftHigh`	`6`	Die X-Drehung beträgt 90 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::RightLow`	`7`	Die X-Drehung beträgt -90 und die Y-Drehung 0 Grad.
`QtGraphs3D::CameraPreset::Right`	`8`	Die X-Drehung beträgt -90 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::RightHigh`	`9`	Die X-Drehung beträgt -90 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::BehindLow`	`10`	Die X-Drehung beträgt 180 und die Y-Drehung 0 Grad.
`QtGraphs3D::CameraPreset::Behind`	`11`	Die X-Drehung beträgt 180 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::BehindHigh`	`12`	Die X-Drehung beträgt 180 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::IsometricLeft`	`13`	Die X-Drehung beträgt 45 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::IsometricLeftHigh`	`14`	Die X-Drehung beträgt 45 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::IsometricRight`	`15`	Die X-Drehung beträgt -45 und die Y-Drehung 22,5 Grad.
`QtGraphs3D::CameraPreset::IsometricRightHigh`	`16`	Die X-Drehung beträgt -45 und die Y-Drehung 45 Grad.
`QtGraphs3D::CameraPreset::DirectlyAbove`	`17`	Die X-Drehung beträgt 0 und die Y-Drehung 90 Grad.
`QtGraphs3D::CameraPreset::DirectlyAboveCW45`	`18`	Die X-Drehung beträgt -45 und die Y-Drehung 90 Grad.
`QtGraphs3D::CameraPreset::DirectlyAboveCCW45`	`19`	Die X-Drehung beträgt 45 und die Y-Drehung 90 Grad.
`QtGraphs3D::CameraPreset::FrontBelow`	`20`	Die X-Drehung beträgt 0 und die Y-Drehung -45 Grad. In „ Q3DBarsWidgetItem “ ab „FrontBelow“ funktionieren diese nur bei Diagrammen mit negativen Werten. Bei ausschließlich positiven Werten verhalten sie sich wie „CameraPreset...Low“.
`QtGraphs3D::CameraPreset::LeftBelow`	`21`	Die X-Drehung beträgt 90 Grad und die Y-Drehung -45 Grad.
`QtGraphs3D::CameraPreset::RightBelow`	`22`	Die X-Drehung beträgt -90 und die Y-Drehung -45 Grad.
`QtGraphs3D::CameraPreset::BehindBelow`	`23`	Die X-Drehung beträgt 180 und die Y-Drehung -45 Grad.
`QtGraphs3D::CameraPreset::DirectlyBelow`	`24`	Die X-Drehung beträgt 0 und die Y-Drehung -90 Grad. Wirkt wie „FrontLow“ bei Balken, die ausschließlich positive Werte enthalten.

`[since 6.12]` enum class QtGraphs3D::DragMode

Legt fest, wie Maus- oder Touch-Ziehvorgänge im Diagramm interpretiert werden.

Konstante	Wert	Beschreibung
`QtGraphs3D::DragMode::Rotate`	`0`	Durch Ziehen wird das Diagramm gedreht.
`QtGraphs3D::DragMode::Pan`	`1`	Durch Ziehen wird die Ansicht im Diagramm verschoben.

Diese Enumeration wurde in Qt 6.12 eingeführt.

enum class QtGraphs3D::ElementType

Typ eines Elements im Diagramm.

Konstante	Wert	Beschreibung
`QtGraphs3D::ElementType::None`	`0`	Kein definiertes Element.
`QtGraphs3D::ElementType::Series`	`1`	Ein Element in einer Reihe.
`QtGraphs3D::ElementType::AxisXLabel`	`2`	Die Beschriftung der x-Achse.
`QtGraphs3D::ElementType::AxisYLabel`	`3`	Die Beschriftung der y-Achse.
`QtGraphs3D::ElementType::AxisZLabel`	`4`	Die Beschriftung der z-Achse.
`QtGraphs3D::ElementType::CustomItem`	`5`	Ein benutzerdefiniertes Element.

enum class QtGraphs3D::GridLineType

Konstante	Wert	Beschreibung
`QtGraphs3D::GridLineType::Shader`	`0`	Gitterlinien werden mit der GPU in einem Shader gerendert.
`QtGraphs3D::GridLineType::Geometry`	`1`	Gitterlinien werden mit 3D-Modellen gerendert.

enum class QtGraphs3D::OptimizationHint

Der Optimierungstipp für die Darstellung.

Konstante	Wert	Beschreibung
`QtGraphs3D::OptimizationHint::Default`	`0`	Bietet den vollen Funktionsumfang mit Instanzierung bei guter Leistung.
`QtGraphs3D::OptimizationHint::Legacy`	`1`	Stellt den vollen Funktionsumfang bei angemessener Leistung bereit. Zu verwenden, wenn „OptimizationHint.Default“ eine schlechte Leistung erbringt oder nicht funktioniert.

enum class QtGraphs3D::RenderingMode

Konstante	Wert	Beschreibung
`QtGraphs3D::RenderingMode::DirectToBackground`	`0`	Gibt an, dass das Diagramm direkt auf dem Fensterhintergrund gerendert wird und QML-Elemente darüber gelegt werden. Die Verwendung eines nicht transparenten QML-Elements als Hintergrund blendet das Diagramm aus. Löscht vor dem Rendern des Diagramms das gesamte Fenster, einschließlich der Bereiche außerhalb des Diagramms. Wenn das Oberflächenformat des Fensters Antialiasing unterstützt, wird dieses verwendet (siehe QQuick3D::idealSurfaceFormat()). Dieser Darstellungsmodus bietet die beste Leistung, allerdings auf Kosten eines nicht standardmäßigen QML-Verhaltens. Beispielsweise halten sich die Grafiken nicht an die Z-Reihenfolge von QML-Elementen, und der Opazitätswert hat keine Auswirkung auf sie.
`QtGraphs3D::RenderingMode::Indirect`	`1`	Gibt an, dass das Diagramm zunächst auf eine Offscreen-Oberfläche gerendert wird, die dann während der normalen QML-Element-Darstellung gezeichnet wird. Das gerenderte Bild wird mit der Multisampling-Methode geglättet, sofern diese in der aktuellen Umgebung unterstützt wird und der Wert der Eigenschaft `msaaSamples` größer als Null ist. Dieser Rendering-Modus bietet gute Qualität und normales QML-Element-Verhalten auf Kosten der Leistung.

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

Auswahlmodi für Elemente. Die Werte dieser Aufzählung können mit dem OR-Operator kombiniert werden.

Konstante	Wert	Beschreibung
`QtGraphs3D::SelectionFlag::None`	`0x00`	Auswahlmodus deaktiviert.
`QtGraphs3D::SelectionFlag::Item`	`0x01`	Bei der Auswahl wird ein einzelnes Element hervorgehoben.
`QtGraphs3D::SelectionFlag::Row`	`0x02`	Bei der Auswahl wird eine einzelne Zeile hervorgehoben.
`QtGraphs3D::SelectionFlag::ItemAndRow`	`Item \| Row`	Kombinationsflag zum Hervorheben sowohl des Elements als auch der Zeile mit unterschiedlichen Farben.
`QtGraphs3D::SelectionFlag::Column`	`0x04`	Die Auswahl hebt eine einzelne Spalte hervor.
`QtGraphs3D::SelectionFlag::ItemAndColumn`	`Item \| Column`	Kombinationsflag zum Hervorheben von Element und Spalte in unterschiedlichen Farben.
`QtGraphs3D::SelectionFlag::RowAndColumn`	`Row \| Column`	Kombinationsflag zum Hervorheben von Zeile und Spalte.
`QtGraphs3D::SelectionFlag::ItemRowAndColumn`	`Item \| Row \| Column`	Kombinationsflag zum Hervorheben von Element, Zeile und Spalte.
`QtGraphs3D::SelectionFlag::Slice`	`0x08`	Das Setzen dieses Modus-Flags bedeutet, dass das Diagramm die Handhabung der Slice-Ansicht automatisch übernehmen soll. Wenn Sie die Slice-Ansicht selbst über ` Q3DScene` steuern möchten, setzen Sie dieses Flag nicht. Wenn Sie dieses Modus-Flag setzen, muss entweder ` `Row` ` oder ` `Column` ` gesetzt sein, jedoch nicht beides. Das Slicing wird nur von ` Q3DBarsWidgetItem ` und ` Q3DSurfaceWidgetItem ` unterstützt. Wenn dieses Flag gesetzt ist, wird der Slice-Modus in den folgenden Situationen aktiviert: Wenn die Auswahl explizit über die Series-API auf ein sichtbares Element geändert wird Wenn die Auswahl durch Klicken auf das Diagramm geändert wird Wenn sich der Auswahlmodus ändert und das ausgewählte Element sichtbar ist
`QtGraphs3D::SelectionFlag::MultiSeries`	`0x10`	Das Setzen dieses Modus bedeutet, dass Elemente aller Reihen an derselben Position hervorgehoben werden, anstatt nur des ausgewählten Elements. Die tatsächliche Auswahl in den anderen Reihen ändert sich nicht. Beim Setzen dieses Modus-Flags muss zusätzlich eines oder mehrere der grundlegenden Auswahl-Flags (`Item`, `Row` oder `Column`) gesetzt sein. Die Auswahl mehrerer Reihen wird für „ Q3DScatterWidgetItem “ nicht unterstützt.

Der Typ „SelectionFlags“ ist ein „typedef“ für „QFlags<SelectionFlag>“. Er speichert eine ODER-Kombination von „SelectionFlag“-Werten.

enum class QtGraphs3D::ShadowQuality

Qualität der Schatten.

Konstante	Wert	Beschreibung
`QtGraphs3D::ShadowQuality::None`	`0`	Schatten sind deaktiviert.
`QtGraphs3D::ShadowQuality::Low`	`1`	Schatten werden in geringer Qualität gerendert.
`QtGraphs3D::ShadowQuality::Medium`	`2`	Schatten werden in mittlerer Qualität dargestellt.
`QtGraphs3D::ShadowQuality::High`	`3`	Schatten werden in hoher Qualität dargestellt.
`QtGraphs3D::ShadowQuality::SoftLow`	`4`	Schatten werden in niedriger Qualität mit weichen Kanten dargestellt.
`QtGraphs3D::ShadowQuality::SoftMedium`	`5`	Schatten werden in mittlerer Qualität mit weichen Kanten dargestellt.
`QtGraphs3D::ShadowQuality::SoftHigh`	`6`	Schatten werden in hoher Qualität mit weichen Kanten dargestellt.

`[since 6.10]` enum class QtGraphs3D::SliceCaptureType

Art des Ausschnitts, der in ein Bild übernommen werden soll.

Konstante	Wert	Beschreibung
`QtGraphs3D::SliceCaptureType::NoImage`	`0`	Der zu erfassende Schnitttyp ist nicht definiert.
`QtGraphs3D::SliceCaptureType::RowImage`	`1`	Schicht für Zeilen erfassen.
`QtGraphs3D::SliceCaptureType::ColumnImage`	`2`	Erfassungsausschnitt für Spalten.

Diese Enumeration wurde in Qt 6.10 eingeführt.

`[since 6.9]` enum class QtGraphs3D::TransparencyTechnique

Legt fest, welche Transparenztechnik verwendet werden soll. Der Standardwert ist „ Default “. Verwenden Sie beim Rendern transparenter Oberflächendiagramme „ Approximate “ oder „ Accurate “. Für andere Diagrammtypen sollte „ Default “ verwendet werden.

Konstante	Wert	Beschreibung
`QtGraphs3D::TransparencyTechnique::Default`	`0`	Gibt an, dass ordnungsunabhängige Transparenztechniken nicht verwendet werden. Bietet die beste Leistung. Verwenden Sie diese Option, wenn Diagramme keine Transparenz enthalten oder wenn ein Balken- oder Streudiagramm ebenfalls Instanzierung verwendet, d. h. „optimizationHint“ ist { „QtGraphs3D::OptimizationHint::Default “ }.
`QtGraphs3D::TransparencyTechnique::Approximate`	`1`	Gibt an, dass ein Diagramm eine Annäherung an die reihenfolgeunabhängige Transparenz versucht. Diese Methode ist schneller als „ `Accurate` “ und funktioniert auf älterer Hardware, kann jedoch zu ungenauen Ergebnissen führen. Verwenden Sie diese Option, wenn reihenfolgeunabhängige Transparenz benötigt wird, die Leistungsbeeinträchtigung jedoch geringer sein muss als bei der Verwendung einer exakten reihenfolgeunabhängigen Transparenz.
`QtGraphs3D::TransparencyTechnique::Accurate`	`2`	Gibt an, dass eine genaue reihenfolgeunabhängige Transparenz verwendet wird. Verwenden Sie diese Option, wenn eine perfekte Darstellung der Transparenz erforderlich ist.

Diese Enumeration wurde in Qt 6.9 eingeführt.

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