com.threed.jpct
Class Primitives

java.lang.Object
  com.threed.jpct.Primitives

public class Primitives

extends java.lang.Object

Primitives offers some (lathe) primitives (basic 3D-objects). This class allows one to generate some objects for testing or other purposes quick and easy. No object editing or loading is needed. The number of faces the methods are asking for (or using the defaults) is not exactly the number of triangles the calculated object will have but rather the number of faces of the base object from which it has been constructed. But in lack of a better word, it's called "faces" here.
Except for the plane, objects created by this class don't have proper texture coordinates.
If you want proper texture coordinates for your primitives, have a look at the ExtendedPrimitives class in the util-package.

See Also:

ExtendedPrimitives

Method Summary

static Object3D	getBox(float scale, float scaleHeight) Returns a box (a 3-dimensional rectangle).
static Object3D	getCone(float scale) Returns a cone with 90 faces.
static Object3D	getCone(int faces, float scale) Returns a cone with the given number of faces.
static Object3D	getCone(int faces, float scale, float scaleHeight) Returns a cone with the given number of faces.
static Object3D	getCube(float scale) Returns a cube.
static Object3D	getCylinder(float scale) Returns a cylinder with 90 faces.
static Object3D	getCylinder(int faces, float scale) Returns a cylinder with the given number of faces.
static Object3D	getCylinder(int faces, float scale, float scaleHeight) Returns a cylinder with the given number of faces.
static Object3D	getDoubleCone(float scale) Returns a double cone with 90 faces.
static Object3D	getDoubleCone(int faces, float scale) Returns a double cone with the given number of faces.
static Object3D	getEllipsoid(float scale, float scaleHeight) Returns an ellipsoid with 20 faces.
static Object3D	getEllipsoid(int faces, float scale, float scaleHeight) Returns an ellipsoid with he given number of faces.
static Object3D	getPlane(int quads, float scale) Returns a plane consisting of (quads^2)*2 polygons each "scale" units in size.
static Object3D	getPyramide(float scale) Returns a pyramide
static Object3D	getPyramide(float scale, float scaleHeight) Returns a pyramide
static Object3D	getSphere(float scale) Returns a sphere with 20 faces.
static Object3D	getSphere(int faces, float scale) Returns a sphere with the given number of faces.

Methods inherited from class java.lang.Object

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

Method Detail

getPlane

public static Object3D getPlane(int quads,
                                float scale)

Returns a plane consisting of (quads^2)*2 polygons each "scale" units in size. The plane lies within the X-Y-plane and has a depth of 0;

Parameters:

quads - the number of quads the plane has in x as well as in y direction

scale - the size of each quad

Returns:

a plane

getCone

public static Object3D getCone(float scale)

Returns a cone with 90 faces.

Parameters:

scale - the scaling of the cone

Returns:

a cone

getCone

public static Object3D getCone(int faces,
                               float scale)

Returns a cone with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the cone

Returns:

a cone

getCone

public static Object3D getCone(int faces,
                               float scale,
                               float scaleHeight)

Returns a cone with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the cone

scaleHeight - the height relative to the width

Returns:

a cone

getCylinder

public static Object3D getCylinder(float scale)

Returns a cylinder with 90 faces.

Parameters:

scale - the scaling of the cylinder

Returns:

a cylinder

getCylinder

public static Object3D getCylinder(int faces,
                                   float scale)

Returns a cylinder with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the cylinder

Returns:

a cylinder

getCylinder

public static Object3D getCylinder(int faces,
                                   float scale,
                                   float scaleHeight)

Returns a cylinder with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the cylinder

scaleHeight - the height relative to the width

Returns:

a cylinder

getPyramide

public static Object3D getPyramide(float scale)

Returns a pyramide

Parameters:

scale - the scaling of the pyramide

Returns:

a pyramide

getPyramide

public static Object3D getPyramide(float scale,
                                   float scaleHeight)

Returns a pyramide

Parameters:

scale - the scaling of the pyramide

scaleHeight - the height relative to the width

Returns:

a pyramide

getDoubleCone

public static Object3D getDoubleCone(float scale)

Returns a double cone with 90 faces.

Parameters:

scale - the scaling of the double cone

Returns:

a double cone

getDoubleCone

public static Object3D getDoubleCone(int faces,
                                     float scale)

Returns a double cone with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the double cone

Returns:

a double cone

getCube

public static Object3D getCube(float scale)

Returns a cube. Please note that this cube isn't axis aligned, it's rotated 45 degrees around y.

Parameters:

scale - the scaling of the cube

Returns:

a cube

getBox

public static Object3D getBox(float scale,
                              float scaleHeight)

Returns a box (a 3-dimensional rectangle). Please note that this box isn't axis aligned, it's rotated 45 degrees around y.

Parameters:

scale - the scaling of the box

scaleHeight - the height relative to the width (i.e. a scaleHeight-value of 1 will return a cube).

Returns:

a box

getSphere

public static Object3D getSphere(float scale)

Returns a sphere with 20 faces.

Parameters:

scale - the scaling of the sphere

Returns:

a sphere

getSphere

public static Object3D getSphere(int faces,
                                 float scale)

Returns a sphere with the given number of faces.

Parameters:

faces - the number of faces

scale - the scaling of the sphere

Returns:

a sphere

getEllipsoid

public static Object3D getEllipsoid(float scale,
                                    float scaleHeight)

Returns an ellipsoid with 20 faces.

Parameters:

scale - the scaling in x-direction

scaleHeight - the scaling of the height relative to the width (1 creates a sphere)

Returns:

an ellipsoid

getEllipsoid

public static Object3D getEllipsoid(int faces,
                                    float scale,
                                    float scaleHeight)

Returns an ellipsoid with he given number of faces.

Parameters:

faces - the number of faces

scale - the scaling in x-direction

scaleHeight - the scaling of the height relative to the width (1 creates a sphere)

Returns:

an ellipsoid