# Image

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

## Descripción

Imprime una imagen en la página. Las dimensiones pueden establecerse de diferentes maneras:

- mediante la especificación explícita de ancho y alto (en unidades definidas por el usuario o en ppp)
- mediante la indicación de una sola de las dimensiones: la otra se calculará automáticamente para mantener la proporción original
- sin indicar ninguna dimensión explícita. En este caso, la imagen se imprime a 96 puntos por pulgada

Los formatos admitidos son JPEG, PNG y GIF. La extensión GD es necesaria para GIF.
Para el JPEG, se admiten todas sus versiones:

- escala de grises
- color verdadero (24 bits)
- CMYK (32 bits)

Para el PNG se permiten:

- escala de grises de 8 bits como máximo (256 niveles)
- color indexado
- color verdadero (24 bits)

Para el GIF: en el caso de un GIF animado, sólo será mostrado el primer fotograma.
Se admite transparencias.
El formato puede ser especificado explícitamente o deducido a partir de la extensión del fichero.
Es posible asociar un enlace a la imagen.
Nota: si una imagen se utiliza varias veces, sólo una copia será incrustada en el archivo.

## Parámetros

`file`
  Nombre del archivo que contiene la imagen.
`x`
  Abscisa de la esquina superior izquierda. Si no se especifica o es igual a `null`, se utilizará la abscisa actual.
`y`
  Ordenada de la esquina superior izquierda. Si no se especifica o es igual a `null`, se utilizará la ordenada actual, además, un salto de página es invocado primero si es necesario (en caso de que esté habilitado el salto de página automático) y, después de la llamada, la ordenada actual se mueve a la parte inferior de la imagen.
`w`
  Ancho de la imagen en la página. Existen tres posibilidades:
  - Si el valor es positivo, éste será el ancho en la unidad de medida definida por el usuario.
  - Si el valor es negativo, el valor absoluto será la resolución horizontal en ppp.
  - Si no se especifica o es cero, se calcula automáticamente
`h`
  Alto de la imagen en la página. Existen tres posibilidades:
  - Si el valor es positivo, éste será la altura en la unidad de medida definida por el usuario.
  - Si el valor es negativo, el valor absoluto será la resolución vertical en ppp.
  - Si no se especifica o es cero, se calcula automáticamente
`type`
  Formato de la imagen. Los posibles valores son (indiferente a mayúsculas): `JPG`, `JPEG`, `PNG` y `GIF`. Si no se especifica, el tipo se deduce de la extensión del fichero.
`link`
  URL o identificador devuelto por el método AddLink().

## Ejemplo

    // Inserta un logo en la esquina superior izquierda a 300 ppp
    $pdf->Image('logo.png',10,10,-300);
    // Inserta una imagen dinámica a través de una URL
    $pdf->Image('https://chart.googleapis.com/chart?cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World',60,30,90,0,'PNG');

## Vea además

AddLink().

Inicio