PC_PRINTER_WRITE_BMP

Write a loaded bitmap to a printer at a specified position with a given size.

Restriction: This routine is not currently supported on UNIX platforms.

Syntax:

call "PC_PRINTER_WRITE_BMP" using      printer-handle
                            by value  bmp-id
                            by value  options
                            by value  bmp-row 
                            by value  bmp-col
                            by value  bmp-width
                            by value  bmp-height
                            returning status-code

Parameters:

	Using call prototype (see Key)	Picture
`printer-handle`	cblt-x4-comp5	pic x(4) comp-5.
`options`	cblt-x4-comp5 value 0	pic x(4) comp-5 value 0.
`bmp-id`	cblt-x4-comp5	pic x(4) comp-5.
`bmp-row`	cblt-x4-comp5	pic x(4) comp-5.
`bmp-col`	cblt-x4-comp5	pic x(4) comp-5.
`bmp-width`	cblt-x4-comp5	pic x(4) comp-5.
`bmp-height`	cblt-x4-comp5	pic x(4) comp-5.
`status-code`	See Library Routines - Key

On Entry:

printer-handle

The printer handle returned when the printer was opened.

options

Bit 1: Preserve the aspect ratio of the bitmap.

Bit 2: Center the bitmap if bitmap aspect ratio is preserved.

Bit 9: Use bmp-row, bmp-col, bmp-width, bmp-height as logical units rather than character positions.

bmp-id

The unique id of the bitmap to print.

bmp-row

The row at which the bitmap is to be printed.

bmp-width

The width of the bitmap in characters. The value you specify is multiplied by the width of the currently selected font to determine the width that is used when printing the bitmap.

bmp-height

The height of the bitmap in characters. The value you specify is multiplied by the height of the currently selected font to determine the height that is used when printing the bitmap.

status-code

Printer status code:

0	Successful
3	Printer device not open
4	Out of memory while printing
5	Disk full while spooling file
7	Print job aborted, no file spooled to Print Manager
11	Write failure
21	Failed to print bitmap
31	Bad position; x or y out of bounds
32	Move to x,y failed
33	Line to x,y failed
34	Rectangle failed to be drawn

On Exit:

status-code

Printer Handling Routines Return Codes

Comments:

Restrictions:

This routine works with PostScript and HP PCL printers.
This routine is not supported on HP DeskJet or dot matrix printers.

Example:

 call "PC_PRINTER_WRITE_BMP" USING printer-handle
                                   BY VALUE  bmp-id-logo
                                   BY VALUE  3 size 4
                                   BY VALUE  7 size 4
                                   BY VALUE  5 size 4
                                   BY VALUE  25 size 4
                                   BY VALUE  15 size 4
                             						RETURNING printer-retcode
 end-call