NAME	TEXT TO GEOM -- create a label geometry from the input string

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

SUMMARY

	Name		TEXT TO GEOM	

	Type		mapper	

	Inputs		input string		(string)	

	Outputs		geom_output		(geometry)

	Parameters
			Name			Type	Def	Min	Max
			----			----	---	---	---
			x ref point		(float)	0.0	UNBOUND	UNBOUND
			y ref point		(float)	0.0	UNBOUND	UNBOUND
			z ref point		(float)	0.0	UNBOUND	UNBOUND
			x offset		(float)	0.0	UNBOUND	UNBOUND
			y offset		(float)	0.0	UNBOUND	UNBOUND
			z offset		(float)	0.0	UNBOUND	UNBOUND
			height			(float) 0.07	0.0	UNBOUND
			red			(float)	1.0	0.0	1.0
			green			(float)	1.0	0.0	1.0
			blue			(float) 1.0	0.0	1.0
			font			(int)	1	0	21
			background rectangle	(toggle) 0	0	1
			title string		(toggle) 0	0	1
			drop shadow		(toggle) 0	0	1
			alignment		(choice) LEFT

DESCRIPTION

The TEXT TO GEOM module creates a geometry of the input string based upon
the AVS standard set of geometry label controls.

INPUTS

input string		string for which a label geometry is generated 

OUTPUTS

geom_output		label geometry output

PARAMETERS

x ref point		
y ref point		
z ref point		reference point for the label in screen space
			(-1,-1,-1) to (1,1,1) for title strings; reference
			point is in the same coordinate system as the other
			elements in the geometry viewer for non-title strings

x offset
y offset
z offset		offset values in screen space applied after the
			reference point is set (or transformed for non-title
			strings)

height			height of the selected font for the label

red			red component of the label color

green			green component of the label color

blue			blue component of the label color

font			AVS font number in the range of 1-21

background rectangle	toggle indicating if the background rectangle that
			encloses the text should be drawn

title string		toggle indicating whether string is considered  a
			window title with screen space coordinates or a
			non-title string with coordinates to match other
			elements of the geometry viewer

drop shadow		toggle indicating if a one-pixel drop-shadow highlight
			should be added to the text

alignment		choice of LEFT, CENTER, RIGHT for specifying the
			position of the reference point within the label

RELATED MODULES

LIMITATIONS

This function is needed only for AVS 4.0.  The standard AVS Data Input
module "label" can be used for AVS 5.0 systems.

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