MODULE NAME : read_icon_image

INPUTS	    : image  2D 4-vector byte

PARAMETERS  : filename

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

FILE TYPE DESCRIPTION :
     icon image files are used by Sun Microsystem's SunView  win-
     dow  system,  NeWS window system, OpenWindows NeWS tool set,
     and X11 XView tool set for the storage  of  icons,  cursors,
     fill  patterns,  and  pieces  of widgets (like button check-
     marks).

     Sun icon files can be  most  easily  generated  using  Sun's
     iconedit(1)  icon and cursor editor.  The Sun operating sys-
     tem release includes a directory of standard icons, cursors,
     background patterns, and widget pieces in icon format in the
     directory /usr/include/images.  See  the  Sun  documentation
     set  for  details  on  how to use the tools dealing with Sun
     icon files.

FILE RECOGNITION
     Sun icon files are recognized by  these  filename  suffixes:
     .icon, .cursor, and .pr.

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.