Custom3DItem QML Type
Fügt ein benutzerdefiniertes Element zu einem Diagramm hinzu. Mehr...
| Import Statement: | import QtDataVisualization 1.11 |
| 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 hat ein benutzerdefiniertes Mesh, Position, Skalierung, Drehung und eine optionale Textur.
Dokumentation der Eigenschaft
meshFile : string
Der Dateiname des Objektmeshs. Das Element in der Datei muss im Wavefront OBJ-Format vorliegen und Eckpunkte, Normalen und UVs enthalten. Es muss auch Dreiecke enthalten. Wenn in der Datei entweder Normalen oder UVs fehlen, schlägt das Laden mit einer Fehlermeldung in der Konsolenausgabe fehl und das Objekt wird nicht gerendert.
position : vector3d
Die Position des Artikels als vector3d Typ. Der Standardwert ist vector3d(0.0, 0.0, 0.0).
Die Elementposition wird entweder in Datenkoordinaten oder in absoluten Koordinaten angegeben, je nach dem 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 eines 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 sich innerhalb der Achsenbereiche befinden.
Siehe auch position.
rotation : quaternion
Die Artikeldrehung als quaternion. Der Standardwert ist quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d
Das Element Skalierung als vector3d Typ. Der Standardwert ist vector3d(0.1, 0.1, 0.1).
Die Skalierung der Elemente 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 [since QtDataVisualization 1.2]
Legt fest, ob die Skalierung von Objekten in Datenwerten oder in absoluten Werten erfolgen soll. Der Standardwert ist true. Elemente mit absoluter Skalierung werden unabhängig von den Achsenbereichen in derselben 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 den Gegenstand aktiviert ist. Der Standardwert ist true. Wenn false, wirft der Gegenstand unabhängig von ShadowQuality keinen Schatten.
textureFile : string
Der Name der Texturdatei für das Objekt. Wenn diese Option nicht gesetzt ist, wird eine einfarbig graue Textur verwendet.
Hinweis: Um Speicherplatz zu sparen, wird die aus der Datei geladene QImage nach der Erstellung einer Textur gelöscht.
visible : bool
Die Sichtbarkeit des Objekts. Der Standardwert ist true.
Methode Dokumentation
void setRotationAxisAndAngle(vector3d axis, real angle)
Eine Komfortfunktion, um die Rotationsquaternion aus axis und angle zu konstruieren.
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.
