MODULE NAME : read_xbm_image

INPUTS	    : image  2D 4-vector byte

PARAMETERS  : filename

MODULE DESCRIPTION :
     This module reads an image in the xbm format into an AVS Network.

FILE TYPE DESCRIPTION :
     xbm bitmap image files are generated by MIT's X Window  Sys-
     tem,  version  11 (hereafter referred to as X11).  xbm files
     are generated by the X11 bitmap(1) bitmap editor and used by
     most  X11  tools  to  define cursors, icons, and other mono-
     chrome glyphs.  See the X11 documentation set for details on
     how to use tools and subroutines dealing with X11 bitmaps.

FILE RECOGNITION
     X11 xbm files are recognized by the following filename  suf-
     fixes:  .xbm and .bm.

NOTE :
   This module requires that libim.a and libsdsc.a be installed in
   the /usr/lib directory for compilation with the given Makefiles.
   Both of these libraries can be obtained through anonymous ftp to
   sdsc.edu.  For more information, send email to info@sdsc.edu.

CREDITS
-------

MODULE AUTHOR:	Terry Myerson
		International AVS Center
		North Carolina Supercomputing Center
		avs@ncsc.org

This module is entirely based upon the San Diego Supercomputing Center's
Image Tool library.