NAME	RESET -- reset geometry viewer to normalize and scale window
	to the current coordinate system, then rescale to reduce its
	size

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

SUMMARY

	Name		RESET	

	Type		mapper

	Inputs		none

	Outputs		none

	Parameters
			Name		Type		Def	Min	Max
			background red	(float)		0.0	0.0	1.0
			background green(float)		0.0	0.0	1.0
			background blue	(float)		0.0	0.0	1.0
			shrink factor	(float) 	0.85	0.5	1.0
			reset now	(oneshot)	0	0	1


DESCRIPTION

If one of the red, green, or blue background colors is changed, the reset
module will execute a "geom_set_background" AVS command to change the
background color.

If the "reset now" button is activated or if the shrink factor is changed,
the module will execute an AVS command to modify the geometry viewer,
invoking calls to
	
	geom_reset
	geom_normalize
	geom_set_camera_params -wsize <camera_size>
	geom_refresh

where

	camera_size = 5.0 + (1.0 - shrink_factor) * 10.0; 

Just as there is only one geometry viewer panel no matter how many geometry
viewer windows are displayed at once, so there should only be one reset
module in a network.  It will operate on the current geometry viewer window
of focus (the one outlined in red).  The user can change the window of
focus to the selected window by clicking inside it with the left mouse button.

INPUTS
(none)

OUTPUTS
(none)

PARAMETERS

background red		red component of the background color

background green	green component of the background color

background blue		blue component of the background color

shrink factor		scale factor after normalization

reset set		indicator to normalize, reset, and shrink

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.
-------------------------------------------------------------------------