RenderObjectInterface (Artisynth API documentation)

```
public interface RenderObjectInterface
```

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`RenderObjectInterface.RenderObjectIdentifier` Used for uniquely identifying a RenderObject, and checking validity (can be safely shared)
`static interface`	`RenderObjectInterface.RenderObjectState` Stores exposable state of the object, tracking the current attribute set indices and primitive group indices.
`static interface`	`RenderObjectInterface.RenderObjectVersion` Keeps track of versions for detecting changes.
`static interface`	`RenderObjectInterface.VertexIndexSet` Class for storing position/normal/color/texture indices for a vertex

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`int`	`addColor(byte[] rgba)` Adds an indexable color
`int`	`addColor(byte r, byte g, byte b, byte a)` Adds an indexable color
`int`	`addColor(float r, float g, float b, float a)` Adds an indexable color
`int`	`addColor(int r, int g, int b, int a)` Adds an indexable color
`void`	`addLine(float[] v0, float[] v1)` Creates a line primitive between two new vertices defined at the supplied locations.
`void`	`addLine(int v0idx, int v1idx)` Creates a line primitive between the supplied vertices.
`void`	`addLineLoop(int... vidxs)` Creates a set of connected line segments between neighboring vertices in the supplied list of vertex indices.
`void`	`addLineLoop(int vStart, int vEnd)` Creates a set of line primitives between neighboring vertices as specified by the supplied vertex range.
`void`	`addLines(int... vidxs)` Creates a set of line primitives between pairs of vertices as specified by the supplied set of vertex indices.
`void`	`addLines(int vStart, int vEnd)` Creates a set of line primitives between pairs of vertices as specified by the supplied vertex range.
`void`	`addLines(java.lang.Iterable<int[]> lines)` Creates a set of line primitives between the supplied pairs of vertices.
`void`	`addLineStrip(int... vidxs)` Creates a set of connected line segments between neighboring vertices in the supplied list of vertex indices.
`void`	`addLineStrip(int vStart, int vEnd)` Creates a set of connected line primitives between neighboring vertices as specified by the supplied vertex range.
`int`	`addNormal(float nx, float ny, float nz)` Adds an indexable 3D normal.
`void`	`addPoint(float[] v)` Creates a point primitive at the supplied position.
`void`	`addPoint(int vidx)` Creates a point primitive at the supplied vertex.
`void`	`addPoints(int... vidxs)` Creates point primitives at the supplied vertex locations.
`void`	`addPoints(java.lang.Iterable<float[]> pnts)` Creates a set of vertices and point primitives at the supplied positions.
`int`	`addPosition(float px, float py, float pz)` Adds an indexable 3D position
`int`	`addTextureCoord(float x, float y)` Adds an indexable 2D texture coordinate
`void`	`addTriangle(float[] v0, float[] v1, float[] v2)` Creates a triangle primitive between three new vertices defined at the supplied locations.
`void`	`addTriangle(int v0idx, int v1idx, int v2idx)` Creates a triangle primitive between supplied vertices (CCW order).
`void`	`addTriangleFan(int... vidxs)` Creates a set of triangle primitives forming a fan using the supplied by vertex indices.
`void`	`addTriangleFan(int vStart, int vEnd)` Creates a set of triangle primitives forming a fan using the supplied vertex range.
`void`	`addTriangles(int... vidxs)` Creates a set of triangle primitives between triples of vertices as supplied by vertex indices.
`void`	`addTriangles(int vStart, int vEnd)` Creates a set of triangle primitives between triples of vertices as supplied by the given vertex range.
`void`	`addTriangles(java.lang.Iterable<int[]> tris)` Creates a set of triangle primitives between supplied triples of vertices.
`void`	`addTriangleStrip(int... vidxs)` Creates a set of triangle primitives forming a strip using the supplied by vertex indices.
`void`	`addTriangleStrip(int vStart, int vEnd)` Creates a set of triangle primitives forming a strip using the supplied by vertex range.
`int`	`addVertex()` Adds a vertex using the currently active position, normal, color, and texture coordinate (if available).
`int`	`addVertex(int pidx)` Adds a vertex using the supplied position index.
`int`	`addVertex(int pidx, int nidx)` Adds a vertex using the supplied position and normal indices.
`int`	`addVertex(int pidx, int nidx, int cidx, int tidx)` Adds a vertex using the position, normal, color and texture coordinates identified by index number.
`void`	`beginBuild(Renderer.DrawMode mode)` Start automatically building primitives for every added vertex, using a specified mode.
`void`	`clearPrimitives()` Clears all primitive groups, allowing them to be recreated.
`int`	`color(byte[] rgba)` Sets the current color to be used in following vertices.
`int`	`color(byte r, byte g, byte b, byte a)` Sets the current color to be used in following vertices.
`int`	`color(float r, float g, float b, float a)` Sets the current color to be used in following vertices.
`void`	`color(int cidx)` Sets the current color to be used in following vertices based on color index.
`int`	`color(int r, int g, int b, int a)` Sets the current color to be used in following vertices.
`void`	`colorSet(int setIdx)` Sets the current active color set to be used/modified.
`void`	`commit()` Signal that the object is complete and ready for rendering.
`int`	`createColorSet()` Creates a new, alternative set of colors that can be used by vertices.
`int`	`createColorSetFrom(int copyIdx)` Creates a new, alternative set of colors that can be used by vertices.
`int`	`createLineGroup()` Creates a new group of lines that can be rendered.
`int`	`createNormalSet()` Creates a new, alternative set of normals that can be used by vertices.
`int`	`createNormalSetFrom(int copyIdx)` Creates a new, alternative set of normals that can be used by vertices.
`int`	`createPointGroup()` Creates a new group of points that can be rendered.
`int`	`createPositionSet()` Creates a new, alternative set of positions that can be used by vertices.
`int`	`createPositionSetFrom(int copyIdx)` Creates a new, alternative set of positions that can be used by vertices.
`int`	`createTextureCoordSet()` Creates a new, alternative set of texture coordinates that can be used by vertices.
`int`	`createTextureCoordSetFrom(int copyIdx)` Creates a new, alternative set of texture coordinates that can be used by vertices.
`int`	`createTriangleGroup()` Creates a new group of triangles that can be rendered.
`void`	`dispose()` Signal a destruction of the object.
`void`	`endBuild()` End automatically building primitives.
`void`	`ensureColorCapacity(int cap)` Hint for ensuring sufficient storage for colors
`void`	`ensureLineCapacity(int cap)` Hint for ensuring sufficient storage for lines
`void`	`ensureNormalCapacity(int cap)` Hint for ensuring sufficient storage for normals
`void`	`ensurePointCapacity(int cap)` Hint for ensuring sufficient storage for points
`void`	`ensurePositionCapacity(int cap)` Hint for ensuring sufficient storage for positions
`void`	`ensureTextureCoordCapacity(int cap)` Hint for ensuring sufficient storage for texture coordinates
`void`	`ensureTriangleCapacity(int cap)` Hint for ensuring sufficient storage for triangles
`void`	`ensureVertexCapacity(int cap)` Hint for ensuring sufficient storage for vertices
`Renderer.DrawMode`	`getBuildMode()`
`byte[]`	`getColor(int cidx)` Retrieves the color at the supplied index.
`byte[]`	`getColor(int cset, int cidx)` Retrieves the color at the supplied index in a given set.
`java.util.List<byte[]>`	`getColors()` Retrieves the full list of Colors.
`java.util.List<byte[]>`	`getColors(int cset)` Retrieves the full list of colors in a given set.
`int`	`getColorSetIdx()` Returns the index of the currently active color set.
`int`	`getColorsVersion()` Returns the latest committed colors version number, for use in detecting if changes are present.
`RenderObjectInterface.RenderObjectIdentifier`	`getIdentifier()` Returns a special object to be used as a unique identifier for this RenderObject.
`int[]`	`getLine(int lgroup, int lidx)` Retrieves the line at the supplied index in a given group.
`int`	`getLineGroupIdx()` Returns the index of the currently active line group.
`java.util.List<int[]>`	`getLines()` Returns a list of line primitives, identified by vertex index pairs.
`java.util.List<int[]>`	`getLines(int lgroup)` Returns the list of lines (vertex indices) for a given group
`int`	`getLinesVersion()` Returns the latest committed lines version number, for use in detecting if changes are present.
`float[]`	`getNormal(int nidx)` Retrieves the normal at the supplied index.
`float[]`	`getNormal(int nset, int nidx)` Retrieves the normal at the supplied index in a given set.
`java.util.List<float[]>`	`getNormals()` Retrieves the full list of normals.
`java.util.List<float[]>`	`getNormals(int nset)` Retrieves the full list of normals in a given set.
`int`	`getNormalSetIdx()` Returns the index of the currently active normal set.
`int`	`getNormalsVersion()` Returns the latest committed triangles version number, for use in detecting if changes are present.
`int[]`	`getPoint(int pgroup, int pidx)` Retrieves the point at the supplied index in a given group.
`int`	`getPointGroupIdx()` Returns the index of the currently active point group.
`java.util.List<int[]>`	`getPoints()` Returns a list of vertex indices of all point primitives defined.
`java.util.List<int[]>`	`getPoints(int pgroup)` Returns the list of points (vertex indices) for a given group
`int`	`getPointsVersion()` Returns the latest committed points version number, for use in detecting if changes are present.
`float[]`	`getPosition(int pidx)` Retrieves the position at the supplied index.
`float[]`	`getPosition(int pset, int pidx)` Retrieves the position at the supplied index in a given set.
`java.util.List<float[]>`	`getPositions()` Retrieves the full list of positions.
`java.util.List<float[]>`	`getPositions(int pset)` Retrieves the full list of positions in a given set.
`int`	`getPositionSetIdx()` Returns the index of the currently active position set.
`int`	`getPositionsVersion()` Returns the latest committed positions version number, for use in detecting if changes are present.
`RenderObjectInterface.RenderObjectState`	`getStateInfo()`
`float[]`	`getTextureCoord(int tidx)` Retrieves the texture coordinate at the supplied index.
`float[]`	`getTextureCoord(int tset, int tidx)` Retrieves the texture coordinate at the supplied index in a given set.
`java.util.List<float[]>`	`getTextureCoords()` Retrieves the full list of texture coordinates.
`java.util.List<float[]>`	`getTextureCoords(int tset)` Retrieves the full list of texture coordinates in a given set.
`int`	`getTextureCoordSetIdx()` Returns the index of the currently active texture coordinate set.
`int`	`getTextureCoordsVersion()` Returns the latest committed texture coordinates version number, for use in detecting if changes are present.
`int[]`	`getTriangle(int tgroup, int tidx)` Retrieves the triangle at the supplied index in a given group.
`int`	`getTriangleGroupIdx()` Returns the index of the currently active triangle group.
`java.util.List<int[]>`	`getTriangles()` Returns a list of triangle primitives, identified by vertex index triples.
`java.util.List<int[]>`	`getTriangles(int tgroup)` Returns the list of triangles (vertex indices) for a given group
`int`	`getTrianglesVersion()` Returns the latest committed triangles version number, for use in detecting if changes are present.
`int`	`getVersion()` Retrieves the version of the object, for use in detecting whether any information has changed since last use.
`RenderObjectInterface.RenderObjectVersion`	`getVersionInfo()` Returns an immutable copy of all version information in this RenderObject, safe for sharing between threads.
`RenderObjectInterface.VertexIndexSet`	`getVertex(int vidx)` Retrieves the index set that identifies a vertex
`byte[]`	`getVertexColor(int vidx)` Returns the color of the supplied vertex
`float[]`	`getVertexNormal(int vidx)` Returns the normal of the supplied vertex
`float[]`	`getVertexPosition(int vidx)` Returns the position of the supplied vertex
`float[]`	`getVertexTextureCoord(int vidx)` Returns the texture coordinate of the supplied vertex
`java.util.List<RenderObjectInterface.VertexIndexSet>`	`getVertices()` Returns the full set of vertex identifiers
`int`	`getVerticesVersion()` Returns the latest committed vertices version number, for use in detecting if changes are present.
`boolean`	`hasColors()` Whether or not any colors have been defined.
`boolean`	`hasLines()` Indicates whether any line primitives have been defined
`boolean`	`hasNormals()` Whether or not any normals have been defined.
`boolean`	`hasPoints()` Indicates whether any point primitives have been defined.
`boolean`	`hasPositions()` Whether or not any positions have been defined.
`boolean`	`hasTextureCoords()` Whether or not any texture coordinates have been defined.
`boolean`	`hasTriangles()` Indicates whether any triangle primitives have been defined.
`void`	`invalidate()` Invalidates the object.
`boolean`	`isColorsDynamic()` Returns whether or not colors are considered dynamic.
`boolean`	`isCommitted()` Indicates whether or not the object is complete and ready for rendering.
`boolean`	`isDynamic()` Checks whether this render object has any dynamic components.
`boolean`	`isNormalsDynamic()` Returns whether or not normals are considered dynamic.
`boolean`	`isPositionsDynamic()` Returns whether or not positions are considered dynamic.
`boolean`	`isStreaming()` A streaming object has a short life-span, and cannot be modified once committed.
`boolean`	`isTextureCoordsDynamic()` Returns whether or not texture coordinates are considered dynamic.
`boolean`	`isValid()` Returns whether or not this RenderObject is valid.
`boolean`	`isVerticesCommitted()` Checks whether vertex information has been committed
`void`	`lineGroup(int setIdx)` Sets the current active line group for rendering.
`int`	`normal(float nx, float ny, float nz)` Sets the current 3D normal to be used in following vertices.
`void`	`normal(int nidx)` Sets the current normal to be used in following vertices, based on normal index.
`void`	`normalSet(int setIdx)` Sets the current active normal set to be used/modified.
`int`	`numColors()` Number of positions defined
`int`	`numColorSets()` The number of color sets available.
`int`	`numLineGroups()` The number of line groups available.
`int`	`numLines()` Number of line primitives defined
`int`	`numLines(int lgroup)` Number of line primitives defined in a group.
`int`	`numNormals()` Number of normals defined.
`int`	`numNormalSets()` The number of normal sets available.
`int`	`numPointGroups()` The number of point groups available.
`int`	`numPoints()` Number of point primitives defined.
`int`	`numPoints(int pgroup)` Number of point primitives defined in a point group.
`int`	`numPositions()` Number of positions defined.
`int`	`numPositionSets()` The number of position sets available.
`int`	`numTextureCoords()` Number of texture coordinates defined.
`int`	`numTextureCoordSets()` The number of texture coordinate sets available.
`int`	`numTriangleGroups()` The number of triangle groups available.
`int`	`numTriangles()` Number of triangle primitives defined.
`int`	`numTriangles(int tgroup)` Number of triangle primitives defined in a group.
`int`	`numVertices()` Returns the number of vertices, as defined by unique sets of position, normal, color, and texture indices.
`void`	`pointGroup(int setIdx)` Sets the current active point group for rendering.
`int`	`position(float px, float py, float pz)` Sets the current 3D position to be used in following vertices.
`void`	`position(int pidx)` Sets the current position to be used in following vertices, based on position index.
`void`	`positionSet(int setIdx)` Sets the current active position set to be used/modified.
`void`	`reinitialize()` Clears everything in the RenderObject, allowing it to be recreated.
`void`	`setColor(int cidx, byte[] rgba)` Updates the values of the color with index cidx.
`void`	`setColor(int cidx, byte r, byte g, byte b, byte a)` Updates the values of the color with index cidx.
`void`	`setColor(int cidx, float r, float g, float b, float a)` Updates the values of the color with index cidx.
`void`	`setColor(int cidx, int r, int g, int b, int a)` Updates the values of the color with index cidx.
`void`	`setColorsDynamic(boolean set)` Sets whether or not colors should be considered dynamic.
`void`	`setNormal(int nidx, float nx, float ny, float nz)` Updates the values of the normal with index nidx.
`void`	`setNormalsDynamic(boolean set)` Sets whether or not normals should be considered dynamic.
`void`	`setPosition(int pidx, float px, float py, float pz)` Updates the values of the position with index pidx.
`void`	`setPositionsDynamic(boolean set)` Sets whether or not positions should be considered dynamic.
`void`	`setStreaming(boolean set)` A streaming object has a short life-span, and cannot be modified once committed.
`void`	`setTextureCoord(int tidx, float x, float y)` Updates the values of the texture coordinate with index tidx.
`void`	`setTextureCoordsDynamic(boolean set)` Sets whether or not texture coordinates should be considered dynamic.
`void`	`setVertex(int vidx, int pidx, int nidx, int cidx, int tidx)` Modify the attribute indices of a particular vertex
`int`	`textureCoord(float x, float y)` Sets the current 2D texture coordinate to be used in following vertices.
`void`	`textureCoord(int tidx)` Sets the current texture coordinates to be used in following vertices, based on texture coordinate index.
`void`	`textureCoordSet(int setIdx)` Sets the current active texture coordinate set to be used/modified.
`void`	`triangleGroup(int setIdx)` Sets the current active triangle group for rendering.
`int`	`vertex(float x, float y, float z)` Add a vertex at the supplied position, using the currently active normal, color and texture coordinate (if available).

- Method Detail
  - getIdentifier
```
RenderObjectInterface.RenderObjectIdentifier getIdentifier()
```
    Returns a special object to be used as a unique identifier for this RenderObject. It contains a unique ID number, as well as a flag for determining whether the object still persists and is valid. This should be as the key in HashMaps etc... so that the original RenderObject can be cleared and garbage-collected when it runs out of scope.
  - getVersionInfo
```
RenderObjectInterface.RenderObjectVersion getVersionInfo()
```
    Returns an immutable copy of all version information in this RenderObject, safe for sharing between threads. This can be used to detect whether the RenderObject has been modified since last observed.
  - getStateInfo
```
RenderObjectInterface.RenderObjectState getStateInfo()
```
  - ensurePositionCapacity
```
void ensurePositionCapacity(int cap)
```
    Hint for ensuring sufficient storage for positions
    
    Parameters:
    
    cap - capacity
  - addPosition
```
int addPosition(float px,
                float py,
                float pz)
```
    Adds an indexable 3D position
    
    Parameters:
    
    px - x coordinate
    
    py - y coordinate
    
    pz - z coordinate
    
    Returns:
    
    the index of the position added
  - position
```
int position(float px,
             float py,
             float pz)
```
    Sets the current 3D position to be used in following vertices.
    
    Parameters:
    
    px - x coordinate
    
    py - y coordinate
    
    pz - z coordinate
    
    Returns:
    
    The index of the new position (valid only if a vertex is added with the supplied position)
  - position
```
void position(int pidx)
```
    Sets the current position to be used in following vertices, based on position index.
    
    Parameters:
    
    pidx - index of a previously added position
  - setPosition
```
void setPosition(int pidx,
                 float px,
                 float py,
                 float pz)
```
    Updates the values of the position with index pidx.
    
    Parameters:
    
    pidx - position to modify
    
    px - x coordinate
    
    py - y coordinate
    
    pz - z coordinate
  - hasPositions
```
boolean hasPositions()
```
    Whether or not any positions have been defined.
  - numPositions
```
int numPositions()
```
    Number of positions defined.
  - getPosition
```
float[] getPosition(int pidx)
```
    Retrieves the position at the supplied index. The returned position should not be modified.
    
    Parameters:
    
    pidx - position index
    
    Returns:
    
    position {x,y,z}
  - getPositions
```
java.util.List<float[]> getPositions()
```
    Retrieves the full list of positions. This list should not be modified.
    
    Returns:
    
    list of positions.
  - setPositionsDynamic
```
void setPositionsDynamic(boolean set)
```
    Sets whether or not positions should be considered dynamic. If true, positions can be updated. Otherwise, positions are considered fixed for all time. The dynamic property can only be modified before vertices are Committed.
    
    See Also:
    
    commit()
  - isPositionsDynamic
```
boolean isPositionsDynamic()
```
    Returns whether or not positions are considered dynamic.
  - createPositionSet
```
int createPositionSet()
```
    Creates a new, alternative set of positions that can be used by vertices. This allows sharing of other resources, such as normals, colors and textures. The new set of positions immediately becomes active, and is initialized from the previously active position set.
    
    Returns:
    
    the index of the newly created position set
    
    See Also:
    
    positionSet(int)
  - createPositionSetFrom
```
int createPositionSetFrom(int copyIdx)
```
    Creates a new, alternative set of positions that can be used by vertices. This allows sharing of other resources, such as normals, colors and textures. The new set of positions immediately becomes active, and is initialized from the position set identified by the supplied index.
    
    Parameters:
    
    copyIdx - index of position set to duplicate
    
    Returns:
    
    the index of the newly created position set
    
    See Also:
    
    positionSet(int)
  - positionSet
```
void positionSet(int setIdx)
```
    Sets the current active position set to be used/modified. Vertices will use the current active set of positions when rendering.
    
    Parameters:
    
    setIdx - index of active position set
  - getPositionSetIdx
```
int getPositionSetIdx()
```
    Returns the index of the currently active position set.
  - numPositionSets
```
int numPositionSets()
```
    The number of position sets available.
  - getPosition
```
float[] getPosition(int pset,
                    int pidx)
```
    Retrieves the position at the supplied index in a given set. The returned position should not be modified.
    
    Parameters:
    
    pset - position set index
    
    pidx - position index
    
    Returns:
    
    position {x,y,z}
  - getPositions
```
java.util.List<float[]> getPositions(int pset)
```
    Retrieves the full list of positions in a given set. This list should not be modified.
    
    Parameters:
    
    pset - position set index
    
    Returns:
    
    list of positions.
  - getPositionsVersion
```
int getPositionsVersion()
```
    Returns the latest committed positions version number, for use in detecting if changes are present.
  - ensureNormalCapacity
```
void ensureNormalCapacity(int cap)
```
    Hint for ensuring sufficient storage for normals
    
    Parameters:
    
    cap - capacity
  - addNormal
```
int addNormal(float nx,
              float ny,
              float nz)
```
    Adds an indexable 3D normal.
    
    Parameters:
    
    nx - x component
    
    ny - y component
    
    nz - z component
    
    Returns:
    
    the index of the normal added
  - normal
```
int normal(float nx,
           float ny,
           float nz)
```
    Sets the current 3D normal to be used in following vertices.
    
    Parameters:
    
    nx - x component
    
    ny - y component
    
    nz - z component
    
    Returns:
    
    The index of the new normal (valid only if a vertex is added with the supplied normal)
  - normal
```
void normal(int nidx)
```
    Sets the current normal to be used in following vertices, based on normal index.
    
    Parameters:
    
    nidx - index of a previously added normal
  - setNormal
```
void setNormal(int nidx,
               float nx,
               float ny,
               float nz)
```
    Updates the values of the normal with index nidx.
    
    Parameters:
    
    nidx - normal to modify
    
    nx - x component
    
    ny - y component
    
    nz - z component
  - hasNormals
```
boolean hasNormals()
```
    Whether or not any normals have been defined.
  - numNormals
```
int numNormals()
```
    Number of normals defined.
  - getNormal
```
float[] getNormal(int nidx)
```
    Retrieves the normal at the supplied index. The returned normal should not be modified.
    
    Parameters:
    
    nidx - normal index
    
    Returns:
    
    normal {x,y,z}
  - getNormals
```
java.util.List<float[]> getNormals()
```
    Retrieves the full list of normals. This list should not be modified.
    
    Returns:
    
    list of normals.
  - setNormalsDynamic
```
void setNormalsDynamic(boolean set)
```
    Sets whether or not normals should be considered dynamic. If true, normals can be updated. Otherwise, normals are considered fixed for all time. The dynamic property can only be modified before vertices are Committed.
    
    See Also:
    
    commit()
  - isNormalsDynamic
```
boolean isNormalsDynamic()
```
    Returns whether or not normals are considered dynamic.
  - createNormalSet
```
int createNormalSet()
```
    Creates a new, alternative set of normals that can be used by vertices. This allows sharing of other resources, such as positions, colors and textures. The new set of normals immediately becomes active, and is initialized from the previously active normal set.
    
    Returns:
    
    the index of the newly created normal set
    
    See Also:
    
    normalSet(int)
  - createNormalSetFrom
```
int createNormalSetFrom(int copyIdx)
```
    Creates a new, alternative set of normals that can be used by vertices. This allows sharing of other resources, such as positions, colors and textures. The new set of normals will be initialized from the normal set identified by the supplied index.
    
    Parameters:
    
    copyIdx - index of normal set to duplicate
    
    Returns:
    
    the index of the newly created normal set
    
    See Also:
    
    normalSet(int)
  - normalSet
```
void normalSet(int setIdx)
```
    Sets the current active normal set to be used/modified. Vertices will use the current active set of normals when rendering.
    
    Parameters:
    
    setIdx - index of active normal set
  - getNormalSetIdx
```
int getNormalSetIdx()
```
    Returns the index of the currently active normal set.
  - numNormalSets
```
int numNormalSets()
```
    The number of normal sets available.
  - getNormal
```
float[] getNormal(int nset,
                  int nidx)
```
    Retrieves the normal at the supplied index in a given set. The returned normal should not be modified.
    
    Parameters:
    
    nset - normal set index
    
    nidx - normal index
    
    Returns:
    
    normal {x,y,z}
  - getNormals
```
java.util.List<float[]> getNormals(int nset)
```
    Retrieves the full list of normals in a given set. This list should not be modified.
    
    Parameters:
    
    nset - normal set index
    
    Returns:
    
    list of normals.
  - getNormalsVersion
```
int getNormalsVersion()
```
    Returns the latest committed triangles version number, for use in detecting if changes are present.
  - ensureColorCapacity
```
void ensureColorCapacity(int cap)
```
    Hint for ensuring sufficient storage for colors
    
    Parameters:
    
    cap - capacity
  - addColor
```
int addColor(byte r,
             byte g,
             byte b,
             byte a)
```
    Adds an indexable color
    
    Parameters:
    
    r - red
    
    g - green
    
    b - blue
    
    a - alpha
    
    Returns:
    
    the index of the color added
  - addColor
```
int addColor(int r,
             int g,
             int b,
             int a)
```
    Adds an indexable color
    
    Parameters:
    
    r - red [0-255]
    
    g - green [0-255]
    
    b - blue [0-255]
    
    a - alpha [0-255]
    
    Returns:
    
    the index of the color added
  - addColor
```
int addColor(float r,
             float g,
             float b,
             float a)
```
    Adds an indexable color
    
    Parameters:
    
    r - red [0-1]
    
    g - green [0-1]
    
    b - blue [0-1]
    
    a - alpha [0-1]
    
    Returns:
    
    the index of the color added
  - addColor
```
int addColor(byte[] rgba)
```
    Adds an indexable color
    
    Parameters:
    
    rgba - {red, green, blue, alpha}
    
    Returns:
    
    the index of the color added
  - color
```
int color(int r,
          int g,
          int b,
          int a)
```
    Sets the current color to be used in following vertices.
    
    Parameters:
    
    r - red [0-255]
    
    g - green [0-255]
    
    b - blue [0-255]
    
    a - alpha [0-255]
    
    Returns:
    
    The index of the new color (valid only if a vertex is added with the supplied color)
  - color
```
int color(float r,
          float g,
          float b,
          float a)
```
    Sets the current color to be used in following vertices.
    
    Parameters:
    
    r - red [0-1]
    
    g - green [0-1]
    
    b - blue [0-1]
    
    a - alpha [0-1]
    
    Returns:
    
    The index of the new color (valid only if a vertex is added with the supplied color)
  - color
```
int color(byte r,
          byte g,
          byte b,
          byte a)
```
    Sets the current color to be used in following vertices.
    
    Parameters:
    
    r - red
    
    g - green
    
    b - blue
    
    a - alpha
    
    Returns:
    
    The index of the new color (valid only if a vertex is added with the supplied color)
  - color
```
int color(byte[] rgba)
```
    Sets the current color to be used in following vertices.
    
    Parameters:
    
    rgba - {red, green, blue, alpha}
    
    Returns:
    
    The index of the new color (valid only if a vertex is added with the supplied color)
  - color
```
void color(int cidx)
```
    Sets the current color to be used in following vertices based on color index.
    
    Parameters:
    
    cidx - index of a previously added color
  - setColor
```
void setColor(int cidx,
              byte r,
              byte g,
              byte b,
              byte a)
```
    Updates the values of the color with index cidx.
    
    Parameters:
    
    cidx - color to modify
    
    r - red
    
    g - green
    
    b - blue
    
    a - alpha
  - setColor
```
void setColor(int cidx,
              int r,
              int g,
              int b,
              int a)
```
    Updates the values of the color with index cidx.
    
    Parameters:
    
    cidx - color to modify
    
    r - red
    
    g - green
    
    b - blue
    
    a - alpha
  - setColor
```
void setColor(int cidx,
              float r,
              float g,
              float b,
              float a)
```
    Updates the values of the color with index cidx.
    
    Parameters:
    
    cidx - color to modify
    
    r - red
    
    g - green
    
    b - blue
    
    a - alpha
  - setColor
```
void setColor(int cidx,
              byte[] rgba)
```
    Updates the values of the color with index cidx.
    
    Parameters:
    
    cidx - color to modify
    
    rgba - {red, green, blue, alpha}
  - hasColors
```
boolean hasColors()
```
    Whether or not any colors have been defined.
  - numColors
```
int numColors()
```
    Number of positions defined
  - getColor
```
byte[] getColor(int cidx)
```
    Retrieves the color at the supplied index. The returned color should not be modified.
    
    Parameters:
    
    cidx - color index
    
    Returns:
    
    color {red, green, blue, alpha}
  - getColors
```
java.util.List<byte[]> getColors()
```
    Retrieves the full list of Colors. This list should not be modified.
    
    Returns:
    
    list of colors.
  - setColorsDynamic
```
void setColorsDynamic(boolean set)
```
    Sets whether or not colors should be considered dynamic. If true, colors can be updated. Otherwise, colors are considered fixed for all time. The dynamic property can only be modified before vertices are Committed.
    
    See Also:
    
    commit()
  - isColorsDynamic
```
boolean isColorsDynamic()
```
    Returns whether or not colors are considered dynamic.
  - createColorSet
```
int createColorSet()
```
    Creates a new, alternative set of colors that can be used by vertices. This allows sharing of other resources, such as positions, normals, and textures. The new set of colors immediately becomes active, and is initialized from the previously active color set.
    
    Returns:
    
    the index of the newly created color set
    
    See Also:
    
    colorSet(int)
  - createColorSetFrom
```
int createColorSetFrom(int copyIdx)
```
    Creates a new, alternative set of colors that can be used by vertices. This allows sharing of other resources, such as positions, normals and textures. The new set of colors immediately becomes active, and is initialized from the color set identified by the supplied index.
    
    Parameters:
    
    copyIdx - index of color set to duplicate
    
    Returns:
    
    the index of the newly created color set
    
    See Also:
    
    colorSet(int)
  - colorSet
```
void colorSet(int setIdx)
```
    Sets the current active color set to be used/modified. Vertices will use the current active set of colors when rendering.
    
    Parameters:
    
    setIdx - index of active color set
  - getColorSetIdx
```
int getColorSetIdx()
```
    Returns the index of the currently active color set.
  - numColorSets
```
int numColorSets()
```
    The number of color sets available.
  - getColor
```
byte[] getColor(int cset,
                int cidx)
```
    Retrieves the color at the supplied index in a given set. The returned color should not be modified.
    
    Parameters:
    
    cset - color set index
    
    cidx - color index
    
    Returns:
    
    color {r,g,b,a}
  - getColors
```
java.util.List<byte[]> getColors(int cset)
```
    Retrieves the full list of colors in a given set. This list should not be modified.
    
    Parameters:
    
    cset - color set index
    
    Returns:
    
    list of colors.
  - getColorsVersion
```
int getColorsVersion()
```
    Returns the latest committed colors version number, for use in detecting if changes are present.
  - ensureTextureCoordCapacity
```
void ensureTextureCoordCapacity(int cap)
```
    Hint for ensuring sufficient storage for texture coordinates
    
    Parameters:
    
    cap - capacity
  - addTextureCoord
```
int addTextureCoord(float x,
                    float y)
```
    Adds an indexable 2D texture coordinate
    
    Parameters:
    
    x - x coordinate
    
    y - y coordinate
    
    Returns:
    
    the index of the texture coordinate added
  - textureCoord
```
int textureCoord(float x,
                 float y)
```
    Sets the current 2D texture coordinate to be used in following vertices.
    
    Parameters:
    
    x - x coordinate
    
    y - y coordinate
    
    Returns:
    
    The index of the new texture coordinate (valid only if a vertex is added with the supplied texture coordinate)
  - textureCoord
```
void textureCoord(int tidx)
```
    Sets the current texture coordinates to be used in following vertices, based on texture coordinate index.
    
    Parameters:
    
    tidx - index of a previously added texture coordinate
  - setTextureCoord
```
void setTextureCoord(int tidx,
                     float x,
                     float y)
```
    Updates the values of the texture coordinate with index tidx.
    
    Parameters:
    
    tidx - coordinate index
    
    x - x coordinate
    
    y - y coordinate
  - hasTextureCoords
```
boolean hasTextureCoords()
```
    Whether or not any texture coordinates have been defined.
  - numTextureCoords
```
int numTextureCoords()
```
    Number of texture coordinates defined.
  - getTextureCoord
```
float[] getTextureCoord(int tidx)
```
    Retrieves the texture coordinate at the supplied index. The returned coordinate should not be modified.
    
    Parameters:
    
    tidx - position index
    
    Returns:
    
    texture coordinate {x,y}
  - getTextureCoords
```
java.util.List<float[]> getTextureCoords()
```
    Retrieves the full list of texture coordinates. This list should not be modified.
    
    Returns:
    
    list of texture coordinates.
  - setTextureCoordsDynamic
```
void setTextureCoordsDynamic(boolean set)
```
    Sets whether or not texture coordinates should be considered dynamic. If true, texture coordinates can be updated. Otherwise, texture coordinates are considered fixed for all time. The dynamic property can only be modified before vertices are Committed.
    
    See Also:
    
    commit()
  - isTextureCoordsDynamic
```
boolean isTextureCoordsDynamic()
```
    Returns whether or not texture coordinates are considered dynamic.
  - createTextureCoordSet
```
int createTextureCoordSet()
```
    Creates a new, alternative set of texture coordinates that can be used by vertices. This allows sharing of other resources, such as positions, normals, and colors. The new set of texture coordinates immediately becomes active, and is initialized from the previously active texture coordinate set.
    
    Returns:
    
    the index of the newly create texture coordinate set
    
    See Also:
    
    textureCoordSet(int)
  - createTextureCoordSetFrom
```
int createTextureCoordSetFrom(int copyIdx)
```
    Creates a new, alternative set of texture coordinates that can be used by vertices. This allows sharing of other resources, such as positions, normals, and colors. The new set of texture coordinates immediately becomes active, and is initialized from the texture coordinate set identified by the supplied index.
    
    Parameters:
    
    copyIdx - index of texture coordinate set to duplicate
    
    Returns:
    
    the index of the newly created texture coordinate set
    
    See Also:
    
    textureCoordSet(int)
  - textureCoordSet
```
void textureCoordSet(int setIdx)
```
    Sets the current active texture coordinate set to be used/modified. Vertices will use the current active set of texture coordinates when rendering.
    
    Parameters:
    
    setIdx - index of active position set
  - getTextureCoordSetIdx
```
int getTextureCoordSetIdx()
```
    Returns the index of the currently active texture coordinate set.
  - numTextureCoordSets
```
int numTextureCoordSets()
```
    The number of texture coordinate sets available.
    
    Returns:
    
    number of available texture coordinate sets
  - getTextureCoord
```
float[] getTextureCoord(int tset,
                        int tidx)
```
    Retrieves the texture coordinate at the supplied index in a given set. The returned texture coordinate should not be modified.
    
    Parameters:
    
    tset - texture coordinate set index
    
    tidx - texture coordinate index
    
    Returns:
    
    texture coordinate {x,y}
  - getTextureCoords
```
java.util.List<float[]> getTextureCoords(int tset)
```
    Retrieves the full list of texture coordinates in a given set. This list should not be modified.
    
    Parameters:
    
    tset - texture coordinate set index
    
    Returns:
    
    list of texture coordinates.
  - getTextureCoordsVersion
```
int getTextureCoordsVersion()
```
    Returns the latest committed texture coordinates version number, for use in detecting if changes are present.
  - isDynamic
```
boolean isDynamic()
```
    Checks whether this render object has any dynamic components.
  - ensureVertexCapacity
```
void ensureVertexCapacity(int cap)
```
    Hint for ensuring sufficient storage for vertices
    
    Parameters:
    
    cap - capacity
  - addVertex
```
int addVertex()
```
    Adds a vertex using the currently active position, normal, color, and texture coordinate (if available).
    
    Returns:
    
    the index of the newly created vertex.
  - addVertex
```
int addVertex(int pidx)
```
    Adds a vertex using the supplied position index.
    
    Returns:
    
    the index of the newly created vertex.
  - addVertex
```
int addVertex(int pidx,
              int nidx)
```
    Adds a vertex using the supplied position and normal indices.
    
    Returns:
    
    the index of the newly created vertex.
  - addVertex
```
int addVertex(int pidx,
              int nidx,
              int cidx,
              int tidx)
```
    Adds a vertex using the position, normal, color and texture coordinates identified by index number. Negative index values are ignored.
    
    Parameters:
    
    pidx - position index
    
    nidx - normal index
    
    cidx - color index
    
    tidx - texture coordinate index
    
    Returns:
    
    the index of the newly created vertex.
  - vertex
```
int vertex(float x,
           float y,
           float z)
```
    Add a vertex at the supplied position, using the currently active normal, color and texture coordinate (if available). A new position is created to accommodate the vertex.
    
    Parameters:
    
    x - x coordinate
    
    y - y coordinate
    
    z - z coordinate
    
    Returns:
    
    vertex index
  - setVertex
```
void setVertex(int vidx,
               int pidx,
               int nidx,
               int cidx,
               int tidx)
```
    Modify the attribute indices of a particular vertex
    
    Parameters:
    
    vidx - index of vertex to modify
    
    pidx - new position index
    
    nidx - new normal index
    
    cidx - new color index
    
    tidx - new texture coordinate index
  - numVertices
```
int numVertices()
```
    Returns the number of vertices, as defined by unique sets of position, normal, color, and texture indices.
  - getVertexPosition
```
float[] getVertexPosition(int vidx)
```
    Returns the position of the supplied vertex
  - getVertexNormal
```
float[] getVertexNormal(int vidx)
```
    Returns the normal of the supplied vertex
  - getVertexColor
```
byte[] getVertexColor(int vidx)
```
    Returns the color of the supplied vertex
  - getVertexTextureCoord
```
float[] getVertexTextureCoord(int vidx)
```
    Returns the texture coordinate of the supplied vertex
  - getVertex
```
RenderObjectInterface.VertexIndexSet getVertex(int vidx)
```
    Retrieves the index set that identifies a vertex
    
    Parameters:
    
    vidx - vertex index
    
    Returns:
    
    the IndexSet which contains the position, normal, color and texture coordinate indices
  - getVertices
```
java.util.List<RenderObjectInterface.VertexIndexSet> getVertices()
```
    Returns the full set of vertex identifiers
  - isVerticesCommitted
```
boolean isVerticesCommitted()
```
    Checks whether vertex information has been committed
  - getVerticesVersion
```
int getVerticesVersion()
```
    Returns the latest committed vertices version number, for use in detecting if changes are present.
  - beginBuild
```
void beginBuild(Renderer.DrawMode mode)
```
    Start automatically building primitives for every added vertex, using a specified mode. Primitives are only gauranteed to be complete after a call to endBuild().
    
    Parameters:
    
    mode - mode for adding consecutive primitives
  - endBuild
```
void endBuild()
```
    End automatically building primitives.
  - getBuildMode
```
Renderer.DrawMode getBuildMode()
```
  - addPoint
```
void addPoint(int vidx)
```
    Creates a point primitive at the supplied vertex.
    
    Parameters:
    
    vidx - vertex index for point
  - addPoints
```
void addPoints(int... vidxs)
```
    Creates point primitives at the supplied vertex locations.
    
    Parameters:
    
    vidxs - array of vertex indices at which to create point primitives.
  - addPoint
```
void addPoint(float[] v)
```
    Creates a point primitive at the supplied position. A vertex is first created using the currently active normal, color and texture coordinate (if available).
    
    Parameters:
    
    v - array of length 3 (x,y,z)
  - addPoints
```
void addPoints(java.lang.Iterable<float[]> pnts)
```
    Creates a set of vertices and point primitives at the supplied positions.
    
    Parameters:
    
    pnts - positions for which points and vertices should be defined
    
    See Also:
    
    addPoint(float[])
  - hasPoints
```
boolean hasPoints()
```
    Indicates whether any point primitives have been defined.
  - numPoints
```
int numPoints()
```
    Number of point primitives defined.
  - getPoints
```
java.util.List<int[]> getPoints()
```
    Returns a list of vertex indices of all point primitives defined.
  - ensurePointCapacity
```
void ensurePointCapacity(int cap)
```
    Hint for ensuring sufficient storage for points
    
    Parameters:
    
    cap - capacity
  - createPointGroup
```
int createPointGroup()
```
    Creates a new group of points that can be rendered. By default, only one point group exists.
    
    Returns:
    
    the index of the new group of points
    
    See Also:
    
    pointGroup(int)
  - pointGroup
```
void pointGroup(int setIdx)
```
    Sets the current active point group for rendering.
    
    Parameters:
    
    setIdx - index of active point group.
  - getPointGroupIdx
```
int getPointGroupIdx()
```
    Returns the index of the currently active point group.
  - numPointGroups
```
int numPointGroups()
```
    The number of point groups available.
  - numPoints
```
int numPoints(int pgroup)
```
    Number of point primitives defined in a point group.
  - getPoint
```
int[] getPoint(int pgroup,
               int pidx)
```
    Retrieves the point at the supplied index in a given group. The returned point should not be modified.
    
    Parameters:
    
    pgroup - point group index
    
    pidx - point index
    
    Returns:
    
    vertex index of point
  - getPoints
```
java.util.List<int[]> getPoints(int pgroup)
```
    Returns the list of points (vertex indices) for a given group
    
    Parameters:
    
    pgroup - point group index
    
    Returns:
    
    vertex indices for point group
  - getPointsVersion
```
int getPointsVersion()
```
    Returns the latest committed points version number, for use in detecting if changes are present.
  - addLine
```
void addLine(int v0idx,
             int v1idx)
```
    Creates a line primitive between the supplied vertices.
    
    Parameters:
    
    v0idx - vertex index for start of line
    
    v1idx - vertex index for end of line
  - addLines
```
void addLines(int... vidxs)
```
    Creates a set of line primitives between pairs of vertices as specified by the supplied set of vertex indices. For example, supplying {1,2,3,4} will create two line segments: 1-2, 3-4.
    
    Parameters:
    
    vidxs - vertex indices, in pairs, defining line segments.
  - addLines
```
void addLines(int vStart,
              int vEnd)
```
    Creates a set of line primitives between pairs of vertices as specified by the supplied vertex range. For example, supplying {1,4} will create two line segments: 1-2, 3-4.
    
    Parameters:
    
    vStart - starting vertex
    
    vEnd - ending vertex
  - addLines
```
void addLines(java.lang.Iterable<int[]> lines)
```
    Creates a set of line primitives between the supplied pairs of vertices.
    
    Parameters:
    
    lines - int pairs of vertex indices defining line segments.
  - addLineStrip
```
void addLineStrip(int... vidxs)
```
    Creates a set of connected line segments between neighboring vertices in the supplied list of vertex indices. For example, supplying {1,2,3,4} will create three line segments: 1-2, 2-3, 3-4.
    
    Parameters:
    
    vidxs - vertex indices specifying connectivity
  - addLineStrip
```
void addLineStrip(int vStart,
                  int vEnd)
```
    Creates a set of connected line primitives between neighboring vertices as specified by the supplied vertex range. For example, supplying {1,4} will create three line segments: 1-2, 2-3, 3-4.
    
    Parameters:
    
    vStart - starting vertex
    
    vEnd - ending vertex
  - addLineLoop
```
void addLineLoop(int... vidxs)
```
    Creates a set of connected line segments between neighboring vertices in the supplied list of vertex indices. For example, supplying {1,2,3,4} will create four line segments: 1-2, 2-3, 3-4, 4-1.
    
    Parameters:
    
    vidxs - vertex indices specifying connectivity
  - addLineLoop
```
void addLineLoop(int vStart,
                 int vEnd)
```
    Creates a set of line primitives between neighboring vertices as specified by the supplied vertex range. For example, supplying {1,4} will create four line segments: 1-2, 2-3, 3-4, 4-1
    
    Parameters:
    
    vStart - starting vertex
    
    vEnd - ending vertex
  - addLine
```
void addLine(float[] v0,
             float[] v1)
```
    Creates a line primitive between two new vertices defined at the supplied locations. The currently active normal, color and texture coordinates will be used when creating the vertices.
    
    Parameters:
    
    v0 - length 3 array for position of starting vertex (x,y,z)
    
    v1 - length 3 array for position of ending vertex (x,y,z)
  - hasLines
```
boolean hasLines()
```
    Indicates whether any line primitives have been defined
  - numLines
```
int numLines()
```
    Number of line primitives defined
  - getLines
```
java.util.List<int[]> getLines()
```
    Returns a list of line primitives, identified by vertex index pairs.
  - ensureLineCapacity
```
void ensureLineCapacity(int cap)
```
    Hint for ensuring sufficient storage for lines
    
    Parameters:
    
    cap - capacity
  - createLineGroup
```
int createLineGroup()
```
    Creates a new group of lines that can be rendered. By default, only one line group exists.
    
    Returns:
    
    the index of the new group of lines
    
    See Also:
    
    lineGroup(int)
  - lineGroup
```
void lineGroup(int setIdx)
```
    Sets the current active line group for rendering.
    
    Parameters:
    
    setIdx - index of active line group.
  - getLineGroupIdx
```
int getLineGroupIdx()
```
    Returns the index of the currently active line group.
  - numLineGroups
```
int numLineGroups()
```
    The number of line groups available.
  - numLines
```
int numLines(int lgroup)
```
    Number of line primitives defined in a group.
  - getLine
```
int[] getLine(int lgroup,
              int lidx)
```
    Retrieves the line at the supplied index in a given group. The returned line should not be modified.
    
    Parameters:
    
    lgroup - line group index
    
    lidx - line index
    
    Returns:
    
    vertex indices making up line
  - getLines
```
java.util.List<int[]> getLines(int lgroup)
```
    Returns the list of lines (vertex indices) for a given group
    
    Parameters:
    
    lgroup - line group index
    
    Returns:
    
    vertex indices for line group
  - getLinesVersion
```
int getLinesVersion()
```
    Returns the latest committed lines version number, for use in detecting if changes are present.
  - addTriangle
```
void addTriangle(int v0idx,
                 int v1idx,
                 int v2idx)
```
    Creates a triangle primitive between supplied vertices (CCW order).
    
    Parameters:
    
    v0idx - first vertex
    
    v1idx - second vertex
    
    v2idx - third vertex
  - addTriangles
```
void addTriangles(int... vidxs)
```
    Creates a set of triangle primitives between triples of vertices as supplied by vertex indices. For example supplying {1,2,3,4,5,6} will create two triangles: 1-2-3, 4-5-6.
    
    Parameters:
    
    vidxs - vertex indices, in triples, defining triangles.
  - addTriangles
```
void addTriangles(int vStart,
                  int vEnd)
```
    Creates a set of triangle primitives between triples of vertices as supplied by the given vertex range. For example supplying {1, 6} will create two triangles: 1-2-3, 4-5-6.
    
    Parameters:
    
    vStart - starting vertex index
    
    vEnd - ending vertex index
  - addTriangleFan
```
void addTriangleFan(int... vidxs)
```
    Creates a set of triangle primitives forming a fan using the supplied by vertex indices. For example supplying {1,2,3,4,5,6} will create four triangles: 1-2-3, 1-3-4, 1-4-5, 1-5-6.
    
    Parameters:
    
    vidxs - vertex indices defining triangles.
  - addTriangleFan
```
void addTriangleFan(int vStart,
                    int vEnd)
```
    Creates a set of triangle primitives forming a fan using the supplied vertex range. For example supplying {1, 6} will create four triangles: 1-2-3, 1-3-4, 1-4-5, 1-5-6.
    
    Parameters:
    
    vStart - starting vertex index
    
    vEnd - ending vertex index
  - addTriangleStrip
```
void addTriangleStrip(int... vidxs)
```
    Creates a set of triangle primitives forming a strip using the supplied by vertex indices. For example supplying {1,2,3,4,5,6} will create four triangles: 1-2-3, 3-2-4, 3-4-5, 5-4-6
    
    Parameters:
    
    vidxs - vertex indices defining triangles.
  - addTriangleStrip
```
void addTriangleStrip(int vStart,
                      int vEnd)
```
    Creates a set of triangle primitives forming a strip using the supplied by vertex range. For example supplying {1,6} will create four triangles: 1-2-3, 3-2-4, 3-4-5, 5-4-6
    
    Parameters:
    
    vStart - starting vertex index
    
    vEnd - ending vertex index
  - addTriangles
```
void addTriangles(java.lang.Iterable<int[]> tris)
```
    Creates a set of triangle primitives between supplied triples of vertices.
    
    Parameters:
    
    tris - int triples of vertex indices defining triangles (CCW)
  - addTriangle
```
void addTriangle(float[] v0,
                 float[] v1,
                 float[] v2)
```
    Creates a triangle primitive between three new vertices defined at the supplied locations. The currently active normal, color, and texture coordinates will be used when creating the vertices.
    
    Parameters:
    
    v0 - {x,y,z} position of first vertex
    
    v1 - {x,y,z} position of second vertex
    
    v2 - {x,y,z} position of third vertex
  - hasTriangles
```
boolean hasTriangles()
```
    Indicates whether any triangle primitives have been defined.
  - numTriangles
```
int numTriangles()
```
    Number of triangle primitives defined.
  - getTriangles
```
java.util.List<int[]> getTriangles()
```
    Returns a list of triangle primitives, identified by vertex index triples.
  - ensureTriangleCapacity
```
void ensureTriangleCapacity(int cap)
```
    Hint for ensuring sufficient storage for triangles
    
    Parameters:
    
    cap - capacity
  - createTriangleGroup
```
int createTriangleGroup()
```
    Creates a new group of triangles that can be rendered. By default, only one triangle group exists.
    
    Returns:
    
    the index of the new group of triangles
    
    See Also:
    
    triangleGroup(int)
  - triangleGroup
```
void triangleGroup(int setIdx)
```
    Sets the current active triangle group for rendering.
    
    Parameters:
    
    setIdx - index of active triangle group.
  - getTriangleGroupIdx
```
int getTriangleGroupIdx()
```
    Returns the index of the currently active triangle group.
  - numTriangleGroups
```
int numTriangleGroups()
```
    The number of triangle groups available.
  - numTriangles
```
int numTriangles(int tgroup)
```
    Number of triangle primitives defined in a group.
  - getTriangle
```
int[] getTriangle(int tgroup,
                  int tidx)
```
    Retrieves the triangle at the supplied index in a given group. The returned triangle should not be modified.
    
    Parameters:
    
    tgroup - triangle group index
    
    tidx - triangle index
    
    Returns:
    
    vertex indices of triangle
  - getTriangles
```
java.util.List<int[]> getTriangles(int tgroup)
```
    Returns the list of triangles (vertex indices) for a given group
    
    Parameters:
    
    tgroup - point group index
    
    Returns:
    
    vertex indices for triangle group
  - getTrianglesVersion
```
int getTrianglesVersion()
```
    Returns the latest committed triangles version number, for use in detecting if changes are present.
  - clearPrimitives
```
void clearPrimitives()
```
    Clears all primitive groups, allowing them to be recreated. Vertex information remains untouched.
  - reinitialize
```
void reinitialize()
```
    Clears everything in the RenderObject, allowing it to be recreated. This can be used when the object becomes invalid, in place of discarding and regenerating a new one. The object becomes a clean slate, with no vertex attributes or primitives.
  - commit
```
void commit()
```
    Signal that the object is complete and ready for rendering. No more data can be added to the renderable until it is cleared. Only dynamic components can be modified. This function should be called before first use (either manually, or by a renderer)
  - isCommitted
```
boolean isCommitted()
```
    Indicates whether or not the object is complete and ready for rendering.
  - getVersion
```
int getVersion()
```
    Retrieves the version of the object, for use in detecting whether any information has changed since last use.
    
    Returns:
    
    the overall modification version
  - invalidate
```
void invalidate()
```
    Invalidates the object. An invalid object cannot be drawn by the renderer.
    
    See Also:
    
    isValid()
  - isValid
```
boolean isValid()
```
    Returns whether or not this RenderObject is valid. If valid, this object can be safely passed to a renderer for drawing. If not, it needs to be discarded.
    
    Returns:
    
    true if this RenderObject is valid
  - dispose
```
void dispose()
```
    Signal a destruction of the object.
  - setStreaming
```
void setStreaming(boolean set)
```
    A streaming object has a short life-span, and cannot be modified once committed.
  - isStreaming
```
boolean isStreaming()
```
    A streaming object has a short life-span, and cannot be modified once committed.

Interface RenderObjectInterface

Nested Class Summary

Method Summary

Method Detail

getIdentifier

getVersionInfo

getStateInfo

ensurePositionCapacity

addPosition

position

position

setPosition

hasPositions

numPositions

getPosition

getPositions

setPositionsDynamic

isPositionsDynamic

createPositionSet

createPositionSetFrom

positionSet

getPositionSetIdx

numPositionSets

getPosition

getPositions

getPositionsVersion

ensureNormalCapacity

addNormal

normal

normal

setNormal

hasNormals

numNormals

getNormal

getNormals

setNormalsDynamic

isNormalsDynamic

createNormalSet

createNormalSetFrom

normalSet

getNormalSetIdx

numNormalSets

getNormal

getNormals

getNormalsVersion

ensureColorCapacity

addColor

addColor

addColor

addColor

color

color

color

color

color

setColor

setColor

setColor

setColor

hasColors

numColors

getColor

getColors

setColorsDynamic

isColorsDynamic

createColorSet

createColorSetFrom

colorSet

getColorSetIdx

numColorSets

getColor

getColors

getColorsVersion

ensureTextureCoordCapacity

addTextureCoord

textureCoord

textureCoord

setTextureCoord

hasTextureCoords

numTextureCoords