Custom3DItem QML Type

Ajoute un élément personnalisé à un graphique. En savoir plus…

• Liste de tous les membres, y compris les membres hérités
• Custom3DItem fait partie des types QML 3D d'Qt Graphs .

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é 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 de maillage. Il est recommandé que les fichiers de maillage contiennent les sommets, les normales et les coordonnées UV.

position : vector3d

La position de l'élément est définie par la propriété ` 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 l'on utilise des coordonnées absolues, les valeurs comprises entre -1.0...1.0 se situent dans les plages des axes.

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).

rotationAbsolute : bool [since 6.11]

Détermine si la rotation des éléments doit être gérée en fonction des valeurs de données ou en valeurs absolues. La valeur par défaut est « true ». Les éléments dont la rotation est définie en valeurs absolues seront pivotés selon les coordonnées par défaut, quel que soit l’axe. Les éléments dont la rotation est définie en fonction des données pivoteront selon les coordonnées de l’axe.

Cette propriété a été introduite dans Qt 6.11.

Voir également rotation.

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

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 positionAbsolute est défini 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é.

Voir également scaling et positionAbsolute.

shadowCasting : bool

Définit si le rendu des ombres pour l'élément est activé. La valeur par défaut est « true ». Si la valeur est « false », l'élément ne projette pas d'ombres, 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.

visible : bool

La visibilité de l'élément. La valeur par défaut est « true ».

Documentation Signal

meshFileChanged(string meshFile)

Ce signal est émis lorsque meshFile devient meshFile.

positionAbsoluteChanged(bool positionAbsolute)

Ce signal est émis lorsque positionAbsolute devient positionAbsolute.

positionChanged(vector3d position)

Ce signal est émis lorsque l'élément position passe à position.

rotationChanged(quaternion rotation)

Ce signal est émis lorsque rotation devient rotation.

scalingAbsoluteChanged(bool scalingAbsolute)

Ce signal est émis lorsque scalingAbsolute devient scalingAbsolute.

scalingChanged(vector3d scaling)

Ce signal est émis lorsque scaling devient scaling.

shadowCastingChanged(bool shadowCasting)

Ce signal est émis lorsque shadowCasting devient shadowCasting.

textureFileChanged(string textureFile)

Ce signal est émis lorsque textureFile devient textureFile.

visibleChanged(bool visible)

Ce signal est émis lorsque visible devient visible.

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.