AbstractGraph3D QML Type
Basistyp für 3D-Visualisierungen. Mehr...
Import Statement: | import QtDataVisualization 1.8 |
Since: | QtDataVisualization 1.0 |
Inherited By: |
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)
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 |
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 |
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> |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.
Dokumentation der Methode
|
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.
|
Gibt zurück, ob die series bereits zum Graphen hinzugefügt wurde.
Diese Methode wurde in Qt 6.3 eingeführt.
|
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.
|
Entfernt die benutzerdefinierte item. Löscht die ihm zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
|
Entfernt alle benutzerdefinierten Elemente auf position. Löscht die ihnen zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
|
Entfernt alle benutzerdefinierten Elemente. Löscht die ihnen zugewiesenen Ressourcen.
Diese Methode wurde in QtDataVisualization 1.1 eingeführt.
|
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.
|
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.
|
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.
|
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.