Spline3DSeries QML Type (Uncreatable)
Représente une série de données sous la forme d'un graphique spline en 3D. En savoir plus…
| Import Statement: | import QtGraphs |
| Since: | Qt 6.9 |
| In C++: | QSpline3DSeries |
| Inherits: |
Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.
- Liste de tous les membres, y compris les membres hérités
- Spline3DSeries fait partie des types QML 3D d'Qt Graphs .
Propriétés
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- 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
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- splineColor : color
- splineKnotting : real
- splineLooping : bool
- splineResolution : int
- splineTension : real
- splineVisible : bool
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
Signaux
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- 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)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
Méthodes
- void setMeshAxisAndAngle(vector3d axis, real angle)
Description détaillée
Les graphiques splines sont utilisés pour représenter des informations sous la forme d'une série de points de données reliés par une spline de Catmull-Rom, courbe ou droite.
Ce type gère les éléments visuels spécifiques à la spline.
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 aussi colorStyle.
colorStyle : GraphsTheme.ColorStyle
Le style de couleurs de la série.
Voir aussi GraphsTheme.ColorStyle.
itemLabel : string [read-only]
L'étiquette de l'élément mis en forme. S'il n'y a aucun élément sélectionné ou si l'élément sélectionné n'est pas visible, renvoie une chaîne vide.
Voir aussi 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. La commande « Bar3DSeries » ignore toute rotation qui ne s'effectue pas autour de l'axe y. La commande « 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 « 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.
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.
splineColor : color
La couleur de la spline.
splineKnotting : real
La paramétrisation des nœuds de la spline.
Ce paramètre permet de modifier le profil de la courbe. La spline est classée comme une spline Catmull-Rom uniforme pour une valeur de 0.0, comme une spline Catmull-Rom centripète pour une valeur de 0.5, et comme une spline Catmull-Rom cordale pour une valeur de 1.0.
La valeur doit être comprise entre 0.0 et 1.0. La valeur par défaut est 0.5.
splineLooping : bool
Détermine si la spline forme une boucle.
Cela ajoute un segment de spline entre le premier et le dernier point de la série, reliant ainsi la spline pour former une boucle.
La valeur par défaut est false
splineResolution : int
La résolution des segments de spline.
Le nombre de sommets par segment de spline, défini comme la partie comprise entre deux points.
Doit être une valeur supérieure à 2. La valeur par défaut est 10.
splineTension : real
La tension de la spline.
La spline utilise une courbure maximale pour les segments lorsque la valeur est égale à 0.0. Les segments sont parfaitement droits lorsque la valeur est égale à 1.0. La valeur doit être comprise entre 0.0 et 1.0. La valeur par défaut est 0.0
splineVisible : bool
Visibilité de la spline. La valeur par défaut est « true ».
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é lorsque l'option « mesh » est activée, 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 la valeur est « false », la série n'est pas affichée.
Documentation de Signal
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 devient gradient.
Remarque : le gestionnaire correspondant est onBaseGradientChanged.
colorStyleChanged(GraphsTheme.ColorStyle style)
Ce signal est émis lorsque colorStyle devient style.
Remarque : le gestionnaire correspondant est onColorStyleChanged.
itemLabelChanged(string label)
Ce signal est émis lorsque l'adresse itemLabel devient label.
Remarque : le gestionnaire correspondant est onItemLabelChanged.
itemLabelFormatChanged(string format)
Ce signal est émis lorsque itemLabelFormat devient format.
Remarque : le gestionnaire correspondant est onItemLabelFormatChanged.
itemLabelVisibilityChanged(bool visible)
Ce signal est émis lorsque la propriété `itemLabelVisibility` prend la valeur ` visible`.
Remarque : le gestionnaire correspondant est « onItemLabelVisibilityChanged ».
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
Ce signal est émis lorsque lightingMode devient lightingMode.
Remarque : le gestionnaire correspondant est onLightingModeChanged.
Ce signal a été introduit dans Qt 6.10.
meshChanged(Abstract3DSeries.Mesh mesh)
Ce signal est émis lorsque mesh devient mesh.
Remarque : le gestionnaire correspondant est onMeshChanged.
meshRotationChanged(quaternion rotation)
Ce signal est émis lorsque meshRotation devient rotation.
Remarque : le gestionnaire correspondant est onMeshRotationChanged.
meshSmoothChanged(bool enabled)
Ce signal est émis lorsque meshSmooth devient enabled.
Remarque : le gestionnaire correspondant est onMeshSmoothChanged.
multiHighlightColorChanged(color color)
Ce signal est émis lorsque multiHighlightColor devient color.
Remarque : le gestionnaire correspondant est onMultiHighlightColorChanged.
multiHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque l'adresse multiHighlightGradient devient gradient.
Remarque : le gestionnaire correspondant est onMultiHighlightGradientChanged.
nameChanged(string name)
Ce signal est émis lorsque name devient name.
Remarque : le gestionnaire correspondant est onNameChanged.
singleHighlightColorChanged(color color)
Ce signal est émis lorsque singleHighlightColor devient color.
Remarque : le gestionnaire correspondant est onSingleHighlightColorChanged.
singleHighlightGradientChanged(Gradient gradient)
Ce signal est émis lorsque l'singleHighlightGradient passe à « gradient ».
Remarque : le gestionnaire correspondant est onSingleHighlightGradientChanged.
userDefinedMeshChanged(string fileName)
Ce signal est émis lorsque userDefinedMesh devient fileName.
Remarque : le gestionnaire correspondant est onUserDefinedMeshChanged.
visibilityChanged(bool visible)
Ce signal est émis lorsque la visibilité de la série passe à « visible ».
Remarque : le gestionnaire correspondant est onVisibilityChanged.
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.
© 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.