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 (meaning that all data is compressed before being written to the output file). The image would then occupy much less (hopefully) 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 supported by Khoros.

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