
viff2xbm(1)                  Khoros                   viff2xbm(1)

PROGRAM
     viff2xbm - Converts an Khoros (viff) bitmap file to an X11
     bitmap file (xbm).

SYNTAX
     viff2xbm

     -i             input image

     -o             output resulting xbm definition

     -n             xbm description name

     [-p]           if yes (default) photopositive

     [-V]           Gives the version for viff2xbm

     [-U]           Gives the usage for viff2xbm

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     viff2xbm takes an viff bitmap image and converts it into a
     X11 bitmap format commonly known as xbm.  The xbm file can
     be used in conjunction with X resources, such as icons,
     mouse pointers, stipple paterns, etc.  The xbm format is in
     the form of a C include file, which the user is expected to
     use when programming with X windows or with such programs as
     xsetroot (ie.  xsetroot -bitmap file.xbm).  The following is
     an example of the kill button from a cantata glyph:

     #define kill_width 17
     #define kill_height 21
     static unsigned char kill_bits[] = {
        0x20, 0x40, 0x00, 0x41, 0x22, 0x00, 0x84, 0x10, 0x00, 0x10, 0x89, 0x00,
        0x80, 0x00, 0x00, 0x50, 0x1a, 0x00, 0x0c, 0x62, 0x00, 0xc0, 0x83, 0x00,
        0xc0, 0x13, 0x00, 0x40, 0x00, 0x00, 0xf0, 0x01, 0x00, 0xf8, 0x03, 0x00,
        0xfc, 0x07, 0x00, 0xfe, 0x0f, 0x00, 0xfe, 0x0f, 0x00, 0xfe, 0x0f, 0x00,
        0xfe, 0x0f, 0x00, 0xfe, 0x0f, 0x00, 0xfc, 0x07, 0x00, 0xf8, 0x03, 0x00,
        0xf0, 0x01, 0x00};

     If the input image has more than one band the output xbm
     file will contain each band as the bitmap name followed by
     the band number. ie) bitmap1, bitmap2. etc.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: output resulting xbm definition

     -n     type: string
            desc: xbm description name

OPTIONAL ARGUMENTS
     -p     type: boolean
            desc: if yes (default) photopositive
            default: true

EXAMPLES
     viff2xbm -i bitmap.xv -o bitmap.xbm -n bitmap

     Creates an X11 bitmap file (bitmap.xbm) from the banded viff
     bitmap image stored in bitmap.xv.

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

RESTRICTIONS
     Input image must be a bit image.

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

Khoros                    Release: 1.0                          1

