
viff2tiff(1)                 Khoros                  viff2tiff(1)

PROGRAM
     viff2tiff - Convert a VIFF image to a TIFF image

SYNTAX
     viff2tiff

     -i             input VIFF image

     -o             resulting TIFF image

     [-v]           verbose mode

     [-t]           compression type:
                    1 (None),
                    2 (LZW),
                    3 (CCITTFAX3),
                    4 (CCITTRLEW),
                    or 5 (PACKBITS)
                       [default = 2]

     [-V]           Gives the version for viff2tiff

     [-U]           Gives the usage for viff2tiff

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     viff2tiff converts a Khoros VIFF image to a TIFF image. TIFF
     stands for Tag Image File Format. The -v option specifies
     verbose mode. In verbose mode, information about the input
     VIFF image and output TIFF image is printed out.

     The viff2tiff converter is somewhat limited. Input VIFF
     images must be either 1 band or 3 band images. If the image
     is a 1 band image, it may contain a map with either 1 column
     or 3 columns. The resulting TIFF image will contain a 256 by
     3 colormap (RGB). So, if a VIFF file has a 1 column map,
     that column is duplicated to form the 3 column TIFF image
     colormap. Also, the input VIFF image must be of data storage
     type BIT or BYTE.

     The viff2tiff routine supports a few different compression
     schemes.  These are:

             NONE
             LZW
             CCITTFAX3 - only works if the input VIFF image is of
     type BIT
             CCITTRLEW
             PACKBITS - used for the Machintosh

     The resulting TIFF image will have all fields set appropri-
     atly based on the information from the VIFF image. The TIFF
     image is always written out with the pixels stored on
     separate "sample planes"

     Viff2tiff uses the public domain TIFF library utilities to
     write the resulting TIFF image. This routine (viff2tiff) is
     based on Release 2.2 of libtiff. The source for libtiff is
     as follows:

     The software is available for public ftp on
         ucbvax.berkeley.edu         pub/tiff/tiff.tar.Z
             (128.132.130.12)
         uunet.uu.net                graphics/tiff.tar.Z
             (192.48.96.2)

     Libtiff provides the mechanisms to read, write, uncompress
     and compress TIFF images.

     Becasue the TIFF (Tag Image File Format) image specification
     is long and involved, please see the TIFF 5.0 specification.
     This specification can be obtained from:

             Developers' Desk
             Aldus Corp.
             411 First Ave. South
             Suite 200
             Seattle, WA 98104
             (206) 622-5500

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input VIFF image

     -o     type: outfile
            desc: resulting TIFF image

OPTIONAL ARGUMENTS
     -v     type: boolean
            desc: verbose mode
            default: false

     -t     type: integer
            desc: compression type
            allowed values:
            1 (None),
            2 (LZW),
            3 (CCITTFAX3),
            4 (CCITTRLEW),
            or 5 (PACKBITS)

EXAMPLES
     viff2tiff -i image.viff -o image.tiff -v 1 -t 1

     This will convert a VIFF image to a TIFF image. The -v flag
     (verbose) set to 1 will force information about both images
     to be printed. The -t option specifies not to use any
     compression when writing out an image.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lviff2tiff(3)
     tiff(n), tiff2viff(1), ltiff2viff(3)

RESTRICTIONS
     Viff2tiff works only on VIFF images that have a data storage
     type of BIT or BYTE, and either 1 or 3 data bands. If the
     image has 1 data band and is byte, it is valid to have an
     either 1 column or 3 column map.

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

Khoros                    Release: 1.0                          1

