readme

This is program with source code to convert ascii text files to the maxicode barcode standard.

                            Maxicode_enc.1.0

  Usage:   maxicode_enc input_file output_file

  This is program to convert ascii text files to the maxicode barcode standard.
  The input file consists of two columns.  The first column represents
  a code and the second column is a string enclosed in quotes.  The 
  codes for the first column are as follows:  PM, SM, CC, MO, SC, and PC.
  The following chart explains the usage of each.

        MO      Mode string is specified in second column.  Must be a 
                single digit.  Modes 0 and 1 are obsolete.  Valid
                digit values are 2-6.

        PM      Primary message string.  Second column string is a primary
                message.

        SM      Secondary message string.

        CC      Country code.  If alphanumeric, the country name eg.
                  "United States" is in the second column string.  If
                  numeric, then the second column string is the country code.
                  If the second string is an alphabetic country name, the
                  maxicode_enc program will look up the country to find
                  it's code in its internal database.

        SC      Service class.  The second column specifies a 3 digit
                  service class value.  

        PC      Postal code.  The second column specifies an up to 9 digit
                  postal code value (mode 2) or an up to 6 character 
                  string (mode 3).


   Currently, the program outputs the results in Postscript format.

   This director contains an example for each of the modes.

   example.mode2     Mode 2 example
   example.mode3     Mode 3 example
   example.mode4     Mode 4 example
   example.mode5     Mode 5 example


   The string of characters used by the primary and secondary message can
   also have embedded in them numerically compressed data.  The numeric
   compression can be specified by using \NS followed by a number of digit.s

   For example:

    SM   "this is a test \NS123456789 end of test"

    will have the embedded numerically compress value 123456789.  This
   value is converted to a 30 bit binary number that is used to created five
   6 bit code values that embedded in the message string.