AbstractGraph3D QML Type
Basistyp für 3D-Visualisierungen. Mehr...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
Methoden
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
Ausführliche Beschreibung
Der Basistyp für alle 3D-Visualisierungen in „ QtDataVisualization “.
Dieser Typ kann nicht erstellt werden, enthält jedoch Eigenschaften, die allen 3D-Visualisierungen gemeinsam sind.
Siehe auch „ Bars3D“ , „ Scatter3D “, „ Surface3D “ und Qt Data Visualization C++ Classes.
Dokumentation zu den Eigenschaften
aspectRatio : real [since QtDataVisualization 1.1]
Das Skalierungsverhältnis des Diagramms zwischen der längsten Achse auf der horizontalen Ebene und der y-Achse. Der Standardwert ist „ 2.0 “.
Hinweis: Hat keine Auswirkung auf „Bars3D“.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch horizontalAspectRatio.
currentFps : int [since QtDataVisualization 1.1]
Wenn die FPS-Messung aktiviert ist, werden die Ergebnisse der letzten Sekunde in dieser schreibgeschützten Eigenschaft gespeichert. Es dauert mindestens eine Sekunde, bis dieser Wert nach Aktivierung der Messung aktualisiert wird.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch measureFps.
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
Die Liste der „ Custom3DItem “-Elemente, die dem Diagramm hinzugefügt wurden. Das Diagramm übernimmt die Verantwortung für die hinzugefügten Elemente.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
horizontalAspectRatio : real [since QtDataVisualization 1.2]
Das Skalierungsverhältnis zwischen der x-Achse und der z-Achse im Diagramm. Der Wert „ 0.0 “ bedeutet eine automatische Skalierung entsprechend den Achsenbereichen. Die Standardeinstellung ist „ 0.0 “.
Hinweis: Hat keine Auswirkung auf „Bars3D“, da die Skalierung in der horizontalen Ebene dort über die Eigenschaften „ barThickness “ und „ barSpacing “ gesteuert wird. Auch Polardiagramme ignorieren diese Eigenschaft.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch „ aspectRatio“ , „ polar “, „ Bars3D::barThickness “ und „ Bars3D::barSpacing “.
inputHandler : AbstractInputHandler3D
Der im Diagramm verwendete aktive Eingabe-Handler. Sie können die Standard-Eingabe-Handler deaktivieren, indem Sie diese Eigenschaft auf „null“ setzen.
locale : locale [since QtDataVisualization 1.2]
Legt die für die Formatierung verschiedener Zahlenbezeichnungen verwendete Locale fest. Standardmäßig ist die Locale „ "C" “ eingestellt.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch „ ValueAxis3D::labelFormat “.
margin : real [since QtDataVisualization 1.2]
Der absolute Wert, der für den Abstand zwischen dem Rand des darstellbaren Diagrammbereichs und dem Rand des Diagrammhintergrunds verwendet wird.
Ist der Randwert negativ, werden die Ränder automatisch festgelegt und können je nach Größe der Elemente in der Reihe und dem Diagrammtyp variieren. Der Wert wird als Bruchteil des y-Achsenbereichs interpretiert, sofern die Seitenverhältnisse des Diagramms nicht gegenüber den Standardwerten geändert wurden. Der Standardwert ist „ -1.0 “.
Hinweis: Wenn Sie für ein Streudiagramm einen kleineren Rand als den automatisch ermitteltenfestlegen , kann es vorkommen, dass sich die Streudiagrammpunkte an den Rändern des Diagramms mit dem Diagrammhintergrund überlappen.
Hinweis: Bei Streu- und Flächendiagrammen werden die Positionen der Randbeschriftungen der Achsen angepasst, um eine Überlappung mit den Randbeschriftungen benachbarter Achsen zu vermeiden, wenn der Rand im Vergleich zur Größe der Achsenbeschriftungen klein ist.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
measureFps : bool [since QtDataVisualization 1.1]
Wenn ` true` gesetzt ist, erfolgt die Darstellung kontinuierlich statt bei Bedarf, und der Wert der Eigenschaft ` currentFps ` wird aktualisiert. Der Standardwert ist ` false`.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ currentFps “.
msaaSamples : int
Die Anzahl der Samples, die beim Multisample-Antialiasing verwendet werden, wenn „renderingMode“ auf „ RenderIndirect “ gesetzt ist. Wenn „renderingMode“ auf „ RenderDirectToBackground “ oder „ RenderDirectToBackground_NoClear “ gesetzt ist, ist dieser Eigenschaftswert schreibgeschützt und gibt die Anzahl der Samples zurück, die durch das Fensteroberflächenformat festgelegt ist. Der Standardwert ist „ 4 “.
Siehe auch „ renderingMode “.
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
Ob zur Optimierung der Darstellung der Standardmodus oder der statische Modus verwendet wird.
Der Standardmodus bietet den vollen Funktionsumfang bei angemessener Leistung. Der statische Modus optimiert die Darstellung von Diagrammen und eignet sich ideal für große, unveränderliche Datensätze. Bei dynamischen Datenänderungen und der Rotation von Elementen ist er langsamer. Die Auswahl wird nicht optimiert, daher ist die Verwendung des statischen Modus bei sehr großen Datensätzen nicht empfehlenswert. Die statische Optimierung funktioniert nur bei Streudiagrammen. Die Standardeinstellung ist „ OptimizationDefault “.
Hinweis: In manchen Umgebungen werden große Diagramme mit statischer Optimierung möglicherweise nicht gerendert, da alle Elemente mit einem einzigen Draw-Call gerendert werden und verschiedene Grafiktreiber unterschiedliche maximale Eckpunktanzahlen pro Aufruf unterstützen. Dies ist vor allem auf 32-Bit- und OpenGL-ES2-Plattformen ein Problem. Um dieses Problem zu umgehen, wählen Sie ein Element-Mesh mit einer geringen Anzahl an Eckpunkten oder verwenden Sie das Punkt-Mesh.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch Abstract3DSeries::mesh und QAbstract3DGraph::OptimizationHint.
orthoProjection : bool [since QtDataVisualization 1.1]
Wenn „ true “ eingestellt ist, wird zur Darstellung des Diagramms die orthogonale Projektion verwendet. Die Standardeinstellung ist „ false “.
Hinweis: Bei der Einstellung „ true “ werdenSchatten deaktiviert.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
polar : bool [since QtDataVisualization 1.2]
Wenn true ist, werden die horizontalen Achsen in Polarkoordinaten umgewandelt. Die x-Achse wird zur Winkelachse und die z-Achse zur Radialachse. Der Polarmodus ist für Balkendiagramme nicht verfügbar.
Standardmäßig ist „ false “ eingestellt.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch „ orthoProjection “ und „ radialLabelOffset “.
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
Diese schreibgeschützte Eigenschaft enthält die aktuellsten Positionswerte des Diagramms entlang jeder Achse, die mit „ Scene3D::graphPositionQuery “ abgefragt wurden. Die Werte sind auf den Bereich [-1, 1] normiert. Liegt die abgefragte Position außerhalb der Diagrammgrenzen, spiegeln die Werte nicht die tatsächliche Position wider, sondern stellen stattdessen eine undefinierte Position außerhalb des Bereichs [-1, 1] dar. Der Wert bleibt undefiniert, bis eine Abfrage erfolgt.
Da es keine eindeutige 3D-Koordinate gibt, die einer bestimmten Bildschirmposition entspricht, werden die Abfragen aus Gründen der Konsistenz stets an den Innenseiten eines unsichtbaren Rahmens durchgeführt, der das Diagramm umgibt.
Hinweis: Bei Balkendiagrammen ist die Abfrage der Diagrammposition nur auf Höhe des Diagrammbodens möglich. Daher ist der y-Wert bei Balkendiagrammen immer Null, und gültige Abfragen können nur an Bildschirmpositionen erfolgen, die den Diagrammboden enthalten.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch Scene3D::graphPositionQuery.
radialLabelOffset : real [since QtDataVisualization 1.2]
Diese Eigenschaft legt den normierten horizontalen Versatz für die Achsenbeschriftungen der radialen Polachse fest. Der Wert „ 0.0 “ gibt an, dass die Beschriftungen neben der Gitterlinie der Winkelachse beim Winkel 0 gezeichnet werden sollen. Der Wert „ 1.0 “ gibt an, dass die Beschriftungen an ihrer üblichen Position am Rand des Diagrammhintergrunds gezeichnet werden. Diese Eigenschaft wird ignoriert, wenn der Wert der Eigenschaft „polar“ auf „ false “ gesetzt ist. Der Standardwert ist „ 1.0 “.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch „ polar “.
reflection : bool [since QtDataVisualization 1.2]
Schaltet Bodenreflexionen ein oder aus. Die Standardeinstellung lautet „ false “.
Hinweis: Betrifft nur Bars3D. In Bars3D-Diagrammen, die sowohl positive als auch negative Werte enthalten, werden Reflexionen für benutzerdefinierte Elemente, die die Bodenebene schneiden, jedoch nicht unterstützt. In diesem Fall sollten Reflexionen deaktiviert werden, um eine fehlerhafte Darstellung zu vermeiden.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch reflectivity.
reflectivity : real [since QtDataVisualization 1.2]
Legt die Reflektivität des Bodens fest. Je höher der Wert, desto stärker reflektiert der Boden. Der gültige Bereich liegt zwischen [0...1]. Der Standardwert ist 0.5.
Hinweis: Betrifft nur „Bars3D“.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch reflection.
scene : Scene3D
Der Scene3D-Zeiger, mit dem die Szene bearbeitet und auf Szenenelemente wie beispielsweise die aktive Kamera zugegriffen werden kann.
Diese Eigenschaft ist schreibgeschützt.
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
Das im Diagramm ausgewählte Element.
Mit dieser Eigenschaft lässt sich der Typ des ausgewählten Elements abfragen. Der Typ bleibt gültig, bis im Diagramm eine neue Auswahl getroffen wird und das Signal „ selectedElementChanged “ ausgelöst wird.
Das Signal kann beispielsweise zur Implementierung einer benutzerdefinierten Eingabeverarbeitung verwendet werden, wie im Beispiel „Axis Handling“ gezeigt wird.
Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ selectedLabelIndex()“, „ selectedAxis()“, „ selectedCustomItemIndex()“, „ selectedCustomItem()“, „ Bars3D::selectedSeries “, „ Scatter3D::selectedSeries “, „ Scene3D::selectionQueryPosition “ und „ QAbstract3DGraph::ElementType “.
selectionMode : AbstractGraph3D.SelectionMode
Der aktive Auswahlmodus in der Visualisierung. Einer der Enum-Werte aus „ QAbstract3DGraph::SelectionFlag “.
Siehe auch „ QAbstract3DGraph::SelectionFlag “.
shadowQuality : AbstractGraph3D.ShadowQuality
Die Qualität der Schatten. Einer der Enum-Werte von „ QAbstract3DGraph::ShadowQuality “.
Siehe auch QAbstract3DGraph::ShadowQuality.
shadowsSupported : bool
Diese schreibgeschützte Eigenschaft gibt an, ob Schatten bei der aktuellen Konfiguration unterstützt werden. OpenGL ES2-Konfigurationen unterstützen keine Schatten.
theme : Theme3D
Das aktuell ausgewählte Thema der Grafik.
Siehe auch Theme3D.
Methodendokumentation
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
Fügt dem Graph ein „Custom3DItem“ item “ hinzu. Der Graph übernimmt die Verantwortung für das hinzugefügte Element.
Gibt den Index des hinzugefügten Elements zurück, wenn das Hinzufügen erfolgreich war, -1, wenn versucht wird, ein Null-Element hinzuzufügen, und den Index des Elements, wenn versucht wird, ein bereits vorhandenes Element hinzuzufügen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch ` removeCustomItems()`, ` removeCustomItem()` und ` removeCustomItemAt()`.
void clearSelection()
Löscht die Auswahl aus allen zugehörigen Serien.
[since 6.3] bool hasSeries(Abstract3DSeries series)
Gibt zurück, ob die „ series “ bereits zum Graphen hinzugefügt wurde.
Diese Methode wurde in Qt 6.3 eingeführt.
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
Erlangt die Eigentumsrechte an „ item “ zurück und entfernt „ item “ aus dem Diagramm.
Hinweis: Wenn dasselbe Element wieder zum Diagramm hinzugefügt wird, muss die Texturdatei neu festgelegt werden.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ Custom3DItem::textureFile “.
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
Entfernt den benutzerdefinierten „ item “. Löscht die ihm zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
Entfernt alle benutzerdefinierten Elemente unter position. Löscht die ihnen zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
[since QtDataVisualization 1.1] void removeCustomItems()
Entfernt alle benutzerdefinierten Elemente. Löscht die ihnen zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
Kann verwendet werden, um die ausgewählte Achse abzurufen, nachdem ein „ selectedElementChanged “-Signal mit einem beliebigen Beschriftungstyp empfangen wurde. Die Auswahl bleibt bis zum nächsten „ selectedElementChanged “-Signal gültig.
Gibt die ausgewählte Achse oder „null“ zurück.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ selectedElement “.
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
Kann verwendet werden, um das ausgewählte benutzerdefinierte Element abzurufen, nachdem ein „ selectedElementChanged “-Signal vom Typ „ ElementCustomItem “ empfangen wurde. Das Eigentum an dem Element verbleibt beim Graphen. Die Auswahl ist bis zum nächsten „ selectedElementChanged “-Signal gültig.
Gibt das ausgewählte benutzerdefinierte Element oder null zurück.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ selectedElement “.
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
Kann verwendet werden, um den Index des ausgewählten benutzerdefinierten Elements abzufragen, nachdem ein „ selectedElementChanged “-Signal vom Typ „ ElementCustomItem “ empfangen wurde. Die Auswahl ist bis zum nächsten „ selectedElementChanged “-Signal gültig.
Gibt den Index des ausgewählten benutzerdefinierten Elements oder -1 zurück.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ selectedElement “.
[since QtDataVisualization 1.1] int selectedLabelIndex()
Kann verwendet werden, um den Index der ausgewählten Beschriftung abzufragen, nachdem ein „ selectedElementChanged “-Signal mit einem beliebigen Beschriftungstyp empfangen wurde. Die Auswahl bleibt bis zum nächsten „ selectedElementChanged “-Signal gültig.
Gibt den Index der ausgewählten Beschriftung oder -1 zurück.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
Siehe auch „ selectedElement “.
© 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.
