AVS Modules							plot_xyz_color
Lawrence Berkeley Laboratory					3 May 1991

NAME
	plot_xyz_color

SUMMARY
	Name	plot_xyz
	Type	data
	Inputs	colormap (required)
	Output	geom
	Parameters	Name		Type		Default
			Filename	string		NULL
			Close Region	boolean		true

DESCRIPTION

	This module reads an ASCII file consisting of lists of
	x,y,z points and constructs a polyline geometry object
	using the points in the file as vertices.  Additionally,
        color information is read in on a per-vertex basis, and
        the line segments are color coded as a function of the
        color index specified in the user file and the input colormap.

	The file format this module expects is as follows:

	num_vertices		(integer)
	x y z color		(floating point values)
	x y z color
	  .
	  .
	x y z color
	num_vertices		(integer)
	x y z color
	x y z color
	  .
	  .
	x y z color
	<eof>

INPUTS
	Colormap (required)
		A standard AVS colormap is used to map from a scalar
		value in the user file to a color.

PARAMETERS

	Filename
		A file browser is supplied allowing the user to specify
		a filename for plot_xyz to read.

	Close Region
		A boolean flag which, if true, indicates that a line 
		segment will inserted between the first and last vertices.
		The value of this flag is applied to each set of vertices
		in the file.

OUTPUTS

	A GEOMedit_list which contains a polyline connecting the vertices
	of each group of vertices specified by the user.

EXAMPLE

      GENERATE COLORMAP
            |
      PLOT XYZ COLOR
	    |
      RENDER GEOMETRY
            |
      DISPLAY PIXMAP

LIMITATIONS
	Limited error checking is performed.

AVS Modules							plot_xyz_color
Lawrence Berkeley Laboratory					3 May 1991