Short version documentation for the PCX2SIX file conversion utility.

Purpose: The PCX2SIX utility converts PC pictures stored in the PCX format
         into native VMS SIXEL format.  VMS SIXEL format pictures can be
         viewed on the VAX/VMS system with a simple TYPE <filename> command.

Benefit: The conversion of the PCX files into SIXEL format allows all types
         of pictures to be stored and displayed on the VAX system. The
         pictures can be created on the PC using almost any software.

Usage  : Basic usage is simple.  Create the PC PCX picture using any tool.
         Save the PCX picture.  From DOS run the conversion by entering for
         example,  C:>pcx2six <filename.pcx> <ret>

         This will create a new file <filename.six> in the current directory,
         or the directory referenced as part of <filename>.
         If the <filename> has a PCX extension then there is no need to type
         it in.  If the extension is not PCX then the extension must be
         entered as part of the input filename.

         Transfer the new SIXEL file to the VAX system.
         Display the SIXEL file on VAX using the type command
         Without a VAX show the file with MS-Kermit 3.14 using the command
         REPLAY <filename.six> <ret>

Other Syntax: C:>pcx2six <input> <output.txt> [command line switches] <ret>
              This will create the SIXEL output file named whatever 
              the <output.txt> name is set to.

              C:>pcx2six <input> [/I /P /R /W /S /Mn /Bn /Xn /Yn]
              /I Ignore palette RGB values
              /P Create and use Default 16 color RGB palette
              /R Read in palette file named <input>.PAL
              /W Write palette file named <input>.PAL
              /S Enable SIXEL scrolling
              /M Set Monochrome color to n n=0-15
              /B Scale all palette values by n/100
              /X Set pixel x size to n, used for ratio of x/y
              /Y Set pixel y size to n, used for pixel ratio

ASCII Palette: ASCII format: |R|G|B| sequence. Number of entries either
               16 for 16 colors or 256 for 256 colors.  Use the /W switch
               to create the initial .PAL file.

Note: John Zvonar has no association whatsoever with ZSoft Corporation.
      The utility is supplied as is.  The utility and documentation are
      FREE, please supply both when distributed.  The utility may not be 
      bundled with "FOR SALE" software without prior written agreement 
      from John G. Zvonar. There is no warranty, period! 

      SIXEL output has been tested on TRUE VT340 terminals and various
      terminal emulators.

      Comments, inputs, bug reports, etc, are welcome.
      John Zvonar
      10309 Trout Cove           
      Austin, Tx, 78749

      EMAIL: JohnG.Zvonar@AMD.COM 

.
