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 appropriatly 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.