org.j3d.aviatrix3d.rendering
Interface ShapeRenderable

All Superinterfaces:

java.lang.Comparable, Renderable

All Known Implementing Classes:

Box, Cone, Cylinder, Pixmap, Shape3D, Sphere, Spring, Torus

public interface ShapeRenderable
extends Renderable

Renderable object that applies geometry that appears on screen.

State Management

Geometry can be either visible or invisible. Invisible may arrive from a number of different reasons, such as:

• No geometry to render
• Completely transparent due to colour settings
• Required resources not provided (eg missing texture)
• Some form of user-visible control

This state may change on any frame. During rendering this state is queried and any geometry not indicating it is visible will be discarded.

Version:

$Revision: 2.3 $

Author:

Justin Couch

Method Summary

AppearanceRenderable	getAppearanceRenderable() Fetch the renderable that represents the visual appearance modifiers of this shape.
void	getCenter(float[] center) Get the centre of the shape object.
GeometryRenderable	getGeometryRenderable() Fetch the renderable that represents the geometry of this shape.
boolean	is2D() Check to see whether this shape is something that represents 2D or 3D geometry.
boolean	isVisible() State check to see whether the shape in it's current setup is visible.

Methods inherited from interface org.j3d.aviatrix3d.rendering.Renderable

equals

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

isVisible

boolean isVisible()

State check to see whether the shape in it's current setup is visible. Various reasons for this are stated in the class docs.

Returns:

true if the shape has something to render

is2D

boolean is2D()

Check to see whether this shape is something that represents 2D or 3D geometry. Pure 2D geometry is not effected by any EffectRenderable, while 3D is. Note that this can be changed depending on the type of geometry itself. A Shape3D node with an IndexedLineArray that only has 2D coordinates is as much a 2D geometry as a raster object.

Returns:

True if this is 2D geometry, false if this is 3D

getCenter

void getCenter(float[] center)

Get the centre of the shape object. Used for transparency depth sorting based on the center of the bounds of the object.

Parameters:

center - The object to copy the center coordinates in to

getGeometryRenderable

GeometryRenderable getGeometryRenderable()

Fetch the renderable that represents the geometry of this shape.

Returns:

The current geometry renderable or null if none

getAppearanceRenderable

AppearanceRenderable getAppearanceRenderable()

Fetch the renderable that represents the visual appearance modifiers of this shape.

Returns:

The current appearance renderable or null if none