/*****************************************************************************/
/*                                                                           */
/*                                                                           */
/*                 XXXX   XXXXX  XXXX   X   X   XXX   XXXXX                  */
/*                 X   X  X      X   X  X   X  X   X  X                      */
/*                 X   X  X      X   X  X   X  X      X                      */
/*                 XXXX   XXX    X   X  X   X  X      XXX                    */
/*                 X X    X      X   X  X   X  X      X                      */
/*                 X  X   X      X   X  X   X  X   X  X                      */
/*                 X   X  XXXXX  XXXX    XXX    XXX   XXXXX                  */
/*                                                                           */
/*                                                                           */
/*                            Reduce Music Roll                              */
/*                         Program by Wayne Stahnke                          */
/*                                                                           */
/*****************************************************************************/

/* This program converts a music roll image from the ".map" file format to the
    ".raw" file format, reducing the file size by about 25:1 in doing so.  It
    is invoked by the command line

            REDUCE [argument1 [argument2 [argument3 [...]]]]

    where the command line arguments may be filenames (with or without paths
    and with or without extensions) or keywords.  The first filename (which
    must exist) is the name of the source file to be reduced, and the second
    filename (if it exists) is the name of the reduced target file created by
    this program.  If only the source filename is given, it is assumed to be
    the default target filename.  The default source file extension is ".map"
    and the default target file extension is ".raw".

    The following keywords are supported:

        /b&w                        enable black-and-white scale,
        /l[inear]                   enable linear functional form,
        /q[uadratic]                enable quadratic functional form,
        /c[hord]                    determine chord length (not diameter),
        /d[ark]:<integer>           set dark threshold to <integer> pixels,
        /m[ap]                      enable centerline display and map display,
        /b[argraph]:<integer>       display bargraph of area of port <integer>,
        /f[lat]:<real>              set flat shrinkage to millimeters,
        /t[hreshold]<real>          set threshold to millimeters */

/*****************************************************************************/