AVS Modules						          read sunras
Lawrence Berkeley Laboratory					  28 Jan 1992

NAME
     read sunras - read a sun rasterfile into an AVS image field.

SUMMARY
     Name	   read	sunras

     Type	   data

     Inputs	   none

     Outputs	   field 2D 4-vector byte

     Parameters	   _N_a_m_e		   _T_y_p_e		  _D_e_f_a_u_l_t	 _M_i_n	   _M_a_x
		   Input File	   Browser	  not applicable

DESCRIPTION
     "read sunras" will read an image stored in the SUN Rasterfile
     format, placing the results into an AVS image field.

     Most sun rasterfile formats are supported (the exceptions being
     RT_FORMAT_TIFF and RT_FORMAT_IFF).  Run-length-encoded, BGR and
     RGB formats are supported.  Most depths, as well are supported.
     The exception is that depth=1 (monochrome) is NOT supported.

     This module will also decompress files which have been compressed
     using the UNIX(tm) "compress" utility (by checking for the existance
     of a ".Z" suffix.

PARAMETERS

     Input Image
	  The name of the compressed image file.

OUTPUTS

     Output Image
	The standard AVS image; 2D 4-vector byte field.


RELATED	MODULES
     dump sunras

BUGS
     Two of the less common image file formats are not supported.  If
     this is a problem for you, please contact the author and encourage
     an upgrade.  Testing of this module on a variety of different 
     sun rasterfiles has been performed, however, it is expected that 
     some variants may have slipped through the cracks.  Again, contact
     the author, and be prepared to provide a file which breaks
     the module.

AUTHOR
     Wes Bethel, Lawrence Berkeley Laboratory
     ewbethel@lbl.gov, phone: (510) 486-6626

SEE ALSO
     UNIX(tm) compress, uncompress

AVS Modules						          read sunras
Lawrence Berkeley Laboratory					  28 Jan 1992