figure

Créer une fenêtre de figure

Syntaxe

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

Description

figure crée une nouvelle fenêtre de figure avec les valeurs de propriété par défaut. La figure qui en résulte est la figure courante.

figure(Name,Value) modifie les propriétés de la figure avec un ou plusieurs arguments de type paire nom-valeur. Par exemple, figure('Color','white') définit la couleur d’arrière-plan à blanc.

f = figure(___) renvoie l’objet Figure. Utilisez f pour interroger ou modifier les propriétés de la figure après sa création.

figure(f) fait de la figure spécifiée par f la figure courante et l’affiche au-dessus de toutes les autres figures.

figure(n) trouve une figure dont la propriété Number est égale à n et en fait la figure courante. S’il n’existe aucune figure avec cette valeur de propriété, MATLAB^® crée une nouvelle figure et définit sa propriété Number à n.

Exemples

Modifier la taille d’une figure

Créez une figure par défaut. Elle s’affiche sous forme d’onglet dans un conteneur de figures.

f = figure;

Obtenez l’emplacement, la largeur et la hauteur de la figure.

f.Position

ans =

    1    1    1070    620

Cela signifie que la figure est positionnée avec son coin inférieur gauche adjacent au coin du conteneur de figures et qu’elle a une largeur de 1 070 pixels et une hauteur de 620 pixels.

Vous pouvez redimensionner le conteneur de figures de manière interactive. Vous pouvez également spécifier la taille de la figure en définissant sa propriété Position, ce qui désancre la figure du conteneur de figures. Par exemple, positionnez la figure pour qu’elle soit à 100 pixels à droite et à 200 pixels au-dessus du coin inférieur gauche de l’affichage principal. Spécifiez sa taille avec une largeur de 500 pixels et une hauteur de 300 pixels.

f.Position = [100 200 500 300];

Spécifier le titre d’une figure

Créez une figure et spécifiez la propriété Name. Par défaut, le titre généré inclut le numéro de la figure.

figure(Name="Measured Data");

Spécifiez à nouveau la propriété Name, mais cette fois en définissant la propriété NumberTitle sur "off". Le titre généré n’inclut pas le numéro de la figure.

figure(Name="Measured Data",NumberTitle="off");

Travailler simultanément avec plusieurs figures

Créez deux figures, puis créez un tracé de courbe. Les figures s’affichent sous forme d’onglets dans un conteneur de figures. Par défaut, la commande plot cible la figure courante.

f1 = figure;
f2 = figure;
plot([1 2 3],[2 4 6]);

Définissez f1 comme la figure courante pour qu’elle soit la cible du tracé suivant. Créez ensuite un diagramme de dispersion.

figure(f1);
scatter((1:20),rand(1,20));

Arguments d'entrée

f — Figure cible

Objet Figure

Figure cible, spécifiée sous forme d’un objet Figure.

n — Numéro de la figure cible

valeur entière scalaire

Numéro de la figure cible, spécifié sous forme de valeur entière scalaire. Lorsque vous spécifiez cet argument, MATLAB recherche une figure existante dont la propriété Number est égale à n. S’il n’existe aucune figure avec cette valeur de propriété, MATLAB crée une nouvelle figure et définit sa propriété Number à n. Par défaut, la valeur de la propriété Number s’affiche dans le titre de la figure.

Types de données : double

Arguments nom-valeur

Spécifiez des paires d’arguments facultatifs en tant que Name1=Value1,...,NameN=ValueN, où Name est le nom de l'argument et Value la valeur correspondante. Les arguments nom-valeur doivent apparaître après les autres arguments, mais l’ordre des paires n’a pas d’importance.

Exemple : figure(Color="white") crée une figure avec un arrière-plan blanc.

Si votre version est antérieure à la R2021a, utilisez des virgules pour séparer chaque nom et chaque valeur, et placez Name entre guillemets.

Exemple : figure("Color","white") crée une figure avec un arrière-plan blanc.

Remarque

Les propriétés répertoriées ici ne sont qu’un sous-ensemble. Pour obtenir la liste complète, consultez Figure.

Name — Nom

'' (par défaut) | vecteur de caractères | string scalar

Nom de la figure, spécifié sous forme de vecteur de caractères ou de string scalar.

Exemple : figure('Name','Results') définit le nom de la figure sur 'Results'.

Par défaut, le nom est 'Figure n', où n est un nombre entier. Lorsque vous spécifiez la propriété Name, le titre de la figure devient 'Figure n: name'. Si vous souhaitez afficher uniquement la valeur Name, définissez IntegerHandle ou NumberTitle sur 'off'.

Color — Couleur d’arrière-plan

Triplet RGB | code couleur hexadécimal | 'r' | 'g' | 'b' | ...

Couleur d’arrière-plan, spécifiée sous forme de triplet RGB, de code couleur hexadécimal, de nom de couleur ou d’abréviation. Si vous spécifiez 'none', la couleur d’arrière-plan apparaît comme noire à l’écran, mais si vous imprimez la figure, l’arrière-plan s’imprime comme si la fenêtre de figure était transparente.

Pour une couleur personnalisée, spécifiez un triplet RGB ou un code couleur hexadécimal.

• Un triplet RGB est un vecteur ligne à trois éléments. Ces éléments spécifient l’intensité des composants verts, rouges et bleus de la couleur. Les intensités doivent être comprises dans la plage [0,1], comme [0.4 0.6 0.7] par exemple.

• Un code couleur hexadécimal est un string scalar ou un vecteur de caractères qui commence par un symbole dièse (#) suivi de trois ou six chiffres hexadécimaux, compris dans une plage de 0 à F. Les valeurs ne sont pas sensibles à la casse. Par conséquent, les codes couleur "#FF8800", "#ff8800", "#F80" et "#f80" sont équivalents.

Vous pouvez également spécifier certaines couleurs usuelles par leur nom. Cette table répertorie les options de couleur nommées, les triplets RGB équivalents et les codes couleur hexadécimaux.

Nom de couleur	Abréviation	Triplet RGB	Code couleur hexadécimal	Apparence
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	Non applicable	Non applicable	Non applicable	Aucune couleur

Cette table énumère les palettes de couleurs par défaut pour les tracés dans les thèmes clairs et sombres.

Palette	Couleurs de la palette
"gem" — Paramètre par défaut du thème clair Avant R2025a : La plupart des tracés utilisent ces couleurs par défaut.
"glow" — Paramètre par défaut du thème sombre

Vous pouvez obtenir les triplets RGB et les codes couleur hexadécimaux de ces palettes à l’aide des fonctions orderedcolors et rgb2hex. Par exemple, obtenez les triplets RGB de la palette "gem" et convertissez-les en codes couleur hexadécimaux.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Avant R2023b : Obtenez les triplets RGB à l’aide de RGB = get(groot,"FactoryAxesColorOrder").

Avant R2024a : Obtenez les codes couleur hexadécimaux à l’aide de H = compose("#%02X%02X%02X",round(RGB*255)).

Types de données : double | char

Position — Emplacement et taille de la figure, en excluant les bordures, les outils pour les figures et la barre de titre

[left bottom width height]

Emplacement et taille de la figure, en excluant les bordures, les outils pour les figures et la barre de titre, spécifiés comme un vecteur à quatre éléments de la forme [left bottom width height].

Le tableau suivant décrit chaque élément du vecteur.

Élément	Description
left	Distance entre le bord gauche de l’affichage principal et le bord intérieur gauche de la fenêtre. Cette valeur peut être négative sur les systèmes à plusieurs écrans. Si la figure est ancrée, cette valeur est relative par rapport à son conteneur.
bottom	Distance entre le bord inférieur de l’affichage principal et le bord intérieur inférieur de la fenêtre. Cette valeur peut être négative sur les systèmes à plusieurs écrans. Si la figure est ancrée, cette valeur est relative par rapport à son conteneur.
width	Distance entre les bords intérieurs droit et gauche de la fenêtre.
height	Distance entre les bords intérieurs supérieur et inférieur de la fenêtre.

Toutes les mesures sont exprimées dans les unités spécifiées par la propriété Units.

Pour les figures ancrées dans un conteneur de figures, la définition de la propriété Position désancre la figure et définit la propriété WindowStyle sur 'normal'.

Pour positionner l’ensemble de la fenêtre, y compris les bordures, les outils pour les figures et la barre de titre, utilisez la propriété OuterPosition.

Remarque

Le système d’exploitation Windows^® impose une largeur de fenêtre minimale et une taille de fenêtre maximale. Si vous spécifiez une taille de figure en dehors de ces limites, la figure affichée se conforme aux limites et non à la taille spécifiée.

Units — Unités de mesure

'pixels' (par défaut) | 'normalized' | 'inches' | 'centimeters' | 'points' | 'characters'

Unités de mesure, spécifiées sous forme de l’une des valeurs du tableau suivant.

Valeur des unités	Description
'pixels' (par défaut)	Pixels. Sur les systèmes Windows et Macintosh, la taille d’un pixel est égale à 1/96e de pouce. Cette taille est indépendante de la résolution système. Sur les systèmes Linux®, la taille d’un pixel est déterminée par la résolution système.
'normalized'	Ces unités sont normalisées par rapport au conteneur parent. Le coin inférieur gauche du conteneur est mappé sur (0,0) et le coin supérieur droit est mappé sur (1,1).
'inches'	Pouces.
'centimeters'	Centimètres.
'points'	Points. Un point est égal à 1/72e de pouce.
'characters'	Ces unités sont basées sur la police uicontrol de l’objet racine graphique : Largeur de caractère = largeur de la lettre x. Hauteur de caractère = distance entre les lignes de base de deux lignes de texte. Pour accéder à la police uicontrol par défaut, utilisez get(groot,'defaultuicontrolFontName') ou set(groot,'defaultuicontrolFontName').

MATLAB mesure toutes les unités à partir du coin inférieur gauche de l’objet parent.

Cette propriété affecte la propriété Position. Si vous modifiez la propriété Units, envisagez de rétablir sa valeur par défaut une fois votre calcul terminé. Vous éviterez ainsi d’affecter d’autres fonctions qui utilisent la valeur par défaut.

L’ordre dans lequel vous spécifiez les propriétés Units et Position a les effets suivants :

• Si vous spécifiez la propriété Units avant la propriété Position, MATLAB définit Position avec les unités spécifiées.

• Si vous spécifiez la propriété Units après la propriété Position, MATLAB définit la position avec les unités Units par défaut. Ensuite, MATLAB convertit la valeur Position vers la valeur équivalente dans les unités spécifiées.

En savoir plus

Figure courante

La figure courante est la cible des commandes graphiques telles que axes et colormap. Il s’agit généralement de la dernière figure créée ou de la dernière figure sur laquelle vous avez cliqué. La commande gcf renvoie la figure courante.

Conseils

• Utilisez l’objet racine graphique pour définir les valeurs par défaut au niveau de la racine pour les autres types d’objets. Par exemple, définissez la palette de couleurs par défaut sur summer pour toutes les prochaines figures.

  set(groot,'DefaultFigureColormap',summer)

  Pour restaurer une propriété à sa valeur par défaut MATLAB d’origine, utilisez le mot-clé 'remove'.

  set(groot,'DefaultFigureColormap','remove')

  Pour plus d’informations sur la définition des valeurs par défaut, consultez Default Property Values.

Historique des versions

Introduit avant R2006a

Voir aussi

Fonctions

• axes | gcf | gca | clf | cla | shg

Propriétés

• Figure