
xbm2viff(1)                  Khoros                   xbm2viff(1)

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

SYNTAX
     xbm2viff

     -i             input xbm file defintion

     -o             output resulting viff image

     [-p]           Photonegative output

     [-V]           Gives the version for xbm2viff

     [-U]           Gives the usage for xbm2viff

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     Converts an X11 bitmap file (xbm) to an Khoros (viff) bitmap
     file -man1_long_description-end

     -man1_long_description xbm2viff takes an X11 bitmap file
     (xbm) and converts it into an viff bitmap image.  The xbm
     file is 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};

     Other examples of X11 bitmap files (xbm) can be found in
     $KHOROS_HOME/data/bitmaps.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input xbm file defintion

     -o     type: outfile
            desc: output resulting viff image

OPTIONAL ARGUMENTS
     -p     type: boolean
            desc: Photonegative output
            default: false

EXAMPLES
     xbm2viff -i bitmap.xbm -o bitmap.viff -p 0

     Creates a viff single bitmap image, stored in bitmap.xv,
     from an X11 bitmap file (bitmap.xbm)

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

RESTRICTIONS
     Only the first bitmap definition is taken, the rest are
     ignored.

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

Khoros                    Release: 1.0                          1

