Back to Qt.io
Contact Us Blog Download Qt

Custom3DItem QML Type

Fügt ein benutzerdefiniertes Element zu einem Diagramm hinzu. Mehr...

Import Statement: import QtGraphs
In C++: QCustom3DItem
Inherited By:

Custom3DLabel and Custom3DVolume

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Ein benutzerdefiniertes Element hat ein benutzerdefiniertes Mesh, 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 Mesh-Format vorliegen. Es wird empfohlen, dass die Mesh-Dateien Eckpunkte, Normalen und UVs enthalten.


position : vector3d

Die Position des Elements als vector3d. 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 der Verwendung absoluter Koordinaten liegen die Werte zwischen -1.0...1.0 innerhalb der Achsenbereiche.

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 von Achsenbereichen 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.

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 der Gegenstand 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.


Signal Dokumentation

meshFileChanged(string meshFile)

Dieses Signal wird ausgegeben, wenn meshFile zu meshFile wechselt.

Hinweis: Der entsprechende Handler ist onMeshFileChanged.


positionAbsoluteChanged(bool positionAbsolute)

Dieses Signal wird ausgegeben, wenn positionAbsolute zu positionAbsolute wechselt.

Hinweis: Der entsprechende Handler ist onPositionAbsoluteChanged.


positionChanged(vector3d position)

Dieses Signal wird ausgegeben, wenn sich der Eintrag position in position ändert.

Hinweis: Der entsprechende Handler ist onPositionChanged.


rotationChanged(quaternion rotation)

Dieses Signal wird ausgegeben, wenn rotation zu rotation wechselt.

Hinweis: Der entsprechende Handler ist onRotationChanged.


scalingAbsoluteChanged(bool scalingAbsolute)

Dieses Signal wird ausgegeben, wenn scalingAbsolute zu scalingAbsolute wechselt.

Hinweis: Der entsprechende Handler ist onScalingAbsoluteChanged.


scalingChanged(vector3d scaling)

Dieses Signal wird ausgegeben, wenn scaling zu scaling wechselt.

Hinweis: Der entsprechende Handler ist onScalingChanged.


shadowCastingChanged(bool shadowCasting)

Dieses Signal wird ausgegeben, wenn shadowCasting zu shadowCasting wechselt.

Hinweis: Der entsprechende Handler ist onShadowCastingChanged.


textureFileChanged(string textureFile)

Dieses Signal wird ausgegeben, wenn textureFile zu textureFile wechselt.

Hinweis: Der entsprechende Handler ist onTextureFileChanged.


visibleChanged(bool visible)

Dieses Signal wird ausgegeben, wenn visible zu visible wechselt.

Hinweis: Der entsprechende Handler ist onVisibleChanged.


Dokumentation der Methode

void setRotationAxisAndAngle(vector3d axis, real angle)

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.