# Image

`Image(string file [, float x [, float y [, float w [, float h [, string type [, mixed link]]]]]])`

## Description

Place une image. Les dimensions occupées dans la page peuvent être indiquées de plusieurs manières :

- largeur et hauteur explicites (exprimées dans l'unité utilisateur)
- une dimension explicite, l'autre étant calculée automatiquement afin de respecter les proportions de l'image originale
- aucune dimension explicite, auquel cas l'image est dimensionnée en 72 dpi

Les formats supportés sont le JPEG, le PNG et le GIF. Le GIF nécessite l'extension GD.
Pour le JPEG, toutes les variantes sont autorisées :

- niveaux de gris
- couleurs vraies (24 bits)
- CMYK (32 bits)

Pour le PNG, sont autorisées :

- les images en niveaux de gris sur 8 bits au plus (256 teintes)
- les images en couleurs indexées
- les images en couleurs vraies (24 bits)

mais ne sont pas supportés :

- L'interlacement
- L'alpha channel

Pour le GIF : en cas de GIF animé, seule la première image est utilisée.
Si une couleur transparente est définie, elle est prise en compte.
Le format peut être spécifié explicitement ou bien déduit de l'extension du fichier.
Il est possible de mettre un lien sur l'image.
Remarque : si une image est utilisée plusieurs fois, une seule copie est intégrée au document.

## Paramètres

`file`
  Chemin ou URL de l'image.
`x`
  Abscisse du coin supérieur gauche. Si non précisée ou égale à `null`, l'abscisse courante est utilisée.
`y`
  Ordonnée du coin supérieur gauche. Si non précisée ou égale à `null`, l'ordonnée courante est utilisée ; de plus, un saut de page est d'abord effectué si nécessaire (en cas de saut de page automatique) ; puis, après l'appel, l'ordonnée courante est positionnée en bas de l'image.
`w`
  Largeur de l'image dans la page. Si elle n'est pas indiquée ou vaut zéro, elle est calculée automatiquement.
`h`
  Hauteur de l'image dans la page. Si elle n'est pas indiquée ou vaut zéro, elle est calculée automatiquement.
`type`
  Format de l'image. Les valeurs possibles sont (indépendamment de la casse) : `JPG`, `JPEG`, `PNG` et `GIF`. S'il n'est pas précisé, le type est déduit de l'extension du fichier.
`link`
  URL ou identifiant retourné par AddLink().

## Voir

AddLink().

Index