Surface3DSeries QML Type (Uncreatable)

Représente une série de données sous la forme d'un graphique de surface en 3D. En savoir plus...

Remarque : il s'agit d'un type non créable. Il ne peut pas être instancié dans QML.

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

Propriétés

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• dataArray : SurfaceDataArray
• dataProxy : SurfaceDataProxy
• drawMode : DrawFlag
• flatShadingSupported : bool
• invalidSelectionPosition : point
• itemLabel : string
• itemLabelFormat : string
• itemLabelVisible : bool
• lightingMode : Abstract3DSeries.LightingMode (since 6.10)
• mesh : Abstract3DSeries.Mesh
• meshRotation : quaternion
• meshSmooth : bool
• multiHighlightColor : color
• multiHighlightGradient : Gradient
• name : string
• selectedPoint : point
• shading : Shading
• singleHighlightColor : color
• singleHighlightGradient : Gradient
• textureFile : string
• type : Abstract3DSeries.SeriesType
• userDefinedMesh : string
• visible : bool
• wireframeColor : color

Signaux

• baseColorChanged(color color)
• baseGradientChanged(Gradient gradient)
• colorStyleChanged(GraphsTheme.ColorStyle style)
• dataArrayChanged(SurfaceDataArray array)
• dataProxyChanged(SurfaceDataProxy proxy)
• drawModeChanged(DrawFlag mode)
• flatShadingSupportedChanged(bool enable)
• itemLabelChanged(string label)
• itemLabelFormatChanged(string format)
• itemLabelVisibilityChanged(bool visible)
• lightingModeChanged(Abstract3DSeries.LightingMode lightingMode) (since 6.10)
• meshChanged(Abstract3DSeries.Mesh mesh)
• meshRotationChanged(quaternion rotation)
• meshSmoothChanged(bool enabled)
• multiHighlightColorChanged(color color)
• multiHighlightGradientChanged(Gradient gradient)
• nameChanged(string name)
• rowsSanitizedChanged(bool enabled)
• selectedPointChanged(point position)
• shadingChanged(const Shading shading)
• singleHighlightColorChanged(color color)
• singleHighlightGradientChanged(Gradient gradient)
• textureFileChanged(string filename)
• userDefinedMeshChanged(string fileName)
• visibilityChanged(bool visible)
• wireframeColorChanged(color color)

Méthodes

• void setMeshAxisAndAngle(vector3d axis, real angle)

Description détaillée

Ce type gère les éléments visuels spécifiques à la série, ainsi que les données de la série (via un proxy de données).

Surface3DSeries prend en charge les balises de format suivantes pour itemLabelFormat :

Pour une description plus complète, consultez QSurface3DSeries.

Voir également Qt Graphs Traitement des données en 3D.

Documentation sur les propriétés

baseColor : color

La couleur de base de la série.

Voir également colorStyle et GraphsTheme.seriesColors.

baseGradient : Gradient

Le gradient de base de la série.

Voir aussi colorStyle.

colorStyle : GraphsTheme.ColorStyle

Le style de couleurs de la série.

Voir aussi GraphsTheme.ColorStyle.

dataArray : SurfaceDataArray

Contient la référence du tableau de données.

dataArrayChanged Un signal est émis lorsque le tableau de données est défini, sauf si « newDataArray » est identique au précédent.

dataProxy : SurfaceDataProxy

Le proxy de données actif. La série prend en charge tout proxy qui lui est attribué et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ni désigné comme une autre série.

drawMode : DrawFlag

Définit le mode de dessin sur l'une des valeurs suivantes : Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface}. Il faut choisir soit « DrawWireframe », soit « DrawSurface ».

flatShadingSupported : bool [read-only]

Indique si l'ombrage plat des surfaces est pris en charge par le système actuel. Cela nécessite au moins la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4.

invalidSelectionPosition : point [read-only]

Une propriété constante fournissant une position de sélection non valide. Cette position est attribuée à la propriété selectedPoint afin d'effacer la sélection de cette série.

Voir également GraphsItem3D::clearSelection().

itemLabel : string [read-only]

L'étiquette de l'élément mis en forme. S'il n'y a pas d'élément sélectionné ou si l'élément sélectionné n'est pas visible, renvoie une chaîne vide.

Voir également itemLabelFormat.

itemLabelFormat : string

Format d'étiquette pour les éléments de données de cette série. Ce format est utilisé pour les étiquettes d'élément unique, par exemple lorsqu'un élément est sélectionné. L'interprétation de ce format dépend du type de série.

Voir également Bar3DSeries, Scatter3DSeries et Surface3DSeries.

itemLabelVisible : bool

Si true, les libellés des éléments sont affichés sous forme de libellés flottants dans le graphique. Dans le cas contraire, ils ne s'affichent pas. Pour afficher le libellé d'un élément dans un contrôle externe, cette propriété doit être définie sur false. La valeur par défaut est true.

Voir également itemLabelFormat et itemLabel.

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

Mode d'éclairage des éléments de la série. La valeur par défaut est QAbstract3DSeries::LightingMode::Shaded

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

Voir également QAbstract3DSeries::LightingMode.

mesh : Abstract3DSeries.Mesh

Le maillage des éléments de la série, ou le pointeur de sélection dans le cas de Surface3DSeries. Si le maillage est de type Abstract3DSeries.Mesh.UserDefined, la propriété userDefinedMesh doit également être définie pour que les éléments s’affichent correctement. La valeur par défaut dépend du type de graphique.

Voir également QAbstract3DSeries::Mesh.

meshRotation : quaternion

Rotation du maillage appliquée à tous les éléments de la série. La rotation doit être un quaternion normalisé. Pour les types de séries prenant en charge une rotation spécifique à chaque élément, les rotations sont multipliées entre elles. L’option « Bar3DSeries » ignore toute rotation qui ne s’effectue pas autour de l’axe y. L’option « Surface3DSeries » applique la rotation uniquement au pointeur de sélection. Par défaut, aucune rotation n’est appliquée.

meshSmooth : bool

Si la valeur est définie sur « true », les versions lissées des maillages prédéfinis, définies via la propriété « mesh », sont utilisées. Cette propriété n’affecte pas les maillages personnalisés utilisés lorsque la propriété « mesh » est définie sur « Abstract3DSeries.Mesh.UserDefined ». La valeur par défaut est « false ».

multiHighlightColor : color

Couleur de mise en évidence des éléments multiples de la série.

Voir également colorStyle et GraphsTheme.multiHighlightColor.

multiHighlightGradient : Gradient

Le dégradé de mise en évidence de plusieurs éléments de la série.

Voir également colorStyle et GraphsTheme.multiHighlightGradient.

name : string

Le nom de la série. Il peut être utilisé sous forme d'étiquette d'élément avec la balise @seriesName.

Voir également itemLabelFormat.

selectedPoint : point

Définit le point de la grille de surface à la position spécifiée par une ligne et une colonne du tableau de données de la série sélectionnée. Un seul point peut être sélectionné à la fois.

Pour effacer la sélection de cette série, attribuez la valeur invalidSelectionPosition à la position. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction des interactions de l'utilisateur ou si elle devient invalide.

La suppression ou l’insertion de lignes dans la série avant la ligne du point sélectionné ajustera la sélection de manière à ce que ce même point reste sélectionné.

Voir également GraphsItem3D::clearSelection().

shading : Shading

Active l'ombrage plat de la surface. La valeur par défaut est « Surface3DSeries.Shading.Flat ». Lorsque cette option est désactivée, les normales de la surface sont interpolées, ce qui donne un aspect arrondi aux arêtes. Lorsqu'elle est activée, les normales restent identiques sur un triangle, ce qui rend la couleur du triangle uniforme. Cela améliore la lisibilité des données du modèle.

singleHighlightColor : color

La couleur de mise en évidence d'un élément unique de la série.

Voir également colorStyle et GraphsTheme.singleHighlightColor.

singleHighlightGradient : Gradient

L'élément unique qui met en valeur le dégradé de la série.

Voir également colorStyle et GraphsTheme.singleHighlightGradient.

textureFile : string

Nom du fichier de texture correspondant à la texture de surface. Pour effacer la texture, on indique un nom de fichier vide.

type : Abstract3DSeries.SeriesType [read-only]

Le type de la série. L'une des valeurs de l'QAbstract3DSeries::SeriesType.

userDefinedMesh : string

Le nom de fichier d'un maillage personnalisé défini par l'utilisateur pour les objets, utilisé lors de l'mesh, est Abstract3DSeries.Mesh.UserDefined.

visible : bool

La visibilité de la série. Si false, la série n'est pas affichée.

wireframeColor : color

La couleur utilisée pour tracer les lignes de la grille du fil de fer de la surface.

Documentation sur les signaux

baseColorChanged(color color)

Ce signal est émis lorsque baseColor devient color.

baseGradientChanged(Gradient gradient)

Ce signal est émis lorsque baseGradient devient gradient.

colorStyleChanged(GraphsTheme.ColorStyle style)

Ce signal est émis lorsque colorStyle devient style.

dataArrayChanged(SurfaceDataArray array)

Ce signal est émis lorsque dataArray devient array.

dataProxyChanged(SurfaceDataProxy proxy)

Ce signal est émis lorsque dataProxy devient proxy.

drawModeChanged(DrawFlag mode)

Ce signal est émis lorsque drawMode devient mode.

flatShadingSupportedChanged(bool enable)

Ce signal est émis lorsque flatShadingSupported devient enable.

itemLabelChanged(string label)

Ce signal est émis lorsque itemLabel devient label.

itemLabelFormatChanged(string format)

Ce signal est émis lorsque itemLabelFormat devient format.

itemLabelVisibilityChanged(bool visible)

Ce signal est émis lorsque la propriété `itemLabelVisibility` passe à la valeur ` visible`.

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

Ce signal est émis lorsque lightingMode devient lightingMode.

Ce signal a été introduit dans Qt 6.10.

meshChanged(Abstract3DSeries.Mesh mesh)

Ce signal est émis lorsque mesh devient mesh.

meshRotationChanged(quaternion rotation)

Ce signal est émis lorsque meshRotation devient rotation.

meshSmoothChanged(bool enabled)

Ce signal est émis lorsque l'meshSmooth passe à enabled.

multiHighlightColorChanged(color color)

Ce signal est émis lorsque multiHighlightColor devient color.

multiHighlightGradientChanged(Gradient gradient)

Ce signal est émis lorsque multiHighlightGradient devient gradient.

nameChanged(string name)

Ce signal est émis lorsque name devient name.

rowsSanitizedChanged(bool enabled)

Ce signal est émis lorsque la valeur de `rowsSanitized` passe à ` enabled`.

selectedPointChanged(point position)

Ce signal est émis lorsque selectedPoint devient position.

shadingChanged(const Shading shading)

Ce signal est émis lorsque shading devient shading.

singleHighlightColorChanged(color color)

Ce signal est émis lorsque singleHighlightColor devient color.

singleHighlightGradientChanged(Gradient gradient)

Ce signal est émis lorsque singleHighlightGradient devient gradient.

textureFileChanged(string filename)

Ce signal est émis lorsque textureFile devient filename.

userDefinedMeshChanged(string fileName)

Ce signal est émis lorsque userDefinedMesh devient fileName.

visibilityChanged(bool visible)

Ce signal est émis lorsque la visibilité de la série passe à « visible ».

wireframeColorChanged(color color)

Ce signal est émis lorsque wireframeColor devient color.

Documentation de la méthode

void setMeshAxisAndAngle(vector3d axis, real angle)

Une fonction pratique permettant de construire un quaternion de rotation de maillage à partir de axis et angle.

Voir également meshRotation.