
fits2viff(1)                 Khoros                  fits2viff(1)

PROGRAM
     fits2viff - Converts a FITS file format to the VIFF image
     file format.

SYNTAX
     fits2viff

     -i             input FITS data file

     -o             resulting output image (viff file)

     -c             lets user chose color space model:
                    0 (no model),
                    1 (choose ntscRGB model),
                    15 (choose genericRGB model),
                    7 (choose cieRGB model),
                    2 (choose ntscCMY model),
                    3 (choose ntscYIQ model),
                    4 (choose HSV model),
                    5 (choose HLS model),
                    6 (choose IHS model),
                    8 (choose cieXYZ model),
                    9 (choose cieUVW model),
                    10 (choose cieucsUVW model),
                    11 (choose cieucsSOW model),
                    12 (choose cieucsLab model),
                    or 14 (choose GENERIC model)

     [-V]           Gives the version for fits2viff

     [-U]           Gives the usage for fits2viff

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called fits2viff.ans
                    or file1

     [-a [file1]]   Uses fits2viff.ans or file1 as the answer
                    file

DESCRIPTION
     fits2viff is a routine that converts a FITS image file for-
     mat into a VIFF file format. The FITS image file format
     describes the standard astronomical image format. This for-
     mat is based on record sizes of 2880 byes.

     The following fields in the VIFF image header are set as
     follows:

     1.   data_storage_type = Dependent on input file

     2.   data_encode_scheme = RAW

     3.   map_scheme = NONE

     4.   map_enable = OPTIONAL

     5.   location_type = NONE

     6.   pixsizx, pixsizy, startx, starty = 0

     7.   num_images = 1

     The remaining fields are obtained from the FITS image
     header.

     IMPORTANT

     The utilities used to read and write the FITS image file are
     machine dependent.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input FITS data file

     -o     type: outfile
            desc: resulting output image (viff file)

     -c     type: integer
            desc: lets user chose color space model
            allowed values:
            0 (no model),
            1 (choose ntscRGB model),
            15 (choose genericRGB model),
            7 (choose cieRGB model),
            2 (choose ntscCMY model),
            3 (choose ntscYIQ model),
            4 (choose HSV model),
            5 (choose HLS model),
            6 (choose IHS model),
            8 (choose cieXYZ model),
            9 (choose cieUVW model),
            10 (choose cieucsUVW model),
            11 (choose cieucsSOW model),
            12 (choose cieucsLab model),
            or 14 (choose GENERIC model)

OPTIONAL ARGUMENTS
     none

EXAMPLES
     fits2viff -i image.fits -o image.viff -c 1

     This will convert an image in the FITS image file format to
     an image in VIFF image file format.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lfits2viff(3)

RESTRICTIONS
     Only 2D FITS images are currently supported.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

