AVS Modules					       dump icc

NAME
     dump icc - convert pixmap to "icc" format and store in file

SUMMARY
     Name	   dump icc

     Type	   renderer

     Inputs	   pixmap (required; pixmap)

     Outputs	   none

     Parameters	   name		   type
		   filename	   browser

DESCRIPTION
     The dump icc module converts its input pixmap to the so-called
     ICC format.  This image format is used by local device drivers
     which communicate with the Kodak XL7700 printer.
     

INPUTS

     pixmap (pixmap)
	  Any AVS pixmap.

PARAMETERS

     filename
	  A file browser that allows you to specify the	name of	the
	  ICC file to be created.  After the file is written, the
	  filename is reset to NULL.  This prevents subsequent changes
	  upstream in the network from automatically triggering	the
	  rewriting of the file.  A new	file is	written	only when you enter
	  a filename.


EXAMPLE
     This example converts an image to a ICC file:

	   READ	IMAGE
	       |
	  IMAGE	TO PIXMAP
	       |
	    DUMP ICC


LIMITATIONS
	The routine will crash with a "protocol error" message 
	if the pixmap does not exactly contain the image (read
	image, the stardent.x image, to image to pixmap, to
	dump icc will fail.).  This is a shortcoming in the
	image to pixmap module.  The workaround is to use
	the image 2 icc module to write image fields directly.

	Using this module on 8bit X displays will generate
	errors.

Lawrence Berkeley Lab

