Custom3DItem QML Type
Ajoute un élément personnalisé à un graphique. En savoir plus…
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.1 |
| In C++: | QCustom3DItem |
| Inherited By: | |
| Status: | Deprecated |
Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.
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é dispose d'un maillage, d'une position, d'une échelle et d'une rotation personnalisés, ainsi que d'une texture facultative.
Documentation des propriétés
meshFile : string
Nom du fichier de maillage de l'élément. L'élément contenu dans le fichier doit être au format Wavefront OBJ et comporter des sommets, des normales et des coordonnées UV. Il doit également être constitué de triangles. Si le fichier ne contient ni normales ni coordonnées UV, le chargement échouera et un message d'erreur s'affichera dans la console ; l'élément ne sera pas rendu.
position : vector3d
La position de l'élément est de 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, selon la valeur de la propriété ` positionAbsolute `. Lorsque des coordonnées absolues sont utilisées, les valeurs comprises entre ` -1.0...1.0 ` se situent dans les plages des axes.
Remarque : les éléments positionnés en dehors de toute plage d’axe ne sont pas affichés si positionAbsolute est défini sur false, sauf si l’élément est un Custom3DVolume qui serait partiellement visible et si scalingAbsolute est également défini sur false. Dans ce cas, la partie visible du volume sera affichée.
Voir également positionAbsolute et scalingAbsolute.
positionAbsolute : bool
Détermine si la position des éléments doit être gérée en coordonnées de données ou en coordonnées absolues. La valeur par défaut est « false ». Les éléments avec des coordonnées absolues seront toujours affichés, tandis que ceux avec des coordonnées de données ne seront affichés que s'ils se trouvent dans les plages des axes.
Voir également position.
rotation : quaternion
La rotation des éléments est définie par l'quaternion. La valeur par défaut est quaternion(0.0, 0.0, 0.0, 0.0).
scaling : vector3d
La mise à 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 des éléments est spécifiée soit en valeurs de données, soit en valeurs absolues, selon la valeur de la propriété « scalingAbsolute ». Le vecteur par défaut, interprété comme des valeurs absolues, définit l'élément à 10 % de la hauteur du graphique, à condition que la maillage de l'élément soit normalisé et que les proportions du graphique n'aient pas été modifiées par rapport aux valeurs par défaut.
Voir également scalingAbsolute.
scalingAbsolute : bool [since QtDataVisualization 1.2]
Détermine si la mise à l'échelle des éléments doit être gérée en fonction des valeurs des données ou en valeurs absolues. La valeur par défaut est « true ». Les éléments dont la mise à l'échelle est absolue seront affichés à la même taille, quelles que soient les plages des axes. Les éléments dont la mise à l'échelle s'effectue en fonction des données verront leur taille apparente varier en fonction des plages des axes. Si la propriété « positionAbsolute » est définie sur « true », cette propriété est ignorée et la mise à l'échelle est interprétée comme une valeur absolue. Si l'élément est en rotation, la mise à l'échelle en fonction des données est calculée sur l'élément non pivoté. De même, pour les éléments Custom3DVolume, le découpage de plage est calculé sur l'élément non pivoté.
Remarque : seul le redimensionnement absolu est pris en charge pour les éléments Custom3DLabel ou pour les éléments personnalisés utilisés dans les graphiques de type « polar ».
Remarque : le maillage de l’élément personnalisé doit être normalisé sur l’intervalle [-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étermine si l'ombrage de l'élément est activé. La valeur par défaut est « true ». Si la valeur est « false », l'élément ne projette pas d'ombre, quelle que soit la valeur de « ShadowQuality ».
textureFile : string
Nom du fichier de texture de l'élément. Si ce paramètre n'est pas défini, une texture grise unie sera utilisée.
Remarque : afin d’ économiser de la mémoire, l’ QImage e chargée à partir du fichier est effacée une fois la texture créée.
visible : bool
Visibilité de l'élément. Valeur par défaut : « true ».
Documentation de la méthode
void setRotationAxisAndAngle(vector3d axis, real angle)
Une fonction pratique permettant de 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.
