                                  [JS_DDB2RAS]
                          (Version 1.0, 28 May 1998)

Program Description:

  Allows the user to convert a Jumpstart Collection Dynamic DataBase 
  (DDB) complex stripmap image to 8-bit Sunraster format.



Program Usage:

     js_ddb2ras -i <infile> -o <outfile> -h -t [0-7]

       Options: -h       = Dump Phoenix (ASCII) header [Def: none]
                -e       = Auto-contrast enhance output data [Def: none]
                -t [0-7] = Convert specific tile of data
                           (ONLY for images whose height >= 1024)

Description of Arguments:

     <infile> : Input (complex) Jumpstart DDB stripmap image filename
     <outfile>: Output Sunraster image filename
     -h       : Optional Phoenix header dump switch
     -e       : Auto-enhance output switch
     -t [0-7] : Optional single tile conversion switch

Files Necessary to Compile:

     * Include : rasterfile.h   (Contains Sunraster file defs.)
     * Source  : js_ddb2ras.c
                 read_switch.c
     * Make    : js_ddb2ras.mk (optional)


Compiling and Linking Code:

   You can compile js_ddb2ras either from the command line or by using the 
   included makefile (note: .mk file).

   a) Command line Method:

        % gcc -c read_switch.c [enter]
        % gcc -o js_ddb2ras js_ddb2ras.c read_switch.o -lm [enter]
      
      NOTE: You can use other C compilers. Edit .mk file as necessary.

   b) Using the Makefile [js_ddb2ras.mk]:

      Perform the following steps:

        % make -f js_ddb2ras.mk        [Creates executable: js_ddb2ras]
        % make -f js_ddb2ras.mk clean  [Deletes object code           ]

