# colorbar

Barre de couleur affichant l'échelle des couleurs.

## 📝 Syntaxe

* colorbar()
* colorbar('off')
* colorbar(location)
* colorbar(..., propertyName, propertyValue)
* colorbar(target, ...)
* colorbar(target, 'off')
* c = colorbar(...)

## 📥 Argument d'entrée

* propertyName - une chaîne scalaire ou un vecteur ligne de caractères.
* propertyValue - une valeur.
* target - Cible : axes.
* 'off' - supprime la barre de couleur associée aux axes courants.
* location - spécifie la position de la barre de couleur: 'north','south','east','west', ...

## 📤 Argument de sortie

* c - objet graphique : axes de la barre de couleur.

## 📄 Description

colorbar ajoute une barre de couleur à un graphique.

Elle peut être placée à différents emplacements autour des axes.

Les emplacements pris en charge incluent : 'north','south','east','west', 'northoutside','southoutside','eastoutside','westoutside'.

## 💡 Exemples

```matlab
f = figure();
surf(peaks);
axis('square');
colormap('summer');
colorbar()

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-31228b207dbcaaab4d438a411d130bc172551dc8%2Fcolorbar_1.svg?alt=media)

```matlab
f = figure();
surf(peaks);
axis('square');
colormap('gray');
cb = colorbar(gca);
```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-32859c492b039bea0787749d9d6d25637971c6aa%2Fcolorbar_2.svg?alt=media)

```matlab
locations = { 'north';
'south';
'east';
'west';
'northoutside';
'southoutside';
'eastoutside';
'westoutside'};
f = figure();
surf(peaks);
colormap('jet');
for k = 1 : length(locations)
    colorbar(locations{k});
    pause(1);
end

```

## 🔗 Voir aussi

[colormap](https://nelson-9.gitbook.io/Nelson/markdown/fr/graphics/colormap).

## 🕔 Historique

| Version | 📄 Description                         |
| ------- | -------------------------------------- |
| 1.0.0   | version initiale                       |
| 1.15.0  | ajout du support du paramètre location |
