Custom3DItem QML Type
Fügt einem Diagramm ein benutzerdefiniertes Element hinzu. Mehr...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
(since QtDataVisualization 1.2) - shadowCasting : bool
- textureFile : string
- visible : bool
Methoden
- void setRotationAxisAndAngle(vector3d axis, real angle)
Ausführliche Beschreibung
Ein benutzerdefiniertes Element verfügt über ein benutzerdefiniertes Mesh, eine Position, eine Skalierung, eine Rotation und eine optionale Textur.
Dokumentation der Eigenschaften
meshFile : string
Der Dateiname der Mesh-Datei des Objekts. Das Objekt in der Datei muss im Wavefront-OBJ-Format vorliegen und Scheitelpunkte, Normalen sowie UV-Koordinaten enthalten. Außerdem muss es aus Dreiecken bestehen. Fehlen in der Datei entweder Normalen oder UV-Koordinaten, schlägt das Laden fehl, es wird eine Fehlermeldung in der Konsolenausgabe angezeigt und das Objekt wird nicht gerendert.
position : vector3d
Die Position des Elements als Typ „ vector3d “. Der Standardwert ist „ vector3d(0.0, 0.0, 0.0) “.
Die Position des Elements wird je nach Wert der Eigenschaft ` positionAbsolute ` entweder in Datenkoordinaten oder in absoluten Koordinaten angegeben. Bei Verwendung absoluter Koordinaten liegen Werte zwischen ` -1.0...1.0 ` innerhalb der Achsenbereiche.
Hinweis: Elemente , die außerhalb eines Achsenbereichs positioniert sind, werden nicht gerendert, wenn „ positionAbsolute “ auf „ false “ gesetzt ist, es sei denn, es handelt sich um ein „Custom3DVolume“, das teilweise sichtbar wäre, und „ scalingAbsolute “ ist ebenfalls auf „ false “ gesetzt. In diesem Fall wird der sichtbare Teil des Volumens gerendert.
Siehe auch „ positionAbsolute “ und „ scalingAbsolute “.
positionAbsolute : bool
Legt fest, ob die Position von Elementen anhand von Datenkoordinaten oder anhand von absoluten Koordinaten behandelt werden soll. Die Standardeinstellung ist „ false “. Elemente mit absoluten Koordinaten werden immer dargestellt, während Elemente mit Datenkoordinaten nur dann dargestellt werden, wenn sie sich innerhalb der Achsenbereiche befinden.
Siehe auch „ position “.
rotation : quaternion
Die Artikelrotation als „ quaternion “. Standardmäßig ist „ quaternion(0.0, 0.0, 0.0, 0.0) “ eingestellt.
scaling : vector3d
Die Skalierung des Elements erfolgt als Typ „ vector3d “. Der Standardwert ist „ vector3d(0.1, 0.1, 0.1) “.
Die Skalierung des Elements wird je nach Wert der Eigenschaft „ scalingAbsolute “ entweder in Datenwerten oder in absoluten Werten angegeben. Der Standardvektor, der als absolute Werte interpretiert wird, legt das Element auf 10 % der Höhe des Diagramms fest, vorausgesetzt, das Elementgitter ist normalisiert und die Seitenverhältnisse des Diagramms wurden nicht gegenüber den Standardwerten geändert.
Siehe auch „ scalingAbsolute “.
scalingAbsolute : bool [since QtDataVisualization 1.2]
Legt fest, ob die Skalierung der Elemente anhand von Datenwerten oder anhand von absoluten Werten erfolgen soll. Die Standardeinstellung ist „ true “. Elemente mit absoluter Skalierung werden unabhängig von den Achsenbereichen immer in derselben Größe dargestellt. Elemente mit Datenskalierung ändern ihre sichtbare Größe entsprechend den Achsenbereichen. Wenn „ positionAbsolute “ auf „ true “ gesetzt ist, wird diese Eigenschaft ignoriert und die Skalierung als absoluter Wert interpretiert. Wenn das Element gedreht ist, wird die Datenskalierung auf das ungedrehte Element berechnet. Analog dazu wird bei „Custom3DVolume“-Elementen die Bereichsbeschneidung auf das ungedrehte Element berechnet.
Hinweis: Für „Custom3DLabel“-Elemente oder für benutzerdefinierte Elemente, die in „ polar “-Diagrammen verwendet werden, wirdnur die absolute Skalierung unterstützt.
Hinweis: Das Mesh des benutzerdefinierten Elements muss auf den Bereich „ [-1 ,1] “ normalisiert sein, da die Datenskalierung sonst nicht korrekt ist.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch „ scaling “ und „ positionAbsolute “.
shadowCasting : bool
Legt fest, ob für das Element Schatten geworfen werden. Die Standardeinstellung ist „ true “. Bei „ false “ wirft das Element keine Schatten, unabhängig von „ ShadowQuality “.
textureFile : string
Der Name der Texturdatei für das Element. Wird dieser nicht festgelegt, wird eine einfarbige graue Textur verwendet.
Hinweis: Um Speicherplatz zu sparen, wird die aus der Datei geladene „ QImage “ gelöscht, sobald eine Textur erstellt wurde.
visible : bool
Die Sichtbarkeit des Elements. Standardwert ist „ true “.
Methodendokumentation
void setRotationAxisAndAngle(vector3d axis, real angle)
Eine Hilfsfunktion zur Konstruktion des Rotationsquaternions anhand von axis und angle.
Siehe auch rotation.
© 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.
