Auf dieser Seite

Graphs3D QML Type

Enums im Namespace „Graphs3D“. Mehr...

Import Statement: import QtGraphs

Ausführliche Beschreibung

Der Namespace „Graphs3D“ stellt die folgenden Enums bereit, die von der 3D-API von „ QtGraphs “ verwendet werden.

Graphs3D.SelectionFlag

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

KonstanteBeschreibung
NoneAuswahlmodus deaktiviert.
ItemBei der Auswahl wird ein einzelnes Element hervorgehoben.
RowBei der Auswahl wird eine einzelne Zeile hervorgehoben.
ItemAndRowKombinationsflag zum Hervorheben sowohl des Elements als auch der Zeile mit unterschiedlichen Farben.
ColumnDie Auswahl hebt eine einzelne Spalte hervor.
ItemAndColumnKombinationsflag zum Hervorheben von Element und Spalte in unterschiedlichen Farben.
RowAndColumnKombinationsflag zum Hervorheben von Zeile und Spalte.
ItemRowAndColumnKombinationsflag zum Hervorheben von Element, Zeile und Spalte.
SliceDas 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 „ Bars3D “ und „ Surface3D “ 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
MultiSeriesDie Aktivierung 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. Bei Aktivierung dieses Modus-Flags muss mindestens eines der grundlegenden Auswahl-Flags (Item, Row oder Column) ebenfalls gesetzt sein. Die Auswahl mehrerer Reihen wird für „ Scatter3D “ nicht unterstützt.

Graphs3D.ShadowQuality

Qualität und Weichheit der Schatten.

KonstanteBeschreibung
NoneSchatten sind deaktiviert.
LowSchatten werden in geringer Qualität gerendert.
MediumSchatten werden in mittlerer Qualität gerendert.
HighSchatten werden in hoher Qualität gerendert.
SoftLowSchatten werden in niedriger Qualität mit weichen Kanten dargestellt.
SoftMediumSchatten werden in mittlerer Qualität mit weichen Kanten dargestellt.
SoftHighSchatten werden in hoher Qualität mit weichen Kanten dargestellt.

Graphs3D.ElementType

Typ eines Elements im Diagramm.

KonstanteBeschreibung
NoneKein definiertes Element.
SeriesEin Element in einer Reihe.
AxisXLabelDie Beschriftung der x-Achse.
AxisYLabelDie Beschriftung der y-Achse.
AxisZLabelDie Beschriftung der z-Achse.
CustomItemEin benutzerdefiniertes Element.

Graphs3D.OptimizationHint

Der Optimierungshinweis für die Darstellung.

KonstanteBeschreibung
DefaultBietet den vollen Funktionsumfang mit Instanzierung bei guter Leistung.
LegacyStellt den vollen Funktionsumfang bei angemessener Leistung bereit. Zu verwenden, wenn „OptimizationHint.Default“ eine schlechte Leistung erbringt oder nicht funktioniert.

Graphs3D.CameraPreset

Vordefinierte Positionen für die Kamera.

KonstanteBeschreibung
NoPresetWird verwendet, um anzuzeigen, dass keine Voreinstellung festgelegt wurde oder die Szene frei gedreht wurde.
FrontLowSowohl die x- als auch die y-Drehung der Kamera betragen 0.
FrontDie X-Drehung beträgt 0 und die Y-Drehung 22,5 Grad.
FrontHighDie X-Drehung beträgt 0 und die Y-Drehung 45 Grad.
LeftLowDie X-Drehung beträgt 90 und die Y-Drehung 0 Grad.
LeftDie X-Drehung beträgt 90 und die Y-Drehung 22,5 Grad.
LeftHighDie X-Drehung beträgt 90 und die Y-Drehung 45 Grad.
RightLowDie X-Drehung beträgt -90 und die Y-Drehung 0 Grad.
RightDie X-Drehung beträgt -90 und die Y-Drehung 22,5 Grad.
RightHighDie X-Drehung beträgt -90 und die Y-Drehung 45 Grad.
BehindLowDie X-Drehung beträgt 180 und die Y-Drehung 0 Grad.
BehindDie X-Drehung beträgt 180 und die Y-Drehung 22,5 Grad.
BehindHighDie X-Drehung beträgt 180 Grad und die Y-Drehung 45 Grad.
IsometricLeftDie X-Drehung beträgt 45 und die Y-Drehung 22,5 Grad.
IsometricLeftHighDie X-Drehung beträgt 45 und die Y-Drehung 45 Grad.
IsometricRightDie X-Drehung beträgt -45 und die Y-Drehung 22,5 Grad.
IsometricRightHighDie X-Drehung beträgt -45 und die Y-Drehung 45 Grad.
DirectlyAboveDie X-Drehung beträgt 0 und die Y-Drehung 90 Grad.
DirectlyAboveCW45Die X-Drehung beträgt -45 und die Y-Drehung 90 Grad.
DirectlyAboveCCW45Die X-Drehung beträgt 45 und die Y-Drehung 90 Grad.
FrontBelowDie X-Drehung beträgt 0 und die Y-Drehung -45 Grad. In „ Bars3D “ ab „FrontBelow“ funktionieren diese nur bei Diagrammen mit negativen Werten. Bei ausschließlich positiven Werten verhalten sie sich wie „CameraPreset...Low“.
LeftBelowDie X-Drehung beträgt 90 Grad und die Y-Drehung -45 Grad.
RightBelowDie X-Drehung beträgt -90 und die Y-Drehung -45 Grad.
BehindBelowDie X-Drehung beträgt 180 und die Y-Drehung -45 Grad.
DirectlyBelowDie X-Drehung beträgt 0 und die Y-Drehung -90 Grad. Wirkt bei Balken, die nur positive Werte enthalten, wie „FrontLow“.

Graphs3D.GridLineType

KonstanteBeschreibung
ShaderGitterlinien werden mit der GPU in einem Shader gerendert.
GeometryGitterlinien werden mit 3D-Modellen gerendert.

Graphs3D.RenderingMode

KonstanteBeschreibung
DirectToBackgroundGibt an, dass das Diagramm direkt auf dem Fensterhintergrund gerendert wird und QML-Elemente darüber liegen. 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, geht jedoch mit einem nicht standardmäßigen QML-Verhalten einher. Beispielsweise halten sich die Diagramme nicht an die Z-Reihenfolge von QML-Elementen, und der Opazitätswert hat keine Auswirkung auf sie.
IndirectGibt an, dass das Diagramm zunächst auf einer Offscreen-Oberfläche gerendert wird, die dann während des normalen QML-Element-Renderings 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 Rendermodus bietet gute Qualität und normales QML-Element-Verhalten auf Kosten der Leistung.

Graphs3D.TransparencyTechnique

KonstanteBeschreibung
DefaultGibt an, dass reihenunabhä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. wenn `optimizationHint` den Wert { `QtGraphs3D::OptimizationHint::Default` } hat.
ApproximateGibt an, dass ein Diagramm eine Annäherung an 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 Leistungseinbußen jedoch geringer sein müssen als bei der Verwendung genauer reihenfolgeunabhängiger Transparenz.
AccurateGibt an, dass eine genaue, reihenfolgeunabhängige Transparenz verwendet wird. Verwenden Sie diese Option, wenn eine perfekte Transparenzwiedergabe erforderlich ist.

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