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().