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

 RipBegin
 Create a fax
------------------------------------------------------------------------------
 Syntax

    RipBegin(<cFile>, [<nWidth>], [<nLength>], [<nResolution>])

 Parameters

    <cFile> is the name of the output file.

    <nWidth> is the page width, in RIP units.  The default width is 1728
    pixels, just over 8.5".

    <nLength> is the maximum page length, in RIP units.  The default length
    is 2200 high-res pixels or 1100 low-res, approximately 11".

    <nResolution> is the output resolution:

    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.

 Description

    RipBegin() initializes the RIP, creates the specified output file, and
    prepares for drawing on the first page of the new fax.

    Only five specific values of <nWidth> are valid.  These correspond to
    five allowable page widths that are supported by fax machines:

         864 pixels  (4.32 inches)
        1216 pixels  (6.08 inches)
        1728 pixels  (8.64 inches)  * Default
        2048 pixels (10.24 inches)
        2432 pixels (12.16 inches)

    Every fax machine supports the default width of 1728 pixels.  The other
    sizes are optional, and rare.  If <nWidth> is zero or omitted, RipBegin
    will use the default width, 1728 pixels.  Otherwise, it must be exactly
    equal to one of the values in this list.

    <nLength>, the page length, defaults to 11".  Most fax machines will
    accept pages slightly longer than this, but some will cut off or not
    print the bottom 1/4" or so.  RipBegin() will accept a maximum length of
    about 24" at high resolution, 48" at low resolution, depending on the
    page width and available memory.  It will accept very short page
    lengths, but some fax machines will do weird things with pages under
    about 4" long.