# 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 ou en dpi)
- 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 96 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)

Pour le GIF : en cas de GIF animé, seule la première image est affichée.
La transparence est gérée.
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. Il y a trois cas possibles :
  - Si la valeur est positive, elle représente la largeur en unité utilisateur
  - Si la valeur est négative, sa valeur absolue représente la résolution horizontale en dpi
  - Si elle n'est pas indiquée ou vaut zéro, elle est calculée automatiquement
`h`
  Hauteur de l'image dans la page. Il y a trois cas possibles :
  - Si la valeur est positive, elle représente la hauteur en unité utilisateur
  - Si la valeur est négative, sa valeur absolue représente la résolution verticale en dpi
  - 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().

## Exemple

    // Insère un logo en haut à gauche à 300 dpi
    $pdf->Image('logo.png',10,10,-300);
    // Insère une image dynamique à partir d'une URL
    $pdf->Image('http://chart.googleapis.com/chart?cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World',60,30,90,0,'PNG');

## Voir

AddLink().

Index