DECLARE-IMAGE

Syntax

DECLARE-IMAGE image_name [TYPE=image_type_lit] [IMAGE-SIZE=(width_num_lit,height_num_lit)] [SOURCE=file_name_lit] END-DECLARE

Note:

If TYPE, IMAGE-SIZE, and SOURCE are not defined in DECLARE-IMAGE, they must be defined in PRINT-IMAGE.

Description

Declares the type, size, and source of an image to be printed.

The DECLARE-IMAGE command defines and names an image. This image can then be placed in a report at the position specified in the PRINT-IMAGE command.

Note:

If the image file is unrecognizable, or has incomplete header information, a box (either shaded, for HP printers, or having a diagonal line through it in the case of postscript) appears where the image is expected.

Parameters

Parameter	Description
image_name	Specifies a unique name for referencing the image declaration.
TYPE	Specifies the image type. Types can be EPS-FILE, HPGL-FILE, GIF-FILE, JPEG-FILE, or BMP-FILE (for Microsoft Windows).
IMAGE-SIZE	Specifies the width and height of the image in SQR coordinates.
SOURCE	Specifies the name of a file containing the image. The file must be in the SQRDIR directory or you must specify the full path. Note: If the file is not in the SQRDIR directory, the full path or no path should be given. You cannot specify a relative path, because you must know where to run the file from.

Example

The following example illustrates the DECLARE-IMAGE command:

declare-image officer-signature
   type           = eps-file
   source         = 'off_sherman.eps'
   image-size     = (40, 5)
end-declare

See PRINT-IMAGE