Surface3DSeries QML Type
Représente une série de données dans un graphique de surface 3D. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | QSurface3DSeries |
| Inherits: |
- Liste de tous les membres, y compris les membres hérités
- Surface3DSeries fait partie de Qt Graphs QML Types for 3D.
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)
- 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 :
| @xTitle | Titre de l'axe des x |
| @yTitle | Titre de l'axe des y |
| @zTitle | Titre de l'axe des z |
| @xLabel | Valeur de l'élément formatée selon le format de l'axe des x. Pour plus d'informations, voir labelFormat. |
| @yLabel | Valeur de l'élément formatée selon le format de l'axe des y. Pour plus d'informations, voir labelFormat. |
| @zLabel | Valeur de l'élément formatée en utilisant le format de l'axe des z. Pour plus d'informations, voir labelFormat. |
| @seriesName | Nom de la série |
Pour une description plus complète, voir QSurface3DSeries.
Voir également Qt Graphs Data Handling with 3D.
Documentation des 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 également colorStyle.
colorStyle : GraphsTheme.ColorStyle |
Le style de couleur de la série.
Voir également GraphsTheme.ColorStyle.
dataArray : SurfaceDataArray |
Contient la référence du tableau de données.
dataArrayChanged Le signal est émis lorsque le tableau de données est défini, sauf si newDataArray est identique au précédent.
Remarque : avant de faire quoi que ce soit concernant le tableau de données, une série doit être créée pour le proxy concerné.
dataProxy : SurfaceDataProxy |
Le proxy de données actif. La série assume la propriété de tout proxy qui lui est associé et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ou associé à une autre série.
drawMode : DrawFlag |
Définit le mode de dessin à l'une des valeurs suivantes : Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface}. L'option DrawWireframe ou DrawSurface doit être activée.
flatShadingSupported : bool |
Indique si l'ombrage plat des surfaces est pris en charge par le système actuel. Il faut au moins la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4.
Remarque : cette propriété en lecture seule prend sa valeur correcte après la première passe de rendu. Jusqu'à cette date, elle a toujours la valeur true.
invalidSelectionPosition : point |
Une propriété constante fournissant une position de sélection invalide. Cette position est affectée à la propriété selectedPoint pour effacer la sélection de cette série.
Voir également GraphsItem3D::clearSelection().
itemLabel : string |
L'étiquette formatée de l'élément. S'il n'y a pas d'élément sélectionné ou si l'élément sélectionné n'est pas visible, cette propriété renvoie une chaîne vide.
Voir également itemLabelFormat.
itemLabelFormat : string |
Format de l'étiquette pour les éléments de données de cette série. Ce format est utilisé pour les étiquettes d'éléments uniques, par exemple lorsqu'un élément est sélectionné. L'interprétation du format dépend du type de série.
Voir également Bar3DSeries, Scatter3DSeries, et Surface3DSeries.
itemLabelVisible : bool |
Si true, les étiquettes d'éléments sont affichées sous forme d'étiquettes flottantes dans le graphique. Dans le cas contraire, les étiquettes des éléments ne sont pas affichées. Pour afficher l'étiquette de l'élément dans un contrôle externe, cette propriété est définie sur false. La valeur par défaut est true.
Voir également itemLabelFormat et itemLabel.
lightingMode : Abstract3DSeries.LightingMode |
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 Abstract3DSeries.Mesh.UserDefined, la propriété userDefinedMesh doit également être définie pour que les éléments soient rendus correctement. La valeur par défaut dépend du type de graphique.
Voir également QAbstract3DSeries::Mesh.
meshRotation : quaternion |
La 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 qui prennent en charge la rotation spécifique des éléments, les rotations sont multipliées ensemble. Bar3DSeries ignore toute rotation qui n'est pas autour de l'axe des y. Surface3DSeries applique la rotation uniquement au pointeur de sélection. Par défaut, il n'y a pas de rotation.
meshSmooth : bool |
Si true, des versions lisses de maillages prédéfinis définis via la propriété mesh sont utilisées. Cette propriété n'affecte pas les maillages personnalisés utilisés lorsque le maillage est défini 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 gradient de mise en évidence des éléments multiples 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 aussi 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 position invalidSelectionPosition. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction de l'interaction 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 le même point reste sélectionné.
Voir également GraphsItem3D::clearSelection().
shading : Shading |
Définit l'ombrage plat de la surface comme étant visible. Il est préréglé par défaut sur Surface3DSeries.Shading.Flat. Lorsqu'il est désactivé, les normales de la surface sont interpolées, ce qui donne un aspect arrondi aux bords. Lorsqu'il est visible, les normales sont conservées à l'identique sur un triangle, ce qui rend la couleur du triangle solide. Cela rend les données plus lisibles à partir du modèle.
Remarque : les surfaces ombrées plates nécessitent au moins la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4. La valeur de la propriété flatShadingSupported indique si l'ombrage plat est pris en charge au moment de l'exécution.
singleHighlightColor : color |
La couleur de mise en évidence d'un seul élément de la série.
Voir également colorStyle et GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient |
Le gradient de mise en évidence d'un seul élément de la série.
Voir également colorStyle et GraphsTheme.singleHighlightGradient.
textureFile : string |
Le nom du fichier de texture pour la texture de la surface. Pour effacer la texture, un nom de fichier vide est défini.
type : Abstract3DSeries.SeriesType |
Le type de la série. L'une des valeurs QAbstract3DSeries::SeriesType.
userDefinedMesh : string |
Le nom de fichier d'un maillage personnalisé défini par l'utilisateur pour les objets qui est utilisé lorsque mesh est Abstract3DSeries.Mesh.UserDefined.
Remarque : le fichier doit être au format de maillage QtQuick3D. Utilisez l'outil de conversion balsam pour créer un maillage à partir d'autres formats de modèles 3D.
visible : bool |
La visibilité de la série. Si false, la série n'est pas rendue.
wireframeColor : color |
La couleur utilisée pour dessiner les lignes de la grille de la surface.
Signal Documentation
baseColorChanged(color color) |
Ce signal est émis lorsque baseColor devient color.
Remarque : le gestionnaire correspondant est onBaseColorChanged.
baseGradientChanged(Gradient gradient) |
Ce signal est émis lorsque baseGradient est remplacé par gradient.
Remarque : Le gestionnaire correspondant est onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style) |
Ce signal est émis lorsque colorStyle devient style.
Note : Le gestionnaire correspondant est onColorStyleChanged.
dataArrayChanged(SurfaceDataArray array) |
Ce signal est émis lorsque dataArray devient array.
Note : Le gestionnaire correspondant est onDataArrayChanged.
dataProxyChanged(SurfaceDataProxy proxy) |
Ce signal est émis lorsque dataProxy devient proxy.
Note : Le gestionnaire correspondant est onDataProxyChanged.
drawModeChanged(DrawFlag mode) |
Ce signal est émis lorsque drawMode devient mode.
Note : Le gestionnaire correspondant est onDrawModeChanged.
flatShadingSupportedChanged(bool enable) |
Ce signal est émis lorsque flatShadingSupported devient enable.
Note : Le gestionnaire correspondant est onFlatShadingSupportedChanged.
itemLabelChanged(string label) |
Ce signal est émis lorsque itemLabel devient label.
Note : Le gestionnaire correspondant est onItemLabelChanged.
itemLabelFormatChanged(string format) |
Ce signal est émis lorsque itemLabelFormat devient format.
Note : Le gestionnaire correspondant est onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible) |
Ce signal est émis lorsque itemLabelVisibility devient visible.
Note : Le gestionnaire correspondant est onItemLabelVisibilityChanged.
|
Ce signal est émis lorsque lightingMode devient lightingMode.
Note : Le gestionnaire correspondant est onLightingModeChanged.
Ce signal a été introduit dans Qt 6.10.
meshChanged(Abstract3DSeries.Mesh mesh) |
Ce signal est émis lorsque mesh est remplacé par mesh.
Note : Le gestionnaire correspondant est onMeshChanged.
meshRotationChanged(quaternion rotation) |
Ce signal est émis lorsque meshRotation devient rotation.
Note : Le gestionnaire correspondant est onMeshRotationChanged.
meshSmoothChanged(bool enabled) |
Ce signal est émis lorsque meshSmooth devient enabled.
Note : Le gestionnaire correspondant est onMeshSmoothChanged.
multiHighlightColorChanged(color color) |
Ce signal est émis lorsque multiHighlightColor devient color.
Note : Le gestionnaire correspondant est onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient) |
Ce signal est émis lorsque multiHighlightGradient devient gradient.
Note : Le gestionnaire correspondant est onMultiHighlightGradientChanged.
nameChanged(string name) |
Ce signal est émis lorsque name devient name.
Note : Le gestionnaire correspondant est onNameChanged.
selectedPointChanged(point position) |
Ce signal est émis lorsque selectedPoint devient position.
Note : Le gestionnaire correspondant est onSelectedPointChanged.
shadingChanged(const Shading shading) |
Ce signal est émis lorsque shading devient shading.
Note : Le gestionnaire correspondant est onShadingChanged.
singleHighlightColorChanged(color color) |
Ce signal est émis lorsque singleHighlightColor devient color.
Note : Le gestionnaire correspondant est onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient) |
Ce signal est émis lorsque singleHighlightGradient devient gradient.
Note : Le gestionnaire correspondant est onSingleHighlightGradientChanged.
textureFileChanged(string filename) |
Ce signal est émis lorsque textureFile devient filename.
Note : Le gestionnaire correspondant est onTextureFileChanged.
userDefinedMeshChanged(string fileName) |
Ce signal est émis lorsque userDefinedMesh devient fileName.
Note : Le gestionnaire correspondant est onUserDefinedMeshChanged.
visibilityChanged(bool visible) |
Ce signal est émis lorsque la visibilité de la série passe à visible.
Note : Le gestionnaire correspondant est onVisibilityChanged.
wireframeColorChanged(color color) |
Ce signal est émis lorsque wireframeColor devient color.
Remarque : Le gestionnaire correspondant est onWireframeColorChanged.
Documentation de la méthode
Fonction de commodité permettant de construire un quaternion de rotation de maillage à partir de axis et angle.
Voir aussi meshRotation.
© 2025 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.