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

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 $