AbstractGraph3D QML Type

Basistyp für 3D-Visualisierungen. Mehr...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
Inherited By:

Bars3D, Scatter3D, and Surface3D

Eigenschaften

Methoden

Detaillierte Beschreibung

Der Basistyp für alle 3D-Visualisierungen in QtDataVisualization.

Dieser Typ kann nicht erstellt werden, aber er enthält Eigenschaften, die von allen 3D-Visualisierungen gemeinsam genutzt werden.

Siehe auch Bars3D, Scatter3D, Surface3D, und Qt Data Visualization C++ Classes.

Eigenschaft Dokumentation

aspectRatio : real [since QtDataVisualization 1.1]

Das Verhältnis der Diagrammskalierung 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 für die letzte Sekunde in dieser schreibgeschützten Eigenschaft gespeichert. Es dauert mindestens eine Sekunde, bevor dieser Wert aktualisiert wird, nachdem die Messung aktiviert wurde.

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 Graphen hinzugefügt wurden. Der Graph übernimmt das Eigentum an den hinzugefügten Elementen.

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.


horizontalAspectRatio : real [since QtDataVisualization 1.2]

Das Verhältnis der Skalierung des Graphen zwischen der x-Achse und der z-Achse. Der Wert 0.0 bedeutet eine automatische Skalierung entsprechend der Achsenbereiche. Der Standardwert ist 0.0.

Hinweis: Hat keine Auswirkung auf Bars3D, das die Skalierung auf der horizontalen Ebene über die Eigenschaften barThickness und barSpacing handhabt. Polardiagramme ignorieren diese Eigenschaft ebenfalls.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Siehe auch aspectRatio, polar, Bars3D::barThickness, und Bars3D::barSpacing.


inputHandler : AbstractInputHandler3D

Der aktive Eingabe-Handler, der im Diagramm verwendet wird. Sie können die Standard-Eingabehandler deaktivieren, indem Sie diese Eigenschaft auf null setzen.


locale : locale [since QtDataVisualization 1.2]

Legt das Gebietsschema fest, das für die Formatierung verschiedener numerischer Beschriftungen verwendet wird. Standardmäßig wird das Gebietsschema "C" verwendet.

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 plottbaren Diagrammbereichs und dem Rand des Diagrammhintergrunds verwendet wird.

Wenn der Randwert negativ ist, werden die Ränder automatisch bestimmt und können je nach Größe der Elemente in der Reihe und dem Typ des Diagramms variieren. Der Wert wird als Bruchteil des Bereichs der y-Achse interpretiert, wenn die Seitenverhältnisse des Diagramms nicht von den Standardwerten abgewichen sind. Der Standardwert ist -1.0.

Hinweis: Wird für ein Streudiagramm ein kleinerer Rand als der automatisch ermittelte Rand eingestellt, kann dies dazu führen, dass sich die Streuelemente an den Rändern des Diagramms mit dem Diagrammhintergrund überlappen.

Hinweis: Bei Streu- und Oberflächendiagrammen werden, wenn der Rand im Vergleich zur Größe der Achsenbeschriftung klein ist, die Positionen der Kantenbeschriftungen der Achsen angepasst, um eine Überlappung mit den Kantenbeschriftungen der benachbarten Achsen zu vermeiden.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.


measureFps : bool [since QtDataVisualization 1.1]

Wenn true, wird das Rendering kontinuierlich statt bei Bedarf durchgeführt, 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 RenderIndirect ist. Wenn renderingMode RenderDirectToBackground oder RenderDirectToBackground_NoClear 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]

Gibt an, ob der Standard- oder der statische Modus für die Rendering-Optimierung verwendet wird.

Der Standardmodus bietet den vollen Funktionsumfang bei einem angemessenen Leistungsniveau. Der statische Modus optimiert das Rendering von Diagrammen und ist ideal für große, sich nicht verändernde Datensätze. Bei dynamischen Datenänderungen und Elementdrehungen ist er langsamer. Die Auswahl wird nicht optimiert, daher ist die Verwendung des statischen Modus bei großen Datensätzen nicht ratsam. Die statische Optimierung funktioniert nur bei Streudiagrammen. Die Standardeinstellung ist OptimizationDefault.

Hinweis: In manchen Umgebungen können große Diagramme mit statischer Optimierung nicht gerendert werden, da alle Elemente mit einem einzigen Zeichenaufruf gerendert werden und verschiedene Grafiktreiber unterschiedliche maximale Anzahlen von Vertices pro Aufruf unterstützen. Dies ist vor allem ein Problem auf 32bit- und OpenGL ES2-Plattformen. Um dieses Problem zu umgehen, wählen Sie ein Item-Mesh mit einer niedrigen Vertex-Anzahl oder verwenden Sie das Point-Mesh.

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.

Siehe auch Abstract3DSeries::mesh und QAbstract3DGraph::OptimizationHint.


orthoProjection : bool [since QtDataVisualization 1.1]

Falls true, wird die orthographische Projektion für die Darstellung des Diagramms verwendet. Die Voreinstellung ist false.

Hinweis: Schatten werden deaktiviert, wenn sie auf true gesetzt sind.

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.


polar : bool [since QtDataVisualization 1.2]

Bei true werden die horizontalen Achsen in polare Achsen umgewandelt. Die x-Achse wird zur Winkelachse und die z-Achse wird zur Radialachse. Der Polarmodus ist für Balkendiagramme nicht verfügbar.

Die Voreinstellung ist false.

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 letzten Positionswerte des Diagramms entlang jeder Achse, die mit Scene3D::graphPositionQuery abgefragt wurden. Die Werte sind auf den Bereich [-1, 1] normalisiert. Wenn die abgefragte Position außerhalb der Diagrammgrenzen lag, spiegeln die Werte nicht die tatsächliche Position wider, sondern eine undefinierte Position außerhalb des Bereichs [-1, 1]. Der Wert ist so lange undefiniert, bis eine Abfrage durchgeführt wird.

Es gibt keine einzige korrekte 3D-Koordinate, die einer bestimmten Bildschirmposition entspricht. Um konsistent zu sein, werden die Abfragen daher immer an den Innenseiten eines unsichtbaren Rahmens durchgeführt, der das Diagramm umgibt.

Hinweis: Balkendiagramme erlauben die Abfrage der Diagrammposition nur auf der Ebene des Diagrammbodens, so dass der y-Wert bei Balkendiagrammen immer Null ist und gültige Abfragen nur an Bildschirmpositionen erfolgen können, die den Boden des Diagramms enthalten.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Siehe auch Scene3D::graphPositionQuery.


radialLabelOffset : real [since QtDataVisualization 1.2]

Diese Eigenschaft gibt den normierten horizontalen Offset für die Achsenbeschriftungen der radialen Polarachse an. Der Wert 0.0 gibt an, dass die Beschriftungen neben der 0-Winkel-Winkelachsen-Gitterlinie gezeichnet werden sollen. Der Wert 1.0 gibt an, dass die Beschriftungen an ihrem üblichen Platz am Rand des Diagrammhintergrunds gezeichnet werden. Diese Eigenschaft wird ignoriert, wenn der Wert der Polareigenschaft false lautet. Der Standardwert ist 1.0.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Siehe auch polar.


reflection : bool [since QtDataVisualization 1.2]

Setzt Bodenreflexionen ein oder aus. Der Standardwert ist 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, nicht unterstützt. In diesem Fall sollten die Spiegelungen ausgeschaltet werden, um eine falsche 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. Größere Zahlen machen den Boden reflektierender. Der gültige Bereich ist [0...1]. Der Standardwert ist 0.5.

Hinweis: Beeinflusst nur Bars3D.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Siehe auch reflection.


scene : Scene3D

Der Scene3D Zeiger, der verwendet werden kann, um die Szene zu manipulieren und auf die Szenenelemente zuzugreifen, wie z.B. die aktive Kamera.

Diese Eigenschaft ist schreibgeschützt.


selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]

Das im Diagramm ausgewählte Element.

Diese Eigenschaft kann verwendet werden, um den Typ des ausgewählten Elements abzufragen. Der Typ ist so lange gültig, bis eine neue Auswahl im Graphen getroffen und das Signal selectedElementChanged ausgegeben wird.

Das Signal kann z.B. für die Implementierung einer benutzerdefinierten Eingabebehandlung verwendet werden, wie im Beispiel Axis Handling gezeigt.

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 QAbstract3DGraph::SelectionFlag enum-Werte.

Siehe auch QAbstract3DGraph::SelectionFlag.


shadowQuality : AbstractGraph3D.ShadowQuality

Die Qualität des Schattens. Einer der QAbstract3DGraph::ShadowQuality enum-Werte.

Siehe auch QAbstract3DGraph::ShadowQuality.


shadowsSupported : bool

Diese schreibgeschützte Eigenschaft zeigt an, ob Schatten in der aktuellen Konfiguration unterstützt werden. OpenGL ES2-Konfigurationen unterstützen keine Schatten.


theme : Theme3D

Das aktive Thema des Diagramms.

Siehe auch Theme3D.


Dokumentation der Methode

[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)

Fügt dem Diagramm ein Custom3DItem item hinzu. Graph übernimmt das Eigentum an dem hinzugefügten Element.

Gibt den Index des hinzugefügten Elements zurück, wenn das Hinzufügen erfolgreich war, -1, wenn versucht wurde, ein Nullelement hinzuzufügen, und den Index des Elements, wenn versucht wurde, ein bereits hinzugefügtes 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 angehängten Reihen.


[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)

Holt den Besitz von item zurück und entfernt item aus dem Diagramm.

Hinweis: Wenn dasselbe Element wieder zum Graphen hinzugefügt wird, muss die Texturdatei neu gesetzt werden.

Diese Methode wurde in QtDataVisualization 1.1 eingeführt.

Siehe auch Custom3DItem::textureFile.


[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)

Entfernt die benutzerdefinierte 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 auf 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 nach dem Empfang des Signals selectedElementChanged mit einem beliebigen Etikettentyp zu erhalten. Die Auswahl ist 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 nach Erhalt des Signals selectedElementChanged mit dem Typ ElementCustomItem zu erhalten. Das Eigentum an dem Element verbleibt beim Diagramm. 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 das Signal selectedElementChanged mit dem 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 des ausgewählten Etiketts abzufragen, nachdem das Signal selectedElementChanged mit einem beliebigen Etikettentyp empfangen wurde. Die Auswahl ist bis zum nächsten selectedElementChanged -Signal gültig.

Gibt den Index des ausgewählten Labels zurück, oder -1.

Diese Methode wurde in QtDataVisualization 1.1 eingeführt.

Siehe auch selectedElement.


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