AVS Modules						transform tool
College of Chemistry, UCB

NAME
        transform tool - distribute geometric transformations	

SUMMARY
	Name	transform tool
	Type	Mapper
	Inputs	Transform - 	struct upstream_transform 

	Outputs	Control List - 	geom
		Move List - 	geom

	Parameters
	Name		Type	Default	Choices
	control object	typein			Text
	object to move	typein			Text

DESCRIPTION
	The transform tool module is used to obtain a copy of the
	current transformation matrix from the geometry viewer and
	apply it to an oject in another geometry viewer window.  For 
	example, to capture the transformation for the top object in
	one geometry viewer window and apply it to the top object in
	another geometry viewer window, set both typein values to
	%top.  Currently, the transformation is only used after motion
	of the control geometry stops.  Experienced users may experiment
	with the flags setting in the GEOMedit_transform_mode call
	in the module code to alter this behavior.

INPUTS
	Transform - struct upstream_transform
		This is required for the module to do anything
		useful.  The user needs to enable and connect the
		upstream_transform output port of the geometry
		viewer module that contains the control object.

PARAMETERS

	control object (typein)
		the name of the geometry object that will be used
		to get the transformation information.

	object to move (typein)
		the name of the geometry object that will have
		the transformation applied to it.

OUTPUTS

	Control List - geom
		this geometry edit list is connected to the geometry
		viewer module that will export the transformation.

	Move List - geom
		thie geometry edit list is connected to the geometry
		viewer module that will import the transformation.

EXAMPLE NETWORKS
	The following network is a typical implementation:

			           |--|
	READ GEOM      TRANSFORM TOOL |		READ GEOM
	       |	       |   |  |		       |
	       |-----------|---|   |---------------|---|
			   |	      |        |	
		GEOMETRY VIEWER	      | GEOMETRY VIEWER
				      |        |	
				      |--------| 

RELATED MODULES
	READ GEOM
	GEOMETRY VIEWER
	RENDER GEOMETRY

College of Chemistry, UCB					4/1/93
Tim O. Robinson