MODULE NAME : write_pic_image

OUTPUTS	    : image  2D 4-vector byte

PARAMETERS  : filename

MODULE DESCRIPTION :
     This module writes an image in the pic format from an AVS Network.

FILE TYPE DESCRIPTION :
     pic image files are generated by PIXAR programming software,
     such  as  ChapVolumes and ChapReyes, the PIXAR Image Runtime
     Library called Pirl, and the PIXAR rendering tool RenderMan.
     See  the  PIXAR  documentation set for details on how to use
     these applications and tools.

     PIXAR's pic file format is sometimes referred to as PICIO in
     PIXAR documentation.  pic and PICIO mean the same thing.

     PIXAR's xpic is not the same as pic and is _n_o_t supported  by
     the SDSC image library.

     _N_o_t_e:  PIXAR's RenderMan always saves its image  files  with
     .pic  filename  suffixes.   However,  depending  upon output
     defaults, RenderMan can generate .pic files with PICIO (same
     as  pic)  data or TIFF data.  .pic files with TIFF data will
     confuse the SDSC image library.  For you to avoid generating
     this type of file, we recommend that you configure RenderMan
     defaults to generate .pic files with PICIO data.

FILE RECOGNITION
     PIXAR pic files are recognized  by  the  following  filename



SDSC               Last change: March 4, 1991                   1






IMPIC(3IM)             SDSC IMAGE LIBRARY              IMPIC(3IM)



     suffixes:  .pic, .picio, and .pixar.

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.