AVS Modules 					     trigger int (1)

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

SUMMARY
	TYPE	data input
	AUTHOR  Anonymous g69d
		(Updated original version)
	INPUT
		field (any type)
	OUTPUT
		integer
			
	PARAMETERS
		Name		Type		Default		Min/Max
		start value	integer		0		-100/100
		increment	integer		1 		-100/100
		Current Value   text            NOT EDITABLE
		Reset Value     oneshot         0               0 / 1

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"
	parameter for the first execution.  Subsequent invocations
	cause a static variable to be incremented according to the
	parameter "increment." If the Reset Value button is pressed,
	then the output integer is reset to the start value.  

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

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

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

	Current Value ( text ) - display of the current value of the
	output value.

	Reset Value ( oneshot ) - button to reset the output value to the 
	start value.

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