1.28 image

image [ item <id> ] '<filename>' [at <x>, <y>] [rotate <angle>]
                     [width <width>] [height <height>] [smooth]
                   [notransparent] [transparent rgb<r>:<g>:<b>]

The image command allows graphical images to be inserted onto the current multiplot canvas from files on disk. Input graphical images may be in bitmap, gif, jpeg or png formats; the file type of each image is automatically detected. The at modifier can be used to specify where the bottom-left corner of each image should be placed; if no position is specified then this corner of the image is placed at the origin. The rotate modifier can be used to rotate images by any angle, measured in degrees counter-clockwise. The width or height modifiers can be used to specify the width or height with which images should be rendered; both should be specified in centimetres. If neither is specified then images are rendered with the native dimensions specified within the metadata present in the image file (if any). If both are specified, then the aspect ratio of the image is changed.

The keyword smooth may optionally be supplied to cause the pixels of images to be interpolated1. Images which include transparency are supported. The optional keyword notransparent may be supplied to cause transparent regions to be filled with the image’s default background colour. Alternatively, an RGB colour may be specified in the form rgb<r>:<g>:<b> after the keyword transparent to cause that particular colour to become transparent; the three components of the RGB colour should be in the range 0 to 255.

All vector graphics objects placed on multiplot canvases receive unique identification numbers which count sequentially from one, and which may be listed using the list command. By reference to these numbers, they can be deleted and subsequently restored with the delete and undelete commands respectively.

Footnotes

  1. Many commonly-used PostScript display engines, including Ghostscript, do not support this functionality.