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