
NAME : sphere

AUTHOR : Beth Hess under the supervision of Dr. Susanna Wei
	 St. Joseph's University

SUMMARY :
	Name		sphere
	Type 		Input
	Inputs		None
	Outputs		geom

	Parameters
	Name		Type		Default		Min/Max/Choices
	data_file	browser		
	read_write	radio_buttons	write		read:write
	sphere		typein_integer	  20		  0	21
	color_on	toggle		   0		  0	 1
	x		typein_real	 0.0		-50.0	50.0
	y		typein_real	 0.0		-50.0	50.0
	z		typein_real	 0.0		-50.0	50.0
	radius		typein_real	 0.0		  0.0	10.0

DESCRIPTION :

This module creates spheres when a midpoint and a radius are entered.

Steps to create spheres :
	1. select a sphere number
	2. enter the midpoint coordinates
	3. enter the radius
	4. write the parameters to a data_file from which the data can be
	   read, altered and rewritten.

NOTE :

Each sphere is a separate object.

Once a sphere number is selected, it is possible to select color_on which will
change the color of the selected sphere from white to green.  In this manner
it is possible to determine which is the current (active) sphere.

A sphere may be deleted by setting its radius parameter to zero.

PARAMETERS :

data_file (browser)
This is a file browser which is used to select the read or write file.

read_write (radio_buttons)
Select read or write in connection with the selected data_file browser.

sphere (typein_integer)
Select the current sphere number.  The first sphere is sphere number 0.

color_on (toggle)
Turn on this toggle to change the color of the current sphere from white to
green.

x, y, z (typein_real)
These are the midpoint coordinates of the active sphere.

radius (typein_real)
This is the radius of the sphere.

OUTPUTS :

This module outputs a geom which is a collection of sphere objects.

EXAMPLE NETWORKS :

		sphere
		   |
		geometry viewer

