NAME	ANIMATE DUAL -- control 1 or 2 animations

AUTHOR	Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240

SUMMARY

	Name		ANIMATE DUAL	

	Type		data_input	

	Inputs		none

	Outputs		output_integer_1	(int)
			output_integer_2	(int)

	Parameters	Name		Type	Default	 Min	 Max
			----		----	-------	 ---	 ---
			Current Value 1	int	0	-1000000 1000000	
			Min Value 1	int	0	-1000000 1000000
			Max Value 1	int	0	-1000000 1000000
			Delta 1		int	1	-100	 100
			Current Value 2	int	0	-1000000 1000000
			Min Value 2	int	0	-1000000 1000000
			Max Value 2	int	0 	-1000000 1000000
			Delta 2		int	1	-100	 100
			Go		toggle	0	0	 1
			One Step	toggle	0	0	 1
			Pause Seconds	int	0	0	 10	

DESCRIPTION

Unlike the AVS module, "animated integer", this animator co-routine keeps up
with the range of the values available.  It also allows the user to set a
delta value for going forward (positive) or backward (negative).  Additionally,
the user can advance by single steps through data or continuously.  When
the end of the range is reached, the animator will wrap around the end of
the range to the opposite end by delta.  A second set of variables allows
the synchronous control of two viewing windows.  Output from the animator will
cease for "Pause Seconds" # after each previous output.

For connection to an AVS reader module to control record number updates to
effect animation, output_integer_1 should be wired to an integer port visible
input parameter on the reader.  The reader module should output number of
hours and current hour, and these should be wired to the ANIMATE DUAL input
ports "Max Value 1" and "Current Value 1", respectively, for a first window.
For a seconds window, these should be wired to the ANIMATE DUAL "Max Value 2"
and "Current Value 2" input ports.

For better coordination between the reader and the animator, perhaps a more
ideal arrangement would be to make the reader have 3 record values (current,
min, and max) to match those of the animator.

INPUTS
(none)

OUTPUTS

output_integer_1	animator #1 output

output_integer_2	animator #2 output

PARAMETERS

Current Value 1		the current element # for animation sequence #1

Min Value 1		the minimum element # for animation sequence #1

Max Value 1		the maximum element # for animation sequence #1

Delta 1			the element increment for animation sequence #1

Current Value 2		the current element # for animation sequence #2

Min Value 2		the minimum element # for animation sequence #2

Max Value 2		the maximum element # for animation sequence #2

Delta 2			the element increment for animation sequence #2

Go			toggle begin animation

One Step		toggle stop animation after a single set of outputs

Pause Seconds		# seconds to pause between sets of output 

EXAMPLE

RELATED MODULES

LIMITATIONS

SEE ALSO

(MCNC Visualization Plan)						11/93

-------------------------------------------------------------------------
The MCNC Environmental Programs Group has created this module as part of a
suite of AVS demo modules, networks, and sample data sets to demonstrate 
the functionality of its visualization prototype for an Environmental 
Decision Support System (EDSS).  This system provides a unified method of 
analysis and visualization for data output from different environmental air 
quality models.  Remotely, standard output files from the following models 
can be read into AVS:

        ROM (Regional Oxidant Model)
        RADM (Regional Acid Deposition Model), low res and high res
        RADM (Regional Acid Depostion Model) Emissions, low res
        UAM (Urban Airshed Model, regulatory version)
        UAM (Urban Airshed Model, AREAL research version)
        UAM Wind (Urban Airshed Model, regulatory version)
        MCNC ALPHA-Prototype netCDF files

Alternatively, xdr portable binary AVS fields can be created from these
data types and accessed directly from the local workstation.

You can download these modules individually from the IAC using anonymous
ftp to the appropriate directories /avs_modules at avs.ncsc.org.  
If you would like to download the entire suite of modules, networks, and
sample datasets at the same time, the IAC recommends that you use 
anonymous ftp to grab the following file from avs.ncsc.org -

/sample_data/avs_data/MCNC_Env_Pgms/MCNC_Env_Pgms.tar.Z

This contains all source code to all local and remote modules, as well as
all of the sample datasets, networks, documentation, installation, and
usage notes.
-------------------------------------------------------------------------