
tiff2viff(1)                 Khoros                  tiff2viff(1)

PROGRAM
     tiff2viff - Converts a TIFF image to a Khoros VIFF image

SYNTAX
     tiff2viff

     -i             input TIFF image

     -o             resulting VIFF image

     [-v]           verbose mode

     [-V]           Gives the version for tiff2viff

     [-U]           Gives the usage for tiff2viff

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     tiff2viff converts a TIFF image to a Khoros VIFF image. The
     -v option specifies verbose mode. In verbose mode, informa-
     tion about the input TIFF image and output VIFF image is
     printed out.

     Tiff2viff will convert TIFF images setting the TIFF header
     values as follows:

     BitsPerSample
          If the TIFF image has 1 bit per sample the resulting
          VIFF image will be of type BIT. Otherwise the resulting
          image will be of type BYTE.  Tiff2viff will not accept
          a TIFF image with the bits per sample greater than 8.

     SamplesPerPixel
          Tiff2viff will convert TIFF images that contain either
          1, 3 or 4 samples per pixel. If the samples per pixel
          is 1, then the resulting VIFF image will contain one
          data band. If the samples per pixel is 3 or 4, then the
          resulting VIFF image will contain 3 data bands. In the
          3 data band case, the image is most likely a true RGB
          image (24 bits).

     PhotometricInterpretation
          Tiff2viff will convert TIFF images with a photometric
          interpretation of Min Is Black, Min Is White, RGB, and
          Palette. In the case that the TIFF image is Min Is
          Black, the resulting VIFF image will be a single band
          grey scale image with the black pixel equal to 0. In
          the case that the TIFF image is Min Is White, the
          resulting VIFF image will be a single band grey scale
          image with the white pixel equal to 0 (this is an
          inverted image). If the TIFF image's photometric
          interpretation is set to RGB, the resulting VIFF image
          will contain 3 data bands, one for red, one for green
          and one for blue (true RGB).  The color space model is
          set to generic_RGB. Finally, if the TIFF image's pho-
          tometric interpretation is set to Palette, the result-
          ing VIFF image will contain a 3 column by N color
          colormap. The color space model is set to generic RGB.
          Note, Tiff2viff does not support photometric interpre-
          tation of Mask and Depth.

     PlanerConfiguration
          Tiff2viff supports a TIFF image that contains a con-
          tiguous planer configuration or a separate configura-
          tion. Planer Configuration is only important with the
          TIFF image is a true 24 or 32 bit RGB image. The TIFF
          contiguous planer configuration implies that the pixels
          are arranged as RGBRGBRGB..., where as a separate
          planer configuration implies that the pixels are for
          each color component (red, green and blue) are stored
          as planes of bands. Note, a VIFF image always stores an
          image with the color compenents in separate bands.

     Compression
          The compression type supported are limited to the sup-
          port provided by the public domain TIFF library utili-
          ties. The current compression types supported are:
          None, LZW, CCITTFAX3, CCITTRLEW and PACKBITS.

     Tiff2viff uses the public domain TIFF library utilities.
     This routine 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 TIFF image

     -o     type: outfile
            desc: resulting VIFF image

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

EXAMPLES
     tiff2viff -i image.tiff -o image.viff -v 1

     This will convert a TIFF image to a VIFF image. The -v flag
     (verbose) set to 1 will force information about the TIFF
     image to be printed.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ltiff2viff(3)
     viff2tiff(1), libtiff(3)

RESTRICTIONS
     Tiff2viff does not support TIFF images that contain more
     that 8 bit per sample.  Also, the photometric interpretation
     of transparency mask and depth are not supported.

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

Khoros                    Release: 1.0                          1

