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

 BmLoadBMP
 Load a Windows BMP graphic file
------------------------------------------------------------------------------
 Syntax

    BmLoadBMP(<cFile>) -> nBitmap

 Parameters

    <cFile> is the name of the BMP file.

 Returns

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

 Description

    BmLoadBMP() loads a Windows BMP 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 BmLoadBMP() must be monochrome (black and white) BMP
    bitmap files.  The largest bitmap that can be loaded is about 8M pixels,
    or 1M bytes of data.