javax.microedition.m3d
Class IndexBuffer

java.lang.Object
  |
  +--javax.microedition.m3d.Object3D
        |
        +--javax.microedition.m3d.IndexBuffer

Direct Known Subclasses:

TriangleStripArray

public abstract class IndexBuffer

extends Object3D

IndexBuffer defines how to connect vertices in a VertexBuffer to form 3D surface primitives, such as triangles. The actual type of the primitives is defined in derived classes; IndexBuffer itself is an abstract base class with no functionality. Currently, the only type of primitive that is supported is the triangle strip; see TriangleStripArray. Other types of primitives may be added in future revisions of this API, including triangle lists, triangle fans, line strips, and quad strips.

The combination of a VertexBuffer, IndexBuffer, and Appearance defines a submesh. Submesh is the smallest renderable entity. A Mesh node consists of one or more submeshes, such that all submeshes share the same set of vertex data.

Deferred exceptions

The indices in an IndexBuffer are only validated when rendering or picking. An exception is thrown by the render methods in Graphics3D, and the pick methods in Group and Camera, if any of the indices are greater than or equal to the number of vertices in the associated VertexBuffer. The indices cannot be validated earlier, because they are allowed to be invalid at all other times except when they are used by the implementation, that is, when rendering or picking.

See Also:

Binary format

Field Summary

Fields inherited from class javax.microedition.m3d.Object3D

userObject

Methods inherited from class javax.microedition.m3d.Object3D

addAnimationTrack, animate, clone, find, getAnimationTrack, getAnimationTrackCount, getReferences, getUserID, removeAnimationTrack, setUserID

Methods inherited from class java.lang.Object

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