NAME:		plato

AUTHOR INFO:	Larry Gelberg, Stardent Computer, 617-964-1000

SOURCE FILE:	solids.c

TYPE:		data

INPUTS:		NONE

OUTPUTS:	GEOM

PARAMETERS:     Name		Type	Default		Min	Max 	Choices
		Stellate 1	float	0.0		-1.0	1.0
		Stellate 2	float	0.0		-1.0	1.0
		solid		choice	tetrahedron			tetrahedron
									cube
									octahedron
									dodechedron
									icosahedron
		coloring	choice	solid				solid
									star
									random2
									random3

DESCRIPTION:
	This module generates GEOM versions of the five platonic
solids. It also allows for both primary and secondary stellations of
the faces and random coloring of the vertecies. The 'Stellate 1'
knob pokes the centroid of each face in or out. The 'Stellate 2' knob
then does the same thing to each of the resulting triangles. The
coloring selections provide either pre-chosen coloring schemes or
either two or three random colors per triangle. Hitting these buttons
again and again will give you continuously different colorings.

	While this is generally meant to be a fun demonstration
module, it is a good road map for a module for easily creating and
interacting with geometric objects.

EXAMPLE NETWORK:
	
	PLATO
	  |
    RENDER MANAGER


SEE ALSO: SUPER_ELLIPSE (AVS User Module Library)






NAME:		super ellipsoids

AUTHOR INFO:	Larry Gelberg, Stardent Computer, 617-964-1000

SOURCE FILE:	solids.c

TYPE:		data

INPUTS:		NONE

OUTPUTS:	GEOM

PARAMETERS:     Name		Type	Default		Min	Max 	Choices
		type		choice	Ellipse				Ellipse, Torus
		Mesh Res	integer	10		4	50
		Obalte E	float	1.0		0.0	5.0
		Prolate E	float	1.0		0.0	5.0
		X Axis		float	1.0		0.0	5.0
		Y Axis		float	1.0		0.0	5.0
		Z Axis		float	1.0		0.0	5.0
		Torus Rad 1	float	2.0		0.0    10.0
DESCRIPTION:
	This module generates super-ellipsoids and super-torii with a
lot of control over the various parameters. The difference between a
super-ellipse and a regular ellipse can be learned by comparing their
equations: 

	ELLIPSE: 	(x/a)**2 + (y/b)**2 + (z/c)**2 = 1

	SUPERELLIPSE: 	(x/a)**E + (y/b)**E + (z/c)**E = 1

where E is a floating point number. When E gets close to zero, the
ellipse approaches a rectangle in shape. When E = 1.0, the shape is a
pure ellipse, when E is > 2.0, the shape looks like a pinched-in star.
The controls for this module are:

Type:		chooses either ellipsoids or torii
	
Mesh Res:	the square root of the number of polygons

Oblate E:	The ellipsivity in the "profile" direction

Prolate E:	The ellipsivity in the "cross-section" direction

X-Axis:		Length-wise scale factor

Y-Axis:		Height-wise scale factor

Z-Axis:		Depth-wise scale factor

Torus Rad 1:	Interior Radius of the torus (inactive for ellipsoids)

EXAMPLE NETWORK:
	
   SUPER ELLIPSOIDS
	  |
    RENDER MANAGER


SEE ALSO: PLATO (AVS User Module Library)

BUGS:
	The surface normals are currently screwed up on the seams.