# image

Affiche une image à partir d'un tableau.

## 📝 Syntaxe

* image()
* image(C)
* image(X, Y, C)
* image('CData', C)
* image('XData', X, 'YData', Y,'CData', C)
* image(..., propertyName, propertyValue)
* image(parent, ...)
* go = image(...)

## 📥 Argument d'entrée

* X - Coordonnées x : vecteur ou matrice.
* Y - Coordonnées y : vecteur ou matrice.
* C - Tableau de couleurs : tableau m-par-n-par-3 de triplets RGB.
* parent - Un objet graphique scalaire : conteneur parent, spécifié comme un axes.
* propertyName - Une chaîne scalaire ou un vecteur ligne de caractères.
* propertyValue - Une valeur.

## 📤 Argument de sortie

* go - Un objet graphique : type image.

## 📄 Description

image affiche les données C sous forme d'image.

Propriétés :

| Propriété            | Description                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AlphaData**        | Données de transparence : scalaire, tableau de même taille que CData, ou 1 (par défaut).                                                          |
| **AlphaDataMapping** | Méthode de mappage des données alpha.                                                                                                             |
| **CData**            | Données de couleur de l'image : vecteur ou matrice, tableau 3D de triplets RGB.                                                                   |
| **CDataMapping**     | Méthode de mappage des couleurs : 'scaled' ou 'direct' (par défaut).                                                                              |
| **Children**         | \[].                                                                                                                                              |
| **Parent**           | Parent : objet axes.                                                                                                                              |
| **Tag**              | Identifiant de l'objet : chaîne scalaire, vecteur de caractères, '' (par défaut).                                                                 |
| **Type**             | Type d'objet graphique : 'surface'.                                                                                                               |
| **UserData**         | Données utilisateur : tableau ou \[] (par défaut).                                                                                                |
| **Visible**          | État de visibilité : 'off' ou 'on' (par défaut).                                                                                                  |
| **XData**            | Placement sur l'axe x : vecteur à deux éléments, scalaire, \[1 size(CData, 1)] (par défaut).                                                      |
| **YData**            | Placement sur l'axe y : vecteur à deux éléments, scalaire, \[1 size(CData, 2)] (par défaut).                                                      |
| **CreateFcn**        | Callback (fonction, chaîne ou cellule) appelée lors de la création de l'objet. Définir cette propriété sur un composant existant n'a aucun effet. |
| **DeleteFcn**        | Callback (fonction, chaîne ou cellule) appelée lors de la suppression de l'objet.                                                                 |
| **BeingDeleted**     | Indique que l'objet est en cours de suppression.                                                                                                  |

## 💡 Exemples

```matlab
f = figure();
L = linspace(0, 1);
R = L' * L;
G = L' * (L .^ 2);
B = L' * (0 *L + 1);
C(:, :, 1) = G;
C(:, :, 2) = G;
C(:, :, 3) = B;
im = image(C)
```

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

```matlab
f = figure();
image();
```

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

## 🔗 Voir aussi

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

## 🕔 Historique

| Version | 📄 Description                            |
| ------- | ----------------------------------------- |
| 1.0.0   | version initiale                          |
| 1.7.0   | Ajout des callbacks CreateFcn, DeleteFcn. |
| --      | Ajout de la propriété BeingDeleted.       |
