javax.media.j3d
Class IndexedGeometryStripArray

java.lang.Object
  |
  +--javax.media.j3d.SceneGraphObject
        |
        +--javax.media.j3d.NodeComponent
              |
              +--javax.media.j3d.Geometry
                    |
                    +--javax.media.j3d.GeometryArray
                          |
                          +--javax.media.j3d.IndexedGeometryArray
                                |
                                +--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