Previous Topic Next topic Print topic


PC_PRINTER_SET_COLOR

Sets the color on the printer.
Restriction: This routine is not currently supported on UNIX platforms.

Syntax:

call "PC_PRINTER_SET_COLOR"  using    printer-handle
                            by value  fore-or-back
                            by value  color-red
                            by value  color-green
                            by value  color-blue
                            returning status-code

Parameters:

  Using call prototype (see Key) Picture
printer-handle cblt-x4-comp5 pic x(4) comp-5.
fore-or-back cblt-x2-comp5 pic x(2) comp-5.
color-red cblt-x2-comp5 pic x(2) comp-5.
color-green cblt-x2-comp5 pic x(2) comp-5.
color-blue cblt-x2-comp5 pic x(2) comp-5.
status-code See Library Routines - Key

On Entry:

printer-handle
The handle of the printer, returned when the printer was opened.
fore-or-back
Whether to set the foreground or background color:
1 Foreground
2 Background
color-red
Value between 0 and 255; intensity of red
color-green
Value between 0 and 255; intensity of green
color-blue
Value between 0 and 255; intensity of blue

On Exit:

status-code No status codes are returned by this routine.

Comments:

You must open the printer before using this routine.

You specify the color you want by combinations of values showing the intensity of the three primary colors. For example, to get the colors in the following table, you set the RGB values as shown:

Color Red Green Blue
Red 255 0 0
Yellow 255 255 0
Green 0 255 0
Cyan 0 255 255
Blue 0 0 255
Magenta 255 0 255
White 255 255 255
Black 0 0 0

Some other, more unusual, colors are:

Color Red Green Blue
Dark orange 255 140 0
Navy blue 0 0 128
Violet 238 120 238
Beige 245 245 220

If your printer does not support color, it is up to the printer device driver to interpret these values. For example, some perform gray-shading; others choose either black or white for each color.

Previous Topic Next topic Print topic