TRIGGER_INT(1)                9 March 1993                    TRIGGER_INT(1)
AVS Module 					Lawrence Berkeley Laboratory

NAME
     trigger int - generate an integer whenever new data is presented

SUMMARY
	TYPE	data
	INPUT
		field (any type)
	OUTPUT
		integer
			
	PARAMETERS
		Name		Type		Default		Min/Max
		start value	integer		0		-100/100
		increment	integer		1 		-100/100

DESCRIPTION
	The trigger int module waits for a field to be presented
	on its input port.  When a field (new data) is detected,
	an integer is stuffed into the output port.  

	The value of the integer is determined by the "start value"
	parmeter for the first execution.  Subsequent invocations
	cause a static variable to be incremented according to the
	parameter "increment."

	This module is useful in creating networks to facilitate
	animations based upon a single coroutine.
PARAMETERS

	Start Value - the beginning value used for the integer output
	value.

	Increment - this value will be added to a static variable
	upon each invocation.

EXAMPLE
	We illustrate the use of this module in conjunction with the
	"animate filename" module (available from the IAC) for
	automatically generating filenames.  

	The portion of the network above the "geometry viewer" is
	not included here - that portion is not important.  We assume
	that upon each invocation of the geometry viewer that we wish
	to write out a new image file.  The filenames will be constructed
	by the animate filename, which takes as one of it's parameters
	an integer value used in constructing a filename.  


		GEOMETRY VIEWER
			|
		+-------+-------------+
                |                     |
            trigger int		      |
                |                     |
            animate filename          |
                |                     |
                +------+   +----------+
                     write image

RELATED MODULES
     animate filename
	

TRIGGER_INT(1)                9 March 1993                    TRIGGER_INT(1)
AVS Module 					Lawrence Berkeley Laboratory