PRINT-IMAGE

Function

Prints an image.

Syntax

PRINT-IMAGE[image_name]position
[TYPE={image_type_lit|_var|_col}]
[IMAGE-SIZE=(width_num_lit|_var|_col,height_num_lit|_var|_col)]
[SOURCE={file_name_lit|_var|_col}]
[[FOR-PRINTER=({POSTSCRIPT|HPLASERJET|HTML|PDF| WINDOWS|PS|HP|HT|PD|WP|printer_type_lit|_var|_col}, {image_type_lit|_var|_col},{file_name_lit _var|_col})]...]

Note:

DECLARE-IMAGE and PRINT-IMAGE work together to identify information about the image. The IMAGE-SIZE argument is required and must be defined in either DECLARE-IMAGE or PRINT‑IMAGE. The SOURCE and TYPE arguments are optional; however, if you define one you must define the other.

Arguments

image_name

Name of an image specified by a DECLARE-IMAGE.

position

(row, column) Position of the upper left corner. Position parameters can be relative. See the POSITION command for examples of relative positioning. Document markers are not allowed. After execution, the current position is returned to this location; however, the next listing line is the next line below the bottom of the image area. (This is different from the way PRINT works.)

TYPE

Image type. Types can be EPS-FILE, HPGL-FILE, GIF-FILE, JPEG-FILE, BMP-FILE., PNG-FILE, or AUTO-DETECT.

IMAGE-SIZE

Width and height of the image in Production Reporting coordinates.

SOURCE

Name of a file containing the image. The file must be in the SQRDIR directory, or you must specify the full path.

FOR-PRINTER

Specific image file for each report output type.

Tip:

The TYPE and SOURCE arguments contain the default values. You can override these defaults for a specific printer by using the FOR-PRINTER argument. (See the second example under DECLARE-IMAGE.)

Description

PRINT-IMAGE can be placed in any section of a report except the SETUP section. The image file pointed to can be any file of the proper format.

PRINT-IMAGE can be used without referencing a named image if all required attributes for DECLARE-IMAGE are supplied in addition to all its required parameters.

If an image has not been declared, or if the image type is not supported for a particular report output type, or if the image file has incomplete header information, then a box (either shaded for HP printers or with a diagonal line through it for Postscript printers) appears where the image is expected. Table 28, Valid Images Types illustrates the valid relationships between image type and report output type.

Examples

For PostScript:

print-image office-signature (50, 20)
print-image (50, 20)
  type = eps-file
  source = 'sherman.eps'
  image-size = (10, 3)

For Windows:

print-image company-logo (+21, 25)
	type=bmp-file
	source='m:\logos\gustavs.bmp'
	image-size=(75,50)
print-image (1,1)
  type='auto-detect'
  image-size=(30,15)
  source=$Binary_Variable

Note:

For an example of the FOR-PRINTER argument used with DECLARE-IMAGE and PRINT‑IMAGE, see the example under DECLARE-IMAGE.

See Also