# 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 e GIF. Per il supporto al formato GIF è 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` e `GIF`. 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('http://chart.googleapis.com/chart?cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World',60,30,90,0,'PNG');

## Vedi anche

AddLink

Indice