| java.lang.Object
 javax.media.j3d.SceneGraphObject
javax.media.j3d.Node
javax.media.j3d.Group
com.sun.j3d.utils.geometry.Primitive
com.sun.j3d.utils.geometry.Sphere
| Sphere | | public class Sphere extends Primitive (Code) | | Sphere is a geometry primitive created with a given radius and resolution.
It is centered at the origin.
When a texture is applied to a Sphere, it is mapped CCW from the back
of the sphere.
By default all primitives with the same parameters share their
geometry (e.g., you can have 50 shperes in your scene, but the
geometry is stored only once). A change to one primitive will
effect all shared nodes. Another implication of this
implementation is that the capabilities of the geometry are shared,
and once one of the shared nodes is live, the capabilities cannot
be set. Use the GEOMETRY_NOT_SHARED flag if you do not wish to
share geometry among primitives with the same parameters.
|
| Constructor Summary | |
| public | Sphere(float radius)
Constructs a Sphere of a given radius. | | public | Sphere()
Constructs a default Sphere of radius of 1.0. | | public | Sphere(float radius, Appearance ap)
Constructs a Sphere of a given radius and appearance. | | public | Sphere(float radius, int primflags, Appearance ap)
Constructs a Sphere of a given radius and appearance with
additional parameters specified by the Primitive flags. | | public | Sphere(float radius, int primflags, int divisions)
Constructs a Sphere of a given radius and number of divisions
with additional parameters specified by the Primitive flags. | | public | Sphere(float radius, int primflags, int divisions, Appearance ap)
Constructs a customized Sphere of a given radius,
number of divisions, and appearance, with additional parameters
specified by the Primitive flags. |
| Method Summary | |
| void | buildQuadrant(GeomBuffer gbuf, double startDelta, double endDelta, int sign, int nstep, int n, boolean upperSphere)
| | public Node | cloneNode(boolean forceDuplicate)
Used to create a new instance of the node. | | public void | duplicateNode(Node originalNode, boolean forceDuplicate)
Copies all node information from originalNode into
the current node. | | public Appearance | getAppearance(int partId)
Gets the appearance of the specified part of the sphere.
Parameters:
partId - identifier for a given subpart of the sphere The appearance object associated with the partID. | | public int | getDivisions()
| | public float | getRadius()
| | public Shape3D | getShape(int partId)
Obtains Sphere's shape node that contains the geometry.
This allows users to modify the appearance or geometry.
Parameters:
partId - The part to return (must be BODY for Spheres) The Shape3D object associated with the partId. | | public Shape3D | getShape()
Obtains Sphere's shape node that contains the geometry. | | public void | setAppearance(Appearance ap)
Sets appearance of the Sphere. |
| BODY | | final public static int BODY(Code) | | Sphere shape identifier, used by getShape.
See Also: Sphere.getShape |
| MID_REZ_DIV | | final static int MID_REZ_DIV(Code) | | |
| Sphere | | public Sphere(float radius)(Code) | | Constructs a Sphere of a given radius. Normals are generated
by default, texture coordinates are not. The resolution defaults to
15 divisions along sphere's axes. Appearance defaults to white.
Parameters:
radius - Radius |
| Sphere | | public Sphere()(Code) | | Constructs a default Sphere of radius of 1.0. Normals are generated
by default, texture coordinates are not.
Resolution defaults to 15 divisions. Appearance defaults to white.
|
| Sphere | | public Sphere(float radius, Appearance ap)(Code) | | Constructs a Sphere of a given radius and appearance.
Normals are generated by default, texture coordinates are not.
Parameters:
radius - Radius
Parameters:
ap - Appearance |
| Sphere | | public Sphere(float radius, int primflags, Appearance ap)(Code) | | Constructs a Sphere of a given radius and appearance with
additional parameters specified by the Primitive flags.
Parameters:
radius - Radius
Parameters:
primflags -
Parameters:
ap - appearance |
| Sphere | | public Sphere(float radius, int primflags, int divisions)(Code) | | Constructs a Sphere of a given radius and number of divisions
with additional parameters specified by the Primitive flags.
Appearance defaults to white.
Parameters:
radius - Radius
Parameters:
divisions - Divisions
Parameters:
primflags - Primflags |
| Sphere | | public Sphere(float radius, int primflags, int divisions, Appearance ap)(Code) | | Constructs a customized Sphere of a given radius,
number of divisions, and appearance, with additional parameters
specified by the Primitive flags. The resolution is defined in
terms of number of subdivisions along the sphere's axes. More
divisions lead to more finely tesselated objects.
If the appearance is null, the sphere defaults to a white appearance.
|
| buildQuadrant | | void buildQuadrant(GeomBuffer gbuf, double startDelta, double endDelta, int sign, int nstep, int n, boolean upperSphere)(Code) | | |
| cloneNode | | public Node cloneNode(boolean forceDuplicate)(Code) | | Used to create a new instance of the node. This routine is called
by cloneTree to duplicate the current node.
cloneNode should be overridden by any user subclassed
objects. All subclasses must have their cloneNode
method consist of the following lines:
public Node cloneNode(boolean forceDuplicate) {
UserSubClass usc = new UserSubClass();
usc.duplicateNode(this, forceDuplicate);
return usc;
}
Parameters:
forceDuplicate - when set to true, causes theduplicateOnCloneTree flag to be ignored. Whenfalse, the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied.
See Also: Node.cloneTree
See Also: Node.duplicateNode
See Also: NodeComponent.setDuplicateOnCloneTree |
| duplicateNode | | public void duplicateNode(Node originalNode, boolean forceDuplicate)(Code) | | Copies all node information from originalNode into
the current node. This method is called from the
cloneNode method which is, in turn, called by the
cloneTree method.
For any NodeComponent objects
contained by the object being duplicated, each NodeComponent
object's duplicateOnCloneTree value is used to determine
whether the NodeComponent should be duplicated in the new node
or if just a reference to the current node should be placed in the
new node. This flag can be overridden by setting the
forceDuplicate parameter in the cloneTree
method to true.
Parameters:
originalNode - the original node to duplicate.
Parameters:
forceDuplicate - when set to true, causes theduplicateOnCloneTree flag to be ignored. Whenfalse, the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied.
See Also: Node.cloneTree
See Also: Node.cloneNode
See Also: NodeComponent.setDuplicateOnCloneTree |
| getAppearance | | public Appearance getAppearance(int partId)(Code) | | Gets the appearance of the specified part of the sphere.
Parameters:
partId - identifier for a given subpart of the sphere The appearance object associated with the partID. If aninvalid partId is passed in, null is returned.
since:
Java 3D 1.2.1 |
| getDivisions | | public int getDivisions()(Code) | | Returns the number of divisions
since:
Java 3D 1.2.1 |
| getRadius | | public float getRadius()(Code) | | Returns the radius of the sphere
since:
Java 3D 1.2.1 |
| getShape | | public Shape3D getShape(int partId)(Code) | | Obtains Sphere's shape node that contains the geometry.
This allows users to modify the appearance or geometry.
Parameters:
partId - The part to return (must be BODY for Spheres) The Shape3D object associated with the partId. If aninvalid partId is passed in, null is returned. |
| getShape | | public Shape3D getShape()(Code) | | Obtains Sphere's shape node that contains the geometry.
|
| setAppearance | | public void setAppearance(Appearance ap)(Code) | | Sets appearance of the Sphere.
|
| Methods inherited from com.sun.j3d.utils.geometry.Primitive | protected void cacheGeometry(int kind, float a, float b, float c, int d, int e, int flags, GeomBuffer geo)(Code)(Java Doc)
public static void clearGeometryCache()(Code)(Java Doc)
public Appearance getAppearance()(Code)(Java Doc)
abstract public Appearance getAppearance(int partId)(Code)(Java Doc)
protected GeomBuffer getCachedGeometry(int kind, float a, float b, float c, int d, int e, int flags)(Code)(Java Doc)
public int getNumTriangles()(Code)(Java Doc)
public int getNumVertices()(Code)(Java Doc)
public int getPrimitiveFlags()(Code)(Java Doc)
abstract public Shape3D getShape(int partid)(Code)(Java Doc)
public void setAppearance(int partid, Appearance ap)(Code)(Java Doc)
abstract public void setAppearance(Appearance ap)(Code)(Java Doc)
public void setAppearance()(Code)(Java Doc)
public void setNumTriangles(int num)(Code)(Java Doc)
public void setNumVertices(int num)(Code)(Java Doc)
public void setPrimitiveFlags(int fl)(Code)(Java Doc)
String strfloat(float x)(Code)(Java Doc)
|
|
|