Image

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

Descrizione

Permette di inserire un immagine nella pagina. Le dimensioni possono essere specificate nei seguenti modi:

specificando larghezza e altezza (espresse nell'unità di misura scelte o dpi)
specificando una sola dimensione, l'altra sarà calcolata automaticamente in maniera da mantenere le proporzioni originali
senza specificare le dimensioni, in questo caso l'immagine sarà inserita a 96 dpi

I formati inseribili sono JPEG, PNG, GIF e WebP. Per il supporto dei formati GIF e WebP è richiesta l'estensione GD.

Per le JPEG, sono consentiti i seguenti colori:

scala di grigio
true colors (24 bits)
CMYK (32 bits)

Per le PNG, sono consentiti:

scala di grigio a 8 bits (256 livelli)
indexed colors
true colors (24 bits)

Nel caso di GIF animata, verrà utilizzato solo il primo frame.

La trasparenza è supportata.

Se il formato dell'immagine non viene specificato sarà preso dall'estensione del file.

E' possibile inserire un link sull'immagine.

Osservazione: se un immagine è usata più volte, solo una copia sarà inserita nel file.

Parametri

file

Nome del file che contiene l'immagine.

x

Ascissa dell'angolo superiore-sinistro. Se non specificata o pari a null, viene utilizzata l'ascissa corrente.

y

Ordinata dell'angolo superiore-sinistro. Se non specificata o pari a null, viene utilizzata l'ordinata corrente; inoltre, se necessario, prima viene inserita un'interruzione di pagina (in caso fosse abilita l'interruzione di pagina automatica) e, dopo la chiamata, le coordinate correnti vengono spostate al di sotto dell'immagine.

w

Larghezza dell'immagine nella pagina. Tre casi:

Se positivo, il valore rappresenta la larghezza espressa nell'unità di misura specificata
Se negativo, il valore assoluto rappresenta la risoluzione orizzontale espressa in dpi
Se non viene specificata o uguale a zero, sarà calcolata automaticamente

h

Altezza dell'immagine nella pagina. Tre casi:

Se positivo, il valore rappresenta l'altezza espressa nell'unità di misura specificata
Se negativo, il valore assoluto rappresenta la risoluzione verticale espressa in dpi
Se non viene specificata o uguale a zero, sarà calcolata automaticamente

type

Formato immagine. I valori possibili sono (case insensitive): JPG, JPEG, PNG, GIF e WebP. Se non specificato, il tipo sarà riferito all'estensione del file.

link

URL o identificatore generato da AddLink().

Esempio

// Inserisce il logo nell'angolo in alto a sinistra, con risoluzione di 300 dpi
$pdf->Image('logo.png', 10, 10, -300);
// Inserisce un'immagine dinamica da URL
$pdf->Image('https://www.server.com/makechart.php', 60, 30, 90, 0, 'PNG');

Vedi anche

AddLink

Indice