graphicslib3D.shape

Class Torus

java.lang.Object

graphicslib3D.Shape3D

graphicslib3D.shape.Torus

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class Torus
extends Shape3D

This class defines a torus constructed by first defining a ring made up of vertices in the XY plane and then sweeping copies of the ring about the Y axis. Each vertex has geometric coordinates (X,Y,Z) plus texture coordinates and Normal, Tangent, and Binormal vectors assigned to it. Coordinate values within a specified value TOLERANCE (currently 0.00001) are forced to exactly 0.0. Note that texture coordinates are assigned from 0.0 to 1.0 around the rings in both the S and T direction; this causes texture-mapped images to be stretched completely around the torus in both directions.

Author:

John Clevenger, modeled after a similar C++ class by Paul Baker (www.paulsprojects.net)., Scott Gordon, removed OpenGL-specific material, texture, and drawing features.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEFAULT_INNER_RADIUS The default inner radius; that is, the distance from the center of the torus to the middle of one of the outer rings.
static double	DEFAULT_OUTER_RADIUS The default outer radius; that is, one-half the ring diameter.
static int	DEFAULT_PRECISION The default Torus precision -- that is, the number of vertices around either circumference.
static double	TOLERANCE

Constructor Summary

Constructors

Constructor and Description
Torus() Constructs a Torus with default size and precision values.
Torus(float inner, float outer, int precision) Constructs a Torus with the specified inner and outer radii and the specified precision.

Method Summary

Modifier and Type	Method and Description
int[]	getIndices() Returns an array of indexes into the array returned by getVertices(); each three index values define the vertices of a single triangle of the Torus.
Vertex3D[]	getVertices() Returns an array of Vertex3Ds defining this Torus.

Methods inherited from class graphicslib3D.Shape3D

clone, getName, getRotation, getScale, getTransform, getTranslation, rotate, rotate, scale, setName, setRotation, setScale, setTranslation, translate

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_PRECISION

public static final int DEFAULT_PRECISION

The default Torus precision -- that is, the number of vertices around either circumference.

See Also:

Constant Field Values

DEFAULT_INNER_RADIUS

public static final double DEFAULT_INNER_RADIUS

The default inner radius; that is, the distance from the center of the torus to the middle of one of the outer rings.

See Also:

Constant Field Values

DEFAULT_OUTER_RADIUS

public static final double DEFAULT_OUTER_RADIUS

The default outer radius; that is, one-half the ring diameter.

See Also:

Constant Field Values

TOLERANCE

public static final double TOLERANCE

See Also:

Constant Field Values

Constructor Detail

Torus

public Torus()

Constructs a Torus with default size and precision values.

Torus

public Torus(float inner,
             float outer,
             int precision)

Constructs a Torus with the specified inner and outer radii and the specified precision.

Method Detail

getVertices

public Vertex3D[] getVertices()

Returns an array of Vertex3Ds defining this Torus. Note that the order of the vertices in the returned array is not necessarily meaningful; that is, adjacent vertices in the array are not necessarily related in the structure of the Torus object. To determine the relationships between vertices, call method getIndices(), which identifies sets of three vertices defining the triangles making up the Torus.

Returns:

an array of Vertex3Ds

getIndices

public int[] getIndices()

Returns an array of indexes into the array returned by getVertices(); each three index values define the vertices of a single triangle of the Torus.

Returns:

an array of triangle indices into the vertices array