Usage :  imconv [options...] infilename outfilename

Copyright (c) 1989-1995  San Diego Supercomputer Center (SDSC), CA, USA

imconv converts an input image file using one file format to an output
image file with a differing file format.

    -feedback                           Generate a feedback form (bug report)
    -fullhelp                           Display a full-length help message
    -help                               Give help about specific options
    -indpi dots_per_inch                Specify the dpi of the incoming file
    -infile image_filename              Specify an input image file name
    -infilecompression scheme           Specify compression for the -infile
    -informat format_name               Specify the format of the -infile
    -inmap channel_map                  Read one channel into another one
    -inpageheight inches                Specify the page height of an image
    -inpagewidth inches                 Specify the page width of an image
    -outalpha                           Force output of alpha plane with image
    -outchandepth no_bits               Force output of # of bits/channel/pixel
    -outclt                             Force output of a CLT with the image
    -outcompress comp_type              Force output of compressed image
    -outfile image_filename             Specify an output image file name
    -outfilecompression scheme          Specify compression for the -outfile
    -outformat format_name              Specify the format of the -outfile
    -outgroup group_type                Force output of grouped image
    -outindex                           Force output as a color indexed image
    -outinterleave inter_type           Force output of interleaved RGB image
    -outmap channel_map                 Write one channel into another one
    -outnchan no_channels               Force output of # of channels/pixel
    -outnoalpha                         Block output of alpha plane with image
    -outnoclt                           Block output of a CLT with the image
    -outquality whole_number            Force quality of compression
    -outrgb                             Force output as an RGB image
    -outtransparency                    Force single-color transparency
    -outtransparencyindex index         Force single-color transparency
    -outtransparencyrgb r g b           Force single-color transparency
    -register                           Generate a user registration form
    -verbose                            Be verbose
    -version                            Display the command's version numbers

Typical Invocations:
    Read an Alias PIX file and convert it to an HDF file:
        imconv myimage.pix newimage.hdf
      or
        imconv -informat pix myimage.pix -outformat hdf newimage.hdf
      or
        imconv -infile myimage.pix -outfile newimage.hdf
      or
        imconv -informat pix -infile myimage.pix -outformat hdf -outfile newimage.hdf
    Read a SGI RGB file and output an 8-bit Sun rasterfile:
        imconv fullcolor.rgb -outindex indexed.ras
    Read a Compuserve GIF file and output an RGB Wavefront RLB file:
        imconv indexed.gif -outrgb fullcolor.rlb
    Read a Sun Rasterfile and produce a new, uncompressed Sun Rasterfile:
        imconv compressed.ras -outcompress none uncompressed.ras
    Read a PPM image and output an LZW compressed TIFF image:
        imconv big.ppm -outcompress lzw small.tiff
    Read a GIF image, strip off it's color table and write out a RAS image:
        imconv with_clt.gif -outnoclt without_clt.ras

Input File Options
------------------
    It is possible to remap the channels of a file when it is read in
    by using the options above of the form '-...map'.  For more information
    about how to do this, see the help page for such an option.

    For a list of the image formats that are supported, see the help page
    for an option of the form '-...format', or use the 'imformats' command.

    By default, input file's image file formats are determined by the file's
    magic number or the filename extension (like .hdf for HDF files). 
    To override the default, explicit format names may be given using a flag of
    the form -...format.  For instance, -informat hdf to read an hdf file.
    
    A single dash ('-') for an input filename indicates stdin.  When using
    stdin, an explicit format name is necessary.

Output File Options
-------------------
    There are a wide variety of options for customizing an output file.
    In addition to specifying the format, you can specify whether or not
    the output file has a color lookup table (CLT), whether or not the
    output file has an alpha channel, the compression method of the output
    file, the number of channels in the output file, the size of each channel
    in the output file, and various other characteristics.  Refer to the list
    of options above for all such output file parameters.  If you'd like more
    information about any one of these, type 'imconv -help -<option name>'

    For a list of the image formats that are supported, see the help page
    for an option of the form '-...format', or use the 'imformats' command.

    By default, output file's image file formats are determined by the file's
    filename extension (like .hdf for HDF files).  To override the default,
    explicit format names may be given using a flag of the form -...format.
    For instance, -outformat hdf to write an hdf file.
    
    A single dash ('-') for an output filename indicates stdout.  When using
    stdout, an explicit format name is necessary.