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

 BmLoadPCX
 Load a PCX graphic file
------------------------------------------------------------------------------
 Syntax

    BmLoadPCX(<cFile>) -> nBitmap

 Parameters

    <cFile> is the name of the PCX file.

 Returns

    New bitmap handle.  On error, returns zero with an error code in
    F2Error().

 Description

    BmLoadPCX() loads a PCX graphic file into memory.  The file is stored in
    memory as a bitmap identified by a handle.  The handle can be passed to
    functions like BmWidth() and BmLength() to get information about the
    bitmap, and it can be passed to RipDrawBitmap() to draw the bitmap on
    the current page.  When you are finished with the bitmap, you should use
    BmUnload() to remove it from memory.

    Files loaded by BmLoadPCX() must be monochrome (black and white) PCX
    bitmap files.  The largest bitmap that can be loaded is about 8M pixels,
    or 1M bytes of data (but PCX files are stored compressed, so the size of
    the file is not an accurate measure).