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.