
vencode(1)                   Khoros                    vencode(1)

PROGRAM
     vencode - Change the data encoding scheme of an image

SYNTAX
     vencode

     -i             input image

     -o             output image

     [-s]           Encoding scheme:
                    0 (Raw (uncompressed) encoding),
                    1 (compress(1) encoding),
                    2 (RLE encoding),
                    3 (Transform encoding),
                    4 (CCITT encoding),
                    5 (ADPCM encoding),
                    or 6 (Generic (site local) encoding)
                       [default = 0]

     [-V]           Gives the version for vencode

     [-U]           Gives the usage for vencode

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vencode is used to change the data encoding or compression
     scheme of an image.  For example, one might to change the
     encoding scheme of a large image from VFF_DES_RAW (meaning
     the data is stored as raw binary) to VFF_DES_COMPRESS (mean-
     ing that all data is compressed before being written to the
     output file). The image would then occupy much less (hope-
     fully) space on disk than before, but at the cost of having
     to decode the data in the image every time it is read, and
     re- encoding the data upon output.

     If the encoded data should happen to be larger than the ori-
     ginal data, the original data is stored and the encoding
     scheme is ignored (but is still kept track of).

     There is currently only one encoding or compression method
     implemented in Khoros: compress(1). Hooks are built in for
     many other methods.

     The allowable values for the -s option are:
      0      VFF_DES_RAW       - no encoding
      1      VFF_DES_COMPRESS  - compress data using compress(1)
      2      VFF_DES_RLE       - run length encoding
      3      VFF_DES_TRANSFORM - encoding using transform coeffs
      4      VFF_DES_CCITT     - encoding using CCITT standard
      5      VFF_DES_ADPCM     - encoding using adaptive PCM
      6      VFF_DES_GENERIC   - site specific encoding

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: output image

OPTIONAL ARGUMENTS
     -s     type: integer
            desc: Encoding scheme
            allowed values:
            0 (Raw (uncompressed) encoding),
            1 (compress(1) encoding),
            2 (RLE encoding),
            3 (Transform encoding),
            4 (CCITT encoding),
            5 (ADPCM encoding),
            or 6 (Generic (site local) encoding)

EXAMPLES
     vencode -i feath.xv -o feath.xv -s 1

     changes the encoding scheme of image "feath.xv" to use
     compress(1), and results in "feath.xv" being stored on disk
     in compressed form.

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

RESTRICTIONS
     Currently only the VFF_DES_COMPRESS encoding scheme is sup-
     ported by Khoros.

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

Khoros                    Release: 1.0                          1

