javax.media.j3d
Class IndexedGeometryStripArray

java.lang.Object
  extended by javax.media.j3d.SceneGraphObject
      extended by javax.media.j3d.NodeComponent
          extended by javax.media.j3d.Geometry
              extended by javax.media.j3d.GeometryArray
                  extended by javax.media.j3d.IndexedGeometryArray
                      extended by javax.media.j3d.IndexedGeometryStripArray
Direct Known Subclasses:
IndexedLineStripArray, IndexedTriangleFanArray, IndexedTriangleStripArray

public abstract class IndexedGeometryStripArray
extends IndexedGeometryArray

The IndexedGeometryStripArray object is an abstract class that is extended for a set of IndexedGeometryArray strip primitives. These include LINE_STRIP, TRIANGLE_STRIP, and TRIANGLE_FAN.


Field Summary
 
Fields inherited from class javax.media.j3d.IndexedGeometryArray
ALLOW_COLOR_INDEX_READ, ALLOW_COLOR_INDEX_WRITE, ALLOW_COORDINATE_INDEX_READ, ALLOW_COORDINATE_INDEX_WRITE, ALLOW_NORMAL_INDEX_READ, ALLOW_NORMAL_INDEX_WRITE, ALLOW_TEXCOORD_INDEX_READ, ALLOW_TEXCOORD_INDEX_WRITE
 
Fields inherited from class javax.media.j3d.GeometryArray
ALLOW_COLOR_READ, ALLOW_COLOR_WRITE, ALLOW_COORDINATE_READ, ALLOW_COORDINATE_WRITE, ALLOW_COUNT_READ, ALLOW_COUNT_WRITE, ALLOW_FORMAT_READ, ALLOW_NORMAL_READ, ALLOW_NORMAL_WRITE, ALLOW_REF_DATA_READ, ALLOW_REF_DATA_WRITE, ALLOW_TEXCOORD_READ, ALLOW_TEXCOORD_WRITE, BY_REFERENCE, COLOR_3, COLOR_4, COORDINATES, INTERLEAVED, NORMALS, TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3, TEXTURE_COORDINATE_4, USE_COORD_INDEX_ONLY, USE_NIO_BUFFER
 
Fields inherited from class javax.media.j3d.Geometry
ALLOW_INTERSECT
 
Constructor Summary
IndexedGeometryStripArray(int vertexCount, int vertexFormat, int indexCount, int[] stripIndexCounts)
          Constructs an empty IndexedGeometryStripArray object with the specified number of vertices, vertex format, number of indices, and array of per-strip index counts.
IndexedGeometryStripArray(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int indexCount, int[] stripIndexCounts)
          Constructs an empty IndexedGeometryStripArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, number of indices, and array of per-strip index counts.
 
Method Summary
 int getNumStrips()
          Get number of strips in the GeometryStripArray
 void getStripIndexCounts(int[] stripIndexCounts)
          Gets a list of indexCounts for each strip.
 void setStripIndexCounts(int[] stripIndexCounts)
          Sets the array of strip index counts.
 void setValidIndexCount(int validIndexCount)
          This method is not supported for indexed geometry strip arrays.
 
Methods inherited from class javax.media.j3d.IndexedGeometryArray
getColorIndex, getColorIndices, getCoordinateIndex, getCoordinateIndices, getIndexCount, getInitialIndexIndex, getNormalIndex, getNormalIndices, getTextureCoordinateIndex, getTextureCoordinateIndex, getTextureCoordinateIndices, getTextureCoordinateIndices, getValidIndexCount, setColorIndex, setColorIndices, setCoordinateIndex, setCoordinateIndices, setInitialColorIndex, setInitialCoordIndex, setInitialIndexIndex, setInitialNormalIndex, setInitialTexCoordIndex, setInitialVertexIndex, setNormalIndex, setNormalIndices, setTextureCoordinateIndex, setTextureCoordinateIndex, setTextureCoordinateIndices, setTextureCoordinateIndices, setValidVertexCount
 
Methods inherited from class javax.media.j3d.GeometryArray
getColor, getColor, getColor, getColor, getColor, getColor, getColorRef3b, getColorRef3f, getColorRef4b, getColorRef4f, getColorRefBuffer, getColorRefByte, getColorRefFloat, getColors, getColors, getColors, getColors, getColors, getColors, getCoordinate, getCoordinate, getCoordinate, getCoordinate, getCoordinates, getCoordinates, getCoordinates, getCoordinates, getCoordRef3d, getCoordRef3f, getCoordRefBuffer, getCoordRefDouble, getCoordRefFloat, getInitialColorIndex, getInitialCoordIndex, getInitialNormalIndex, getInitialTexCoordIndex, getInitialVertexIndex, getInterleavedVertexBuffer, getInterleavedVertices, getNormal, getNormal, getNormalRef3f, getNormalRefBuffer, getNormalRefFloat, getNormals, getNormals, getTexCoordRef2f, getTexCoordRef3f, getTexCoordRefBuffer, getTexCoordRefFloat, getTexCoordSetCount, getTexCoordSetMap, getTexCoordSetMapLength, getTextureCoordinate, getTextureCoordinate, getTextureCoordinate, getTextureCoordinate, getTextureCoordinate, getTextureCoordinate, getTextureCoordinate, getTextureCoordinates, getTextureCoordinates, getTextureCoordinates, getTextureCoordinates, getTextureCoordinates, getTextureCoordinates, getTextureCoordinates, getValidVertexCount, getVertexCount, getVertexFormat, setColor, setColor, setColor, setColor, setColor, setColor, setColorRef3b, setColorRef3f, setColorRef4b, setColorRef4f, setColorRefBuffer, setColorRefByte, setColorRefFloat, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setColors, setCoordinate, setCoordinate, setCoordinate, setCoordinate, setCoordinates, setCoordinates, setCoordinates, setCoordinates, setCoordinates, setCoordinates, setCoordinates, setCoordinates, setCoordRef3d, setCoordRef3f, setCoordRefBuffer, setCoordRefDouble, setCoordRefFloat, setInterleavedVertexBuffer, setInterleavedVertices, setNormal, setNormal, setNormalRef3f, setNormalRefBuffer, setNormalRefFloat, setNormals, setNormals, setNormals, setNormals, setTexCoordRef2f, setTexCoordRef3f, setTexCoordRefBuffer, setTexCoordRefFloat, setTextureCoordinate, setTextureCoordinate, setTextureCoordinate, setTextureCoordinate, setTextureCoordinate, setTextureCoordinate, setTextureCoordinate, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, setTextureCoordinates, updateData
 
Methods inherited from class javax.media.j3d.NodeComponent
cloneNodeComponent, cloneNodeComponent, duplicateNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree
 
Methods inherited from class javax.media.j3d.SceneGraphObject
clearCapability, clearCapabilityIsFrequent, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setUserData, updateNodeReferences
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IndexedGeometryStripArray

public IndexedGeometryStripArray(int vertexCount,
                                 int vertexFormat,
                                 int indexCount,
                                 int[] stripIndexCounts)
Constructs an empty IndexedGeometryStripArray object with the specified number of vertices, vertex format, number of indices, and array of per-strip index counts.

Parameters:
vertexCount - the number of vertex elements in this array
vertexFormat - a mask indicating which components are present in each vertex. This is specified as one or more individual flags that are bitwise "OR"ed together to describe the per-vertex data. The flags include: COORDINATES, to signal the inclusion of vertex positions--always present; NORMALS, to signal the inclusion of per vertex normals; one of COLOR_3, COLOR_4, to signal the inclusion of per vertex colors (without or with color information); and one of TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3 or TEXTURE_COORDINATE_4, to signal the inclusion of per-vertex texture coordinates 2D, 3D or 4D.
indexCount - the number of indices in this object. This count is the maximum number of vertices that will be rendered.
stripIndexCounts - array that specifies the count of the number of indices for each separate strip. The length of this array is the number of separate strips. The sum of the elements in this array defines the total number of valid indexed vertices that are rendered (validIndexCount).
Throws:
java.lang.IllegalArgumentException - if validIndexCount > indexCount

IndexedGeometryStripArray

public IndexedGeometryStripArray(int vertexCount,
                                 int vertexFormat,
                                 int texCoordSetCount,
                                 int[] texCoordSetMap,
                                 int indexCount,
                                 int[] stripIndexCounts)
Constructs an empty IndexedGeometryStripArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, number of indices, and array of per-strip index counts.

Parameters:
vertexCount - the number of vertex elements in this object

vertexFormat - a mask indicating which components are present in each vertex. This is specified as one or more individual flags that are bitwise "OR"ed together to describe the per-vertex data. The flags include: COORDINATES, to signal the inclusion of vertex positions--always present; NORMALS, to signal the inclusion of per vertex normals; one of COLOR_3, COLOR_4, to signal the inclusion of per vertex colors (without or with color information); and one of TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3 or TEXTURE_COORDINATE_4, to signal the inclusion of per-vertex texture coordinates 2D, 3D or 4D.

texCoordSetCount - the number of texture coordinate sets in this GeometryArray object. If vertexFormat does not include one of TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3 or TEXTURE_COORDINATE_4, the texCoordSetCount parameter is not used.

texCoordSetMap - an array that maps texture coordinate sets to texture units. The array is indexed by texture unit number for each texture unit in the associated Appearance object. The values in the array specify the texture coordinate set within this GeometryArray object that maps to the corresponding texture unit. All elements within the array must be less than texCoordSetCount. A negative value specifies that no texture coordinate set maps to the texture unit corresponding to the index. If there are more texture units in any associated Appearance object than elements in the mapping array, the extra elements are assumed to be -1. The same texture coordinate set may be used for more than one texture unit. Each texture unit in every associated Appearance must have a valid source of texture coordinates: either a non-negative texture coordinate set must be specified in the mapping array or texture coordinate generation must be enabled. Texture coordinate generation will take precedence for those texture units for which a texture coordinate set is specified and texture coordinate generation is enabled. If vertexFormat does not include one of TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3 or TEXTURE_COORDINATE_4, the texCoordSetMap array is not used.

indexCount - the number of indices in this object. This count is the maximum number of vertices that will be rendered.

stripIndexCounts - array that specifies the count of the number of indices for each separate strip. The length of this array is the number of separate strips. The sum of the elements in this array defines the total number of valid indexed vertices that are rendered (validIndexCount).
Throws:
java.lang.IllegalArgumentException - if validIndexCount > indexCount
Since:
Java 3D 1.2
Method Detail

getNumStrips

public int getNumStrips()
Get number of strips in the GeometryStripArray

Returns:
numStrips number of strips

setStripIndexCounts

public void setStripIndexCounts(int[] stripIndexCounts)
Sets the array of strip index counts. The length of this array is the number of separate strips. The elements in this array specify the number of indices for each separate strip. The sum of the elements in this array defines the total number of valid indexed vertices that are rendered (validIndexCount).

Parameters:
stripIndexCounts - array that specifies the count of the number of indices for each separate strip.
Throws:
java.lang.IllegalArgumentException - if initialIndexIndex + validIndexCount > indexCount
Since:
Java 3D 1.3

getStripIndexCounts

public void getStripIndexCounts(int[] stripIndexCounts)
Gets a list of indexCounts for each strip. The list is copied into the specified array. The array must be large enough to hold all of the ints.

Parameters:
stripIndexCounts - an array that will receive indexCounts

setValidIndexCount

public void setValidIndexCount(int validIndexCount)
This method is not supported for indexed geometry strip arrays. The sum of the elements in the strip index counts array defines the valid index count.

Overrides:
setValidIndexCount in class IndexedGeometryArray
Parameters:
validIndexCount - the new valid index count.
Throws:
java.lang.UnsupportedOperationException - this method is not supported
Since:
Java 3D 1.3