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

 FontLoadPCL
 Load a font
------------------------------------------------------------------------------
 Syntax

    FontLoadPCL(<cFile>, [<nResolution>]) -> nFont

 Parameters

    <cFile> is the name of the PCL font file.

    <nResolution> is the resolution at which you intend to use the font:

    Resolutions defined in FAXUAL2.CH
    ----------------------------------------------------------------------
    Value   Constant        Resolution
    ----------------------------------------------------------------------
      1     HIGH_RES        200 (horizontal) x 200 (vertical) DPI
      2     LOW_RES         200 (horizontal) x 100 (vertical) DPI
    ----------------------------------------------------------------------

    The default is HIGH_RES.

 Returns

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

 Description

    FontLoadPCL() loads an HP LaserJet bitmap font file into memory.  The
    font in memory is identified by a handle that can be passed to functions
    like FontHeight() and FontFullName() to get information about the font,
    or passed to RipFont() to set the current font for text output.  When
    you are finished with the font, you should use FontUnload() to remove it
    from memory.

    FontLoadPCL() works only with bitmap fonts, not with scalable (PCL5)
    fonts.

    HP LaserJet fonts are designed at a resolution of 300 DPI, but faxes are
    drawn at 200 DPI.  FontLoadPCL() does not scale the fonts it loads; as a
    result, the fonts appear 50% larger than they would on a LaserJet--a 10
    point font becomes a 15 point font, and so on.

    PCL fonts do not distinguish between the font full name and family name,
    so FontFullName() and FontFamilyName() will be the same for any PCL
    font.  The PCL file format only allows 16 characters for font name, so
    many font names will be cut short.