# README
#
# $Revision: 1.1 $ $Date: 93/05/19 12:09:58 $

This package contains several AVS modules that deal with strings.
They can be compiled individually or together to form a single
executable.  In the latter case, the name of the executable would
be "strings".

To compile each module separately, type (this is the default):

	make

To compile all modules into one executable (to have multiple modules in a
single process), type:

	make single_process

The modules and the supplied Makefile has been tested on SGI, Sun, and Convex.

---

Urs Meyer
Centro Svizzero di Calcolo Scientifico,
Swiss Scientific Computing Center
6928 Manno, Switzerland
umeyer@cscs.ch

NAME
	string to geom - converts a string to a "label" geometry

SUMMARY
	Name		string to geom

	Type		Mapper

	Inputs		Input String -	string OPTIONAL

	Outputs		Label -		geom

	Parameters	
	    Name		Type	Default
	    Font Number		islider	0	0	21
	    Drop Shadow		toggle	off	off	on
	    Text Alignment	radio_buttons	Center	Left:Center:Right   :
	    X Position		slider	0.00	-1.00	1.00
	    Y Position		slider	0.00	-1.00	1.00
	    Text Height		slider	0.10	 0.00	1.00
	    Red			slider	0.70	 0.00	1.00
	    Green		slider	0.70	 0.00	1.00
	    Blue		slider	0.70	 0.00	1.00

DESCRIPTION
    This module creates a "label" style text string in the GEOM format
    which can be used as a title.  It takes a string value as input.
    It can be used to represent some important variable such as time,
    animation step, some parameter, etc.  It has the advantage over the
    labeling facilities in the Geom Viewer in that the information will
    get saved with a network.

    Other things you can control are the font number, drop shadows,
    justification, position, height, and color of the text string.

INPUTS

    Input String - string OPTIONAL
	The string value that is used to generate the geometric object.

PARAMETERS

    Font Number (islider)
	A value from 0 to 21 for the available fonts.  The actual 
	font types vary from system to system.

    Drop Shadow (toggle)
	When on, produces a black drop shadow; when off, does not

    Text Alignment (radio_buttons)
	Choice of Left, Center (default), and Right. Describes the 
	start of the text relative to its (X,Y) position.

    X Position (slider)
    Y Position (slider)
	The position of the text on the screen. (0.0, 0.0) is the 
	center of the window.

    Text Height	(slider)
	A value from 0.0 to 1.0, letting you choose the desired font
	height.

    Red (slider)
    Green (slider)
    Blue (slider)
	The color of the label.

OUTPUTS

    Label - geom
	A geometry that represents the label formed according to the 
	input string.

EXAMPLE NETWORKS

    The following is part of a larger network for creating an 
    animation.  The part shown generates a label based on
    a integer counter.

			animated integer
				|
		       ---------|---------
		      |                     |
		int to string              ...
		      |
		string to geom 
		      |        
		      |----------          ...
				 |          |
		                geometry viewer
				       |
				      ...

RELATED MODULES

    Modules which generate the string input:
	int to string
	float to string
	character

    Modules which accept the geom output:
	geometry viewer

AUTHOR

    Urs Meyer
    Centro Svizzero di Calcolo Scientifico,
    Swiss Scientific Computing Center
    6928 Manno, Switzerland
    umeyer@cscs.ch

    Based on "Title" by Roy Wirthlin, Advanced Visual Systems Inc.

DATE
    $Date: 93/05/19 14:32:11 $