Custom3DItem QML Type
Ajoute un élément personnalisé à un graphique. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | QCustom3DItem |
| Inherited By: |
- Liste de tous les membres, y compris les membres hérités
- Custom3DItem fait partie de Qt Graphs QML Types for 3D.
Propriétés
- meshFile : string
- position : vector3d
- positionAbsolute : bool
- rotation : quaternion
- rotationAbsolute : bool
(since 6.11) - scaling : vector3d
- scalingAbsolute : bool
- shadowCasting : bool
- textureFile : string
- visible : bool
Signaux
- meshFileChanged(string meshFile)
- positionAbsoluteChanged(bool positionAbsolute)
- positionChanged(vector3d position)
- rotationChanged(quaternion rotation)
- scalingAbsoluteChanged(bool scalingAbsolute)
- scalingChanged(vector3d scaling)
- shadowCastingChanged(bool shadowCasting)
- textureFileChanged(string textureFile)
- visibleChanged(bool visible)
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
Nom du fichier de maillage de l'élément. L'élément du fichier doit être au format mesh. Il est recommandé d'inclure les sommets, les normales et les UV dans les fichiers de maillage.
position : vector3d
La position de l'élément sous forme de 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).
rotationAbsolute : bool [since 6.11]
Définit si la rotation de l'élément doit être traitée en valeurs de données ou en valeurs absolues. La valeur par défaut est true. Les éléments avec une rotation absolue seront tournés avec les coordonnées par défaut, quel que soit l'axe. Les éléments dont la rotation est basée sur des données seront tournés en fonction des coordonnées de l'axe.
Cette propriété a été introduite dans Qt 6.11.
Voir aussi rotation.
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.
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.
Note : Dans Qt 6.8, les modèles étaient incorrectement supposés être mis à l'échelle à une taille de 1 (-0.5...0.5) par défaut, alors qu'ils sont en réalité mis à l'échelle à une taille de 2 (-1...1). À cause de cela, tous les éléments personnalisés à partir de Qt 6.9 ont une taille deux fois supérieure à celle de Qt 6.8.
Voir aussi scalingAbsolute.
scalingAbsolute : bool
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.
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 sur les signaux
meshFileChanged(string meshFile)
Ce signal est émis lorsque meshFile devient meshFile.
Note : Le gestionnaire correspondant est onMeshFileChanged.
positionAbsoluteChanged(bool positionAbsolute)
Ce signal est émis lorsque positionAbsolute devient positionAbsolute.
Note : Le gestionnaire correspondant est onPositionAbsoluteChanged.
positionChanged(vector3d position)
Ce signal est émis lorsque l'élément position est remplacé par position.
Note : Le gestionnaire correspondant est onPositionChanged.
rotationChanged(quaternion rotation)
Ce signal est émis lorsque rotation devient rotation.
Note : Le gestionnaire correspondant est onRotationChanged.
scalingAbsoluteChanged(bool scalingAbsolute)
Ce signal est émis lorsque scalingAbsolute devient scalingAbsolute.
Note : Le gestionnaire correspondant est onScalingAbsoluteChanged.
scalingChanged(vector3d scaling)
Ce signal est émis lorsque scaling devient scaling.
Note : Le gestionnaire correspondant est onScalingChanged.
shadowCastingChanged(bool shadowCasting)
Ce signal est émis lorsque shadowCasting devient shadowCasting.
Note : Le gestionnaire correspondant est onShadowCastingChanged.
textureFileChanged(string textureFile)
Ce signal est émis lorsque textureFile devient textureFile.
Note : Le gestionnaire correspondant est onTextureFileChanged.
visibleChanged(bool visible)
Ce signal est émis lorsque visible devient visible.
Note : Le gestionnaire correspondant est onVisibleChanged.
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.
