Custom3DItem QML Type
Ajoute un élément personnalisé à un graphique. Plus d'informations...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: |
Propriétés
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- scaling : vector3d
- scalingAbsolute : bool
(since QtDataVisualization 1.2) - shadowCasting : bool
- textureFile : string
- visible : bool
Méthodes
- void setRotationAxisAndAngle(vector3d axis, real angle)
Description détaillée
Un élément personnalisé possède un maillage personnalisé, une position, une mise à l'échelle, une rotation et une texture optionnelle.
Documentation sur les propriétés
meshFile : string
Le nom du fichier de maillage de l'élément. L'élément dans le fichier doit être au format Wavefront OBJ et inclure les sommets, les normales et les UV. Il doit également être en triangles. Si le fichier manque de normales ou d'UV, le chargement échouera avec un message d'erreur sur la console et l'élément ne sera pas rendu.
position : vector3d
La position de l'article en tant que type vector3d. La valeur par défaut est vector3d(0.0, 0.0, 0.0).
La position de l'élément est spécifiée soit en coordonnées de données, soit en coordonnées absolues, en fonction de la valeur de la propriété positionAbsolute. Lors de l'utilisation de coordonnées absolues, les valeurs comprises entre -1.0...1.0 sont comprises dans les plages d'axes.
Remarque : les éléments positionnés en dehors de toute plage d'axes ne sont pas rendus si positionAbsolute est false, sauf s'il s'agit d'un élément Custom3DVolume qui serait partiellement visible et que scalingAbsolute est également false. Dans ce cas, la partie visible du volume sera rendue.
Voir également positionAbsolute et scalingAbsolute.
positionAbsolute : bool
Définit si la position de l'élément doit être traitée en coordonnées de données ou en coordonnées absolues. La valeur par défaut est false. Les éléments dont les coordonnées sont absolues sont toujours rendus, tandis que les éléments dont les coordonnées sont des données ne sont rendus que s'ils se situent dans les plages de l'axe.
Voir également position.
rotation : quaternion
La rotation de l'article se fait sous la forme d'un quaternion. La valeur par défaut est quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d
L'échelle de l'élément en tant que type vector3d. La valeur par défaut est vector3d(0.1, 0.1, 0.1).
La mise à l'échelle de l'élément est spécifiée soit en valeurs de données, soit en valeurs absolues, en fonction de la valeur de la propriété scalingAbsolute. Le vecteur par défaut interprété en valeurs absolues définit l'élément à 10 % de la hauteur du graphique, à condition que le maillage de l'élément soit normalisé et que les rapports d'aspect du graphique n'aient pas été modifiés par rapport aux valeurs par défaut.
Voir également scalingAbsolute.
scalingAbsolute : bool [since QtDataVisualization 1.2]
Définit si la mise à l'échelle des éléments doit être gérée en valeurs de données ou en valeurs absolues. La valeur par défaut est true. Les éléments avec une mise à l'échelle absolue seront rendus à la même taille, quelles que soient les plages de l'axe. Les éléments avec une mise à l'échelle des données changeront leur taille apparente en fonction des plages de l'axe. Si positionAbsolute est true, cette propriété est ignorée et la mise à l'échelle est interprétée comme une valeur absolue. Si l'élément a une rotation, la mise à l'échelle des données est calculée sur l'élément non tourné. De même, pour les éléments Custom3DVolume, l'écrêtage de la plage est calculé sur l'élément non tourné.
Remarque : seule la mise à l'échelle absolue est prise en charge pour les éléments Custom3DLabel ou pour les éléments personnalisés utilisés dans les graphiques polar.
Remarque : Le maillage de l'élément personnalisé doit être normalisé en fonction de la plage [-1 ,1], sinon la mise à l'échelle des données ne sera pas précise.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également scaling et positionAbsolute.
shadowCasting : bool
Définit si la projection d'ombres est activée pour l'élément. La valeur par défaut est true. Si false, l'élément ne projette pas d'ombres, quelle que soit la valeur de ShadowQuality.
textureFile : string
Le nom du fichier de texture de l'élément. Si ce paramètre n'est pas défini, une texture gris uni sera utilisée.
Remarque : pour économiser de la mémoire, le site QImage chargé à partir du fichier est effacé après la création d'une texture.
visible : bool
La visibilité de l'élément. La valeur par défaut est true.
Documentation de la méthode
void setRotationAxisAndAngle(vector3d axis, real angle)
Une fonction de commodité pour construire le quaternion de rotation à partir de axis et angle.
Voir également 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.
