Image
Image(string file, float x, float y [, float w [, float h [, string type [, mixed link]]]])
Version
1.1
Description
Puts an image in the page. The upper-left corner must be given. The dimensions can be specified
in different ways:
- explicit width and height (expressed in user unit)
- one explicit dimension, the other being calculated automatically in order to keep the original
proportions
- no explicit dimension, in which case the image is put at 72 dpi
Supported formats are JPEG and PNG.
For JPEG, all flavors are allowed:
- gray scales
- true colors (24 bits)
- CMYK (32 bits)
For PNG, are allowed:
- gray scales on at most 8 bits (256 levels)
- indexed colors
- true colors (24 bits)
but are not supported:
- Interlacing
- Alpha channel
If a transparent color is defined, it will be taken into account (but will be only interpreted
by Acrobat 4 and above).
The format can be specified explicitly or inferred from the file extension.
It is possible to put a link on the image.
Remark: if an image is used several times, only one copy will be embedded in the file.
Parameters
file
Name of the file containing the image.
x
Abscissa of the upper-left corner.
y
Ordinate of the upper-left corner.
w
Width of the image in the page. If not specified or equal to zero, it is automatically
calculated.
h
Height of the image in the page. If not specified or equal to zero, it is automatically
calculated.
type
Image format. Possible values are (case insensitive): JPG, JPEG, PNG.
If not specified, the type is inferred from the file extension.
link
URL or identifier returned by AddLink().
See also
AddLink().