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)
- 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 72 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)
pero no se admite:
- entrelazado
- transparencia (canal Alfa)
Para el GIF: en el caso de un GIF animado, sólo el primer fotograma se utilizará.
Si se definiera un color como transparente, se tomará en cuenta.
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 usa varias veces, sólo se incluirá una copia en el fichero resultante.
Parámetros
file
-
Nombre del fichero 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. Si no se especifica o es cero, se calcula automáticamente.
h
-
Alto de la imagen en la página. 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().
Vea además
AddLink().