Click above to get retro games delivered to your door ever month!

hpPCX()

Print a monochrome, half tone, 16 color or 256 color .PCX file


Syntax

hpPCX(<nRow> ,<nCol>, <cFileName> [, <cUnits>  ;
   [, <nResolution)> [, <lInverse> [, <nScreen> ]]]])


Parameters

<nRow>
Vertical row position.

<nCol>
Horizontal column position.

<cFileName>
The name of the .PCX file to be printed.

<cUnits>
The units of measurement to used for positioning.  If
<cUnits> is omitted, the units will default to Rows and
Columns.  Values for <cUnits> can be:
"R"     Rows and Columns
"I"     Inches
"M"     Millimeters

<nResolution>
The printer resolution to print the .PCX image at.  If
<nResolution> is omitted, it will be defaulted to 300.
Valid values for <nResolution> can be:
75      75 dots per inch
150     150 dots per inch
300     300 dots per inch

<lInverse>
A logical which can be used to inverse the .PCX image.
If lInverse is .T., all blacks will appear as white and all
whites will appear as black.  If <lInverse> is omitted, it
will default to .T.

<nScreen>
The number of the screen pattern to apply to the .PCX
image.  Values which can be entered here are the
percentages 1 to 100.  If <nScreen> is omitted, it will
default to 100 (100% black or no screen).  Refer to
"Appendix B - Shades and Fill Patterns" for a
description of the available screening levels.


Returns

0
Successful.

-12
Wrong number of parameters specified.

-17
Incorrect parameter type was passed.

-30
Error initializing printer.

-31
Memory allocation error.

-40
Error opening .PCX file.

-41
Error reading .PCX file.

-42
This .PCX file format not supported.

-43
.PCX file not found.


Remarks

Use hpPCX() to print monochrome, half tone, 16 color, or 256 color .PCX
images on your printouts.  Adding .PCX images can greatly enhance the
look of any report.  hpPCX() is great for forms such as invoices, or even
for creating letterhead directly from your LaserJet printer.


Support By

All LaserJet printers except the original LaserJet.


Example

To print a .PCX image 2 inches down on the page, and 5 inches across:

hpPCX( 2, 5, 'LOGO.PCX', 'I')

To apply a 50% screen to the same image:

hpPCX( 2, 5, 'LOGO.PCX', 'I', 300, .F., 50)