Custom3DItem QML Type
Fügt ein benutzerdefiniertes Element zu einem Diagramm hinzu. Mehr...
| Import Statement: | import QtDataVisualization 1.8 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: |
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)
Detaillierte Beschreibung
Ein benutzerdefiniertes Element verfügt über ein benutzerdefiniertes Netz, Position, Skalierung, Drehung und eine optionale Textur.
Eigenschaft Dokumentation
meshFile : string |
Der Name der Mesh-Datei des Elements. Das Element in der Datei muss im Wavefront OBJ-Format vorliegen und Eckpunkte, Normalen und UVs enthalten. Es muss auch in Dreiecken vorliegen. Wenn in der Datei entweder Normalen oder UVs fehlen, schlägt das Laden mit einer Fehlermeldung in der Konsolenausgabe fehl und das Element wird nicht gerendert.
position : vector3d |
Die Position des Objekts als vector3d Typ. Die Standardeinstellung ist vector3d(0.0, 0.0, 0.0).
Die Elementposition wird entweder in Datenkoordinaten oder in absoluten Koordinaten angegeben, abhängig vom Wert der Eigenschaft positionAbsolute. Bei Verwendung absoluter Koordinaten liegen Werte zwischen -1.0...1.0 innerhalb von Achsenbereichen.
Hinweis: Elemente, die außerhalb eines Achsenbereichs positioniert sind, werden nicht gerendert, wenn positionAbsolute false ist, es sei denn, das Element ist ein Custom3DVolume, das teilweise sichtbar wäre, und scalingAbsolute ist auch false. In diesem Fall wird der sichtbare Teil des Volumens gerendert.
Siehe auch positionAbsolute und scalingAbsolute.
positionAbsolute : bool |
Legt fest, ob die Position des Elements in Datenkoordinaten oder in absoluten Koordinaten behandelt werden soll. Der Standardwert ist false. Elemente mit absoluten Koordinaten werden immer gerendert, während Elemente mit Datenkoordinaten nur gerendert werden, wenn sie innerhalb der Achsenbereiche liegen.
Siehe auch position.
rotation : quaternion |
Die Artikeldrehung als quaternion. Der Standardwert ist quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d |
Die Skalierung des Elements als vector3d Typ. Der Standardwert ist vector3d(0.1, 0.1, 0.1).
Die Skalierung von Elementen wird entweder in Datenwerten oder in absoluten Werten angegeben, je nach dem Wert der Eigenschaft scalingAbsolute. Der Standardvektor, der als absolute Werte interpretiert wird, setzt das Element auf 10 % der Höhe des Diagramms, vorausgesetzt, das Elementnetz ist normalisiert und die Seitenverhältnisse des Diagramms wurden nicht gegenüber den Standardwerten geändert.
Siehe auch scalingAbsolute.
scalingAbsolute : bool |
Legt fest, ob die Skalierung der Elemente in Datenwerten oder in absoluten Werten erfolgen soll. Der Standardwert ist true. Elemente mit absoluter Skalierung werden unabhängig von den Achsenbereichen in der gleichen Größe dargestellt. Elemente mit Datenskalierung ändern ihre sichtbare Größe entsprechend den Achsenbereichen. Wenn positionAbsolute gleich true ist, wird diese Eigenschaft ignoriert und die Skalierung wird als absoluter Wert interpretiert. Wenn das Element eine Drehung aufweist, wird die Datenskalierung für das nicht gedrehte Element berechnet. Analog dazu wird bei Custom3DVolume die Bereichsbeschneidung für das nicht gedrehte Element berechnet.
Hinweis: Für Custom3DLabel Elemente oder für benutzerdefinierte Elemente, die in polar Diagrammen verwendet werden, wird nur die absolute Skalierung unterstützt.
Hinweis: Das Netz des benutzerdefinierten Elements muss auf den Bereich [-1 ,1] normalisiert werden, sonst ist die Skalierung der Daten nicht genau.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Siehe auch scaling und positionAbsolute.
shadowCasting : bool |
Legt fest, ob der Schattenwurf für das Element aktiviert ist. Der Standardwert ist true. Wenn false, wirft das Objekt keine Schatten, unabhängig von ShadowQuality.
textureFile : string |
Der Name der Texturdatei für den Gegenstand. Wenn diese Option nicht gesetzt ist, wird eine einfarbig graue Textur verwendet.
Hinweis: Um Speicher zu sparen, wird die aus der Datei geladene QImage gelöscht, nachdem eine Textur erstellt wurde.
visible : bool |
Die Sichtbarkeit des Objekts. Die Standardeinstellung ist true.
Dokumentation der Methode
Eine Komfortfunktion, um die Rotationsquaternion aus axis und angle zu konstruieren.
Siehe auch rotation.
© 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.
