Package javax.media.j3d
Class IndexedGeometryArray
java.lang.Object
javax.media.j3d.SceneGraphObject
javax.media.j3d.NodeComponent
javax.media.j3d.Geometry
javax.media.j3d.GeometryArray
javax.media.j3d.IndexedGeometryArray
- Direct Known Subclasses:
IndexedGeometryStripArray
,IndexedLineArray
,IndexedPointArray
,IndexedQuadArray
,IndexedTriangleArray
The IndexedGeometryArray object contains separate integer arrays
that index into the arrays of positional coordinates, colors,
normals, texture coordinates, and vertex attributes.
These index arrays specify how
vertices are connected to form geometry primitives. This class is
extended to create the various indexed primitive types (e.g.,
lines, triangle strips, etc.).
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
Specifies that this IndexedGeometryArray allows reading the array of color indices.static final int
Specifies that this IndexedGeometryArray allows writing the array of color indices.static final int
Specifies that this IndexedGeometryArray allows reading the array of coordinate indices.static final int
Specifies that this IndexedGeometryArray allows writing the array of coordinate indices.static final int
Specifies that this IndexedGeometryArray allows reading the array of normal indices.static final int
Specifies that this IndexedGeometryArray allows writing the array of normal indices.static final int
Specifies that this IndexedGeometryArray allows reading the array of texture coordinate indices.static final int
Specifies that this IndexedGeometryArray allows writing the array of texture coordinate indices.static final int
Specifies that this IndexedGeometryArray allows reading the array of vertex attribute indices.static final int
Specifies that this IndexedGeometryArray allows writing the array of vertex attribute indices.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, ALLOW_VERTEX_ATTR_READ, ALLOW_VERTEX_ATTR_WRITE, BY_REFERENCE, BY_REFERENCE_INDICES, COLOR_3, COLOR_4, COORDINATES, INTERLEAVED, NORMALS, TEXTURE_COORDINATE_2, TEXTURE_COORDINATE_3, TEXTURE_COORDINATE_4, USE_COORD_INDEX_ONLY, USE_NIO_BUFFER, VERTEX_ATTRIBUTES
Fields inherited from class javax.media.j3d.Geometry
ALLOW_INTERSECT
-
Constructor Summary
ConstructorsConstructorDescriptionIndexedGeometryArray
(int vertexCount, int vertexFormat, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, and number of indices.IndexedGeometryArray
(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, and number of indices.IndexedGeometryArray
(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int vertexAttrCount, int[] vertexAttrSizes, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, vertex attribute count, vertex attribute sizes array, and number of indices. -
Method Summary
Modifier and TypeMethodDescriptionint
getColorIndex
(int index) Retrieves the color index associated with the vertex at the specified index for this object.void
getColorIndices
(int index, int[] colorIndices) Retrieves the color indices associated with the vertices starting at the specified index for this object.int
getCoordinateIndex
(int index) Retrieves the coordinate index associated with the vertex at the specified index for this object.void
getCoordinateIndices
(int index, int[] coordinateIndices) Retrieves the coordinate indices associated with the vertices starting at the specified index for this object.int[]
Returns a reference to the coordinate indices associated with the verticesint
Gets number of indices for this IndexedGeometryArray.int
Gets the initial index index for this IndexedGeometryArray object.int
getNormalIndex
(int index) Retrieves the normal index associated with the vertex at the specified index for this object.void
getNormalIndices
(int index, int[] normalIndices) Retrieves the normal indices associated with the vertices starting at the specified index for this object.int
getTextureCoordinateIndex
(int index) Deprecated.int
getTextureCoordinateIndex
(int texCoordSet, int index) Retrieves the texture coordinate index associated with the vertex at the specified index in the specified texture coordinate set for this object.void
getTextureCoordinateIndices
(int index, int[] texCoordIndices) Deprecated.As of Java 3D version 1.2, replaced bygetTextureCoordinateIndices(int texCoordSet, ...)
void
getTextureCoordinateIndices
(int texCoordSet, int index, int[] texCoordIndices) Retrieves the texture coordinate indices associated with the vertices starting at the specified index in the specified texture coordinate set for this object.int
Gets the valid index count for this IndexedGeometryArray object.int
getVertexAttrIndex
(int vertexAttrNum, int index) Retrieves the vertex attribute index associated with the vertex at the specified index for the specified vertex attribute number for this object.void
getVertexAttrIndices
(int vertexAttrNum, int index, int[] vertexAttrIndices) Retrieves the vertex attribute indices associated with the vertices starting at the specified index for the specified vertex attribute number for this object.void
setColorIndex
(int index, int colorIndex) Sets the color index associated with the vertex at the specified index for this object.void
setColorIndices
(int index, int[] colorIndices) Sets the color indices associated with the vertices starting at the specified index for this object.void
setCoordinateIndex
(int index, int coordinateIndex) Sets the coordinate index associated with the vertex at the specified index for this object.void
setCoordinateIndices
(int index, int[] coordinateIndices) Sets the coordinate indices associated with the vertices starting at the specified index for this object.void
setCoordIndicesRef
(int[] coordIndices) Sets the coordinate indices array reference to the specified array.void
setInitialColorIndex
(int initialColorIndex) This method is not supported for indexed geometry arrays.void
setInitialCoordIndex
(int initialCoordIndex) This method is not supported for indexed geometry arrays.void
setInitialIndexIndex
(int initialIndexIndex) Sets the initial index index for this IndexedGeometryArray object.void
setInitialNormalIndex
(int initialNormalIndex) This method is not supported for indexed geometry arrays.void
setInitialTexCoordIndex
(int texCoordSet, int initialTexCoordIndex) This method is not supported for indexed geometry arrays.void
setInitialVertexAttrIndex
(int vertexAttrNum, int initialVertexAttrIndex) This method is not supported for indexed geometry arrays.void
setInitialVertexIndex
(int initialVertexIndex) This method is not supported for indexed geometry arrays.void
setNormalIndex
(int index, int normalIndex) Sets the normal index associated with the vertex at the specified index for this object.void
setNormalIndices
(int index, int[] normalIndices) Sets the normal indices associated with the vertices starting at the specified index for this object.void
setTextureCoordinateIndex
(int index, int texCoordIndex) Deprecated.As of Java 3D version 1.2, replaced bysetTextureCoordinateIndex(int texCoordSet, ...)
void
setTextureCoordinateIndex
(int texCoordSet, int index, int texCoordIndex) Sets the texture coordinate index associated with the vertex at the specified index in the specified texture coordinate set for this object.void
setTextureCoordinateIndices
(int index, int[] texCoordIndices) Deprecated.As of Java 3D version 1.2, replaced bysetTextureCoordinateIndices(int texCoordSet, ...)
void
setTextureCoordinateIndices
(int texCoordSet, int index, int[] texCoordIndices) Sets the texture coordinate indices associated with the vertices starting at the specified index in the specified texture coordinate set for this object.void
setValidIndexCount
(int validIndexCount) Sets the valid index count for this IndexedGeometryArray object.void
setValidVertexCount
(int validVertexCount) This method is not supported for indexed geometry arrays.void
setVertexAttrIndex
(int vertexAttrNum, int index, int vertexAttrIndex) Sets the vertex attribute index associated with the vertex at the specified index for the specified vertex attribute number for this object.void
setVertexAttrIndices
(int vertexAttrNum, int index, int[] vertexAttrIndices) Sets the vertex attribute indices associated with the vertices starting at the specified index for the specified vertex attribute number for this object.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, getInitialVertexAttrIndex, 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, getVertexAttr, getVertexAttr, getVertexAttr, getVertexAttr, getVertexAttrCount, getVertexAttrRefBuffer, getVertexAttrRefFloat, getVertexAttrs, getVertexAttrs, getVertexAttrs, getVertexAttrs, getVertexAttrSizes, 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, setVertexAttr, setVertexAttr, setVertexAttr, setVertexAttr, setVertexAttrRefBuffer, setVertexAttrRefFloat, setVertexAttrs, setVertexAttrs, setVertexAttrs, setVertexAttrs, setVertexAttrs, setVertexAttrs, setVertexAttrs, setVertexAttrs, 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, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString, updateNodeReferences
-
Field Details
-
ALLOW_COORDINATE_INDEX_READ
public static final int ALLOW_COORDINATE_INDEX_READSpecifies that this IndexedGeometryArray allows reading the array of coordinate indices.- See Also:
-
ALLOW_COORDINATE_INDEX_WRITE
public static final int ALLOW_COORDINATE_INDEX_WRITESpecifies that this IndexedGeometryArray allows writing the array of coordinate indices.- See Also:
-
ALLOW_COLOR_INDEX_READ
public static final int ALLOW_COLOR_INDEX_READSpecifies that this IndexedGeometryArray allows reading the array of color indices.- See Also:
-
ALLOW_COLOR_INDEX_WRITE
public static final int ALLOW_COLOR_INDEX_WRITESpecifies that this IndexedGeometryArray allows writing the array of color indices.- See Also:
-
ALLOW_NORMAL_INDEX_READ
public static final int ALLOW_NORMAL_INDEX_READSpecifies that this IndexedGeometryArray allows reading the array of normal indices.- See Also:
-
ALLOW_NORMAL_INDEX_WRITE
public static final int ALLOW_NORMAL_INDEX_WRITESpecifies that this IndexedGeometryArray allows writing the array of normal indices.- See Also:
-
ALLOW_TEXCOORD_INDEX_READ
public static final int ALLOW_TEXCOORD_INDEX_READSpecifies that this IndexedGeometryArray allows reading the array of texture coordinate indices.- See Also:
-
ALLOW_TEXCOORD_INDEX_WRITE
public static final int ALLOW_TEXCOORD_INDEX_WRITESpecifies that this IndexedGeometryArray allows writing the array of texture coordinate indices.- See Also:
-
ALLOW_VERTEX_ATTR_INDEX_READ
public static final int ALLOW_VERTEX_ATTR_INDEX_READSpecifies that this IndexedGeometryArray allows reading the array of vertex attribute indices.- Since:
- Java 3D 1.4
- See Also:
-
ALLOW_VERTEX_ATTR_INDEX_WRITE
public static final int ALLOW_VERTEX_ATTR_INDEX_WRITESpecifies that this IndexedGeometryArray allows writing the array of vertex attribute indices.- Since:
- Java 3D 1.4
- See Also:
-
-
Constructor Details
-
IndexedGeometryArray
public IndexedGeometryArray(int vertexCount, int vertexFormat, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, and number of indices. Defaults are used for all other parameters. The default values are as follows:-
validIndexCount : indexCount
initialIndexIndex : 0
all index array values : 0
- Parameters:
vertexCount
- seeGeometryArray(int,int)
for a description of this parameter.vertexFormat
- seeGeometryArray(int,int)
for a description of this parameter.indexCount
- the number of indices in this object. This count is the maximum number of vertices that will be rendered.- Throws:
IllegalArgumentException
- ifindexCount < 0
;
SeeGeometryArray(int,int)
for more exceptions that can be thrown
-
IndexedGeometryArray
public IndexedGeometryArray(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, and number of indices. Defaults are used for all other parameters.- Parameters:
vertexCount
- seeGeometryArray(int,int,int,int[])
for a description of this parameter.vertexFormat
- seeGeometryArray(int,int,int,int[])
for a description of this parameter.texCoordSetCount
- seeGeometryArray(int,int,int,int[])
for a description of this parameter.texCoordSetMap
- seeGeometryArray(int,int,int,int[])
for a description of this parameter.indexCount
- the number of indices in this object. This count is the maximum number of vertices that will be rendered.- Throws:
IllegalArgumentException
- ifindexCount < 0
;
SeeGeometryArray(int,int,int,int[])
for more exceptions that can be thrown- Since:
- Java 3D 1.2
-
IndexedGeometryArray
public IndexedGeometryArray(int vertexCount, int vertexFormat, int texCoordSetCount, int[] texCoordSetMap, int vertexAttrCount, int[] vertexAttrSizes, int indexCount) Constructs an empty IndexedGeometryArray object with the specified number of vertices, vertex format, number of texture coordinate sets, texture coordinate mapping array, vertex attribute count, vertex attribute sizes array, and number of indices.- Parameters:
vertexCount
- seeGeometryArray(int,int,int,int[],int,int[])
for a description of this parameter.vertexFormat
- seeGeometryArray(int,int,int,int[],int,int[])
for a description of this parameter.texCoordSetMap
- seeGeometryArray(int,int,int,int[],int,int[])
for a description of this parameter.vertexAttrCount
- seeGeometryArray(int,int,int,int[],int,int[])
for a description of this parameter.vertexAttrSizes
- seeGeometryArray(int,int,int,int[],int,int[])
for a description of this parameter.indexCount
- the number of indices in this object. This count is the maximum number of vertices that will be rendered.- Throws:
IllegalArgumentException
- ifindexCount < 0
;
SeeGeometryArray(int,int,int,int[],int,int[])
for more exceptions that can be thrown- Since:
- Java 3D 1.4
-
-
Method Details
-
getIndexCount
public int getIndexCount()Gets number of indices for this IndexedGeometryArray.- Returns:
- indexCount the number of indices
-
setValidIndexCount
public void setValidIndexCount(int validIndexCount) Sets the valid index count for this IndexedGeometryArray object. This count specifies the number of indexed vertices actually used in rendering or other operations such as picking and collision. This attribute is initialized toindexCount
.- Parameters:
validIndexCount
- the new valid index count.- Throws:
CapabilityNotSetException
- if the appropriate capability is not set and this object is part of a live or compiled scene graphIllegalArgumentException
- if either of the following is true:validIndexCount invalid input: '<' 0
, or
initialIndexIndex + validIndexCount > indexCount
ArrayIndexOutOfBoundsException
- if any element in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
in the index array associated with any of the enabled vertex components (coord, color, normal, texcoord) is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the particular component's array.ArrayIndexOutOfBoundsException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
andcoordIndices.length < (initialIndexIndex + validIndexCount)
.- Since:
- Java 3D 1.3
-
getValidIndexCount
public int getValidIndexCount()Gets the valid index count for this IndexedGeometryArray object. For geometry strip primitives (subclasses of IndexedGeometryStripArray), the valid index count is defined to be the sum of the stripIndexCounts array.- Returns:
- the current valid index count
- Throws:
CapabilityNotSetException
- if the appropriate capability is not set and this object is part of a live or compiled scene graph- Since:
- Java 3D 1.3
-
setInitialIndexIndex
public void setInitialIndexIndex(int initialIndexIndex) Sets the initial index index for this IndexedGeometryArray object. This index specifies the first index within this indexed geometry array that is actually used in rendering or other operations such as picking and collision. This attribute is initialized to 0.- Parameters:
initialIndexIndex
- the new initial index index.- Throws:
CapabilityNotSetException
- if the appropriate capability is not set and this object is part of a live or compiled scene graphIllegalArgumentException
- if either of the following is true:initialIndexIndex invalid input: '<' 0
, or
initialIndexIndex + validIndexCount > indexCount
ArrayIndexOutOfBoundsException
- if any element in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
in the index array associated with any of the enabled vertex components (coord, color, normal, texcoord) is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the particular component's array.ArrayIndexOutOfBoundsException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
andcoordIndices.length < (initialIndexIndex + validIndexCount)
.- Since:
- Java 3D 1.3
-
getInitialIndexIndex
public int getInitialIndexIndex()Gets the initial index index for this IndexedGeometryArray object.- Returns:
- the current initial index index
- Throws:
CapabilityNotSetException
- if the appropriate capability is not set and this object is part of a live or compiled scene graph- Since:
- Java 3D 1.3
-
setInitialVertexIndex
public void setInitialVertexIndex(int initialVertexIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array. The initialIndexIndex attribute can be used to set the starting index within the index arrays.- Overrides:
setInitialVertexIndex
in classGeometryArray
- Parameters:
initialVertexIndex
- the new initial vertex index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setInitialCoordIndex
public void setInitialCoordIndex(int initialCoordIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array.- Overrides:
setInitialCoordIndex
in classGeometryArray
- Parameters:
initialCoordIndex
- the new initial coordinate index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setInitialColorIndex
public void setInitialColorIndex(int initialColorIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array.- Overrides:
setInitialColorIndex
in classGeometryArray
- Parameters:
initialColorIndex
- the new initial color index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setInitialNormalIndex
public void setInitialNormalIndex(int initialNormalIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array.- Overrides:
setInitialNormalIndex
in classGeometryArray
- Parameters:
initialNormalIndex
- the new initial normal index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setInitialTexCoordIndex
public void setInitialTexCoordIndex(int texCoordSet, int initialTexCoordIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array.- Overrides:
setInitialTexCoordIndex
in classGeometryArray
- Parameters:
texCoordSet
- texture coordinate set in this geometry arrayinitialTexCoordIndex
- the new initial texture coordinate index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setInitialVertexAttrIndex
public void setInitialVertexAttrIndex(int vertexAttrNum, int initialVertexAttrIndex) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array.- Overrides:
setInitialVertexAttrIndex
in classGeometryArray
- Parameters:
vertexAttrNum
- vertex attribute number in this geometry arrayinitialVertexAttrIndex
- the new initial vertex attribute index.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.4
-
setValidVertexCount
public void setValidVertexCount(int validVertexCount) This method is not supported for indexed geometry arrays. Indexed primitives use an array of indices to determine how to access the vertex array. The validIndexCount attribute can be used to set the number of valid indexed vertices rendered.- Overrides:
setValidVertexCount
in classGeometryArray
- Parameters:
validVertexCount
- the new valid vertex count.- Throws:
UnsupportedOperationException
- this method is not supported- Since:
- Java 3D 1.3
-
setCoordinateIndex
public void setCoordinateIndex(int index, int coordinateIndex) Sets the coordinate index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex indexcoordinateIndex
- the new coordinate index- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if index is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
and the specified coordinateIndex is out of range. The coordinateIndex is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the coordinate array.IllegalStateException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
.
-
setCoordinateIndices
public void setCoordinateIndices(int index, int[] coordinateIndices) Sets the coordinate indices associated with the vertices starting at the specified index for this object.- Parameters:
index
- the vertex indexcoordinateIndices
- an array of coordinate indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if any element of the coordinateIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the coordinate array.IllegalStateException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
.
-
setCoordIndicesRef
public void setCoordIndicesRef(int[] coordIndices) Sets the coordinate indices array reference to the specified array. If the coordinate indices array reference is null, the entire geometry array object is treated as if it were null--any Shape3D or Morph node that uses this geometry array will not be drawn.- Parameters:
coordIndices
- an array of indices to which a reference will be set.- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphIllegalStateException
- if the data mode for this geometry array object is notBY_REFERENCE_INDICES
.ArrayIndexOutOfBoundsException
- if any element of the coordIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the coordinate array.ArrayIndexOutOfBoundsException
- ifcoordIndices.length < (initialIndexIndex + validIndexCount)
.- Since:
- Java 3D 1.5
-
setColorIndex
public void setColorIndex(int index, int colorIndex) Sets the color index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex indexcolorIndex
- the new color index- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if index is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
and the specified colorIndex is out of range. The colorIndex is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the color array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
setColorIndices
public void setColorIndices(int index, int[] colorIndices) Sets the color indices associated with the vertices starting at the specified index for this object.- Parameters:
index
- the vertex indexcolorIndices
- an array of color indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if any element of the colorIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the color array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
setNormalIndex
public void setNormalIndex(int index, int normalIndex) Sets the normal index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex indexnormalIndex
- the new normal index- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if index is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
and the specified normalIndex is out of range. The normalIndex is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the normal array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
setNormalIndices
public void setNormalIndices(int index, int[] normalIndices) Sets the normal indices associated with the vertices starting at the specified index for this object.- Parameters:
index
- the vertex indexnormalIndices
- an array of normal indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if index is less than 0 or is greater than or equal to indexCountArrayIndexOutOfBoundsException
- if any element of the normalIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the normal array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
setTextureCoordinateIndex
public void setTextureCoordinateIndex(int index, int texCoordIndex) Deprecated.As of Java 3D version 1.2, replaced bysetTextureCoordinateIndex(int texCoordSet, ...)
-
setTextureCoordinateIndex
public void setTextureCoordinateIndex(int texCoordSet, int index, int texCoordIndex) Sets the texture coordinate index associated with the vertex at the specified index in the specified texture coordinate set for this object.- Parameters:
texCoordSet
- texture coordinate set in this geometry arrayindex
- the vertex indextexCoordIndex
- the new texture coordinate index- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if neither of theTEXTURE_COORDINATE
bits are set in thevertexFormat
or if the index or texCoordSet is out of range.ArrayIndexOutOfBoundsException
- if index is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
and the specified texCoordIndex is out of range. The texCoordIndex is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the texture coordinate array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.2
-
setTextureCoordinateIndices
public void setTextureCoordinateIndices(int index, int[] texCoordIndices) Deprecated.As of Java 3D version 1.2, replaced bysetTextureCoordinateIndices(int texCoordSet, ...)
-
setTextureCoordinateIndices
public void setTextureCoordinateIndices(int texCoordSet, int index, int[] texCoordIndices) Sets the texture coordinate indices associated with the vertices starting at the specified index in the specified texture coordinate set for this object.- Parameters:
texCoordSet
- texture coordinate set in this geometry arrayindex
- the vertex indextexCoordIndices
- an array of texture coordinate indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if neither of theTEXTURE_COORDINATE
bits are set in thevertexFormat
or if the index or texCoordSet is out of range.ArrayIndexOutOfBoundsException
- if any element of the texCoordIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the texture coordinate array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.2
-
setVertexAttrIndex
public void setVertexAttrIndex(int vertexAttrNum, int index, int vertexAttrIndex) Sets the vertex attribute index associated with the vertex at the specified index for the specified vertex attribute number for this object.- Parameters:
vertexAttrNum
- vertex attribute number in this geometry arrayindex
- the vertex indexvertexAttrIndex
- the new vertex attribute index- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if the index or vertexAttrNum is out of range.ArrayIndexOutOfBoundsException
- if index is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
and the specified vertexAttrIndex is out of range. The vertexAttrIndex is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the vertex attribute array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.4
-
setVertexAttrIndices
public void setVertexAttrIndices(int vertexAttrNum, int index, int[] vertexAttrIndices) Sets the vertex attribute indices associated with the vertices starting at the specified index for the specified vertex attribute number for this object.- Parameters:
vertexAttrNum
- vertex attribute number in this geometry arrayindex
- the vertex indexvertexAttrIndices
- an array of vertex attribute indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if the index or vertexAttrNum is out of range.ArrayIndexOutOfBoundsException
- if any element of the vertexAttrIndices array whose destination position is in the range[initialIndexIndex, initialIndexIndex+validIndexCount-1]
is out of range. An element is out of range if it is less than 0 or is greater than or equal to the number of vertices actually defined for the vertex attribute array.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.4
-
getCoordinateIndex
public int getCoordinateIndex(int index) Retrieves the coordinate index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex index- Returns:
- the coordinate index
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphIllegalStateException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
.
-
getCoordinateIndices
public void getCoordinateIndices(int index, int[] coordinateIndices) Retrieves the coordinate indices associated with the vertices starting at the specified index for this object.- Parameters:
index
- the vertex indexcoordinateIndices
- array that will receive the coordinate indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphIllegalStateException
- if the data mode for this geometry array object isBY_REFERENCE_INDICES
.
-
getCoordIndicesRef
public int[] getCoordIndicesRef()Returns a reference to the coordinate indices associated with the vertices- Returns:
- the coordinate indices array
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphIllegalStateException
- if the data mode for this geometry array object is notBY_REFERENCE_INDICES
.- Since:
- Java 3D 1.5
-
getColorIndex
public int getColorIndex(int index) Retrieves the color index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex index- Returns:
- the color index
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphNullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
getColorIndices
public void getColorIndices(int index, int[] colorIndices) Retrieves the color indices associated with the vertices starting at the specified index for this object. The color indicies are copied into the specified array. The array must be large enough to hold all of the indices.- Parameters:
index
- the vertex indexcolorIndices
- array that will receive the color indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphNullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
getNormalIndex
public int getNormalIndex(int index) Retrieves the normal index associated with the vertex at the specified index for this object.- Parameters:
index
- the vertex index- Returns:
- the normal index
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphNullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
getNormalIndices
public void getNormalIndices(int index, int[] normalIndices) Retrieves the normal indices associated with the vertices starting at the specified index for this object. The normal indicies are copied into the specified array. The array must be large enough to hold all of the normal indicies.- Parameters:
index
- the vertex indexnormalIndices
- array that will receive the normal indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphNullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.
-
getTextureCoordinateIndex
public int getTextureCoordinateIndex(int index) Deprecated.As of Java 3D version 1.2, replaced bygetTextureCoordinateIndex(int texCoordSet, ...)
-
getTextureCoordinateIndex
public int getTextureCoordinateIndex(int texCoordSet, int index) Retrieves the texture coordinate index associated with the vertex at the specified index in the specified texture coordinate set for this object.- Parameters:
texCoordSet
- texture coordinate set in this geometry arrayindex
- the vertex index- Returns:
- the texture coordinate index
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if neither of theTEXTURE_COORDINATE
bits are set in thevertexFormat
or if the index or texCoordSet is out of range.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.2
-
getTextureCoordinateIndices
public void getTextureCoordinateIndices(int index, int[] texCoordIndices) Deprecated.As of Java 3D version 1.2, replaced bygetTextureCoordinateIndices(int texCoordSet, ...)
-
getTextureCoordinateIndices
public void getTextureCoordinateIndices(int texCoordSet, int index, int[] texCoordIndices) Retrieves the texture coordinate indices associated with the vertices starting at the specified index in the specified texture coordinate set for this object. The texture coordinate indices are copied into the specified array. The array must be large enough to hold all of the indices.- Parameters:
texCoordSet
- texture coordinate set in this geometry arrayindex
- the vertex indextexCoordIndices
- array that will receive the texture coordinate indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if neither of theTEXTURE_COORDINATE
bits are set in thevertexFormat
or if the index or texCoordSet is out of range.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.2
-
getVertexAttrIndex
public int getVertexAttrIndex(int vertexAttrNum, int index) Retrieves the vertex attribute index associated with the vertex at the specified index for the specified vertex attribute number for this object.- Parameters:
vertexAttrNum
- vertex attribute number in this geometry arrayindex
- the vertex index- Returns:
- the vertex attribute index
- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if the index or vertexAttrNum is out of range.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.4
-
getVertexAttrIndices
public void getVertexAttrIndices(int vertexAttrNum, int index, int[] vertexAttrIndices) Retrieves the vertex attribute indices associated with the vertices starting at the specified index for the specified vertex attribute number for this object. The vertex attribute indices are copied into the specified array. The array must be large enough to hold all of the indices.- Parameters:
vertexAttrNum
- vertex attribute number in this geometry arrayindex
- the vertex indexvertexAttrIndices
- array that will receive the vertex attribute indices- Throws:
CapabilityNotSetException
- if appropriate capability is not set and this object is part of live or compiled scene graphArrayIndexOutOfBoundsException
- if the index or vertexAttrNum is out of range.NullPointerException
- if theUSE_COORD_INDEX_ONLY
bit is set invertexFormat
.- Since:
- Java 3D 1.4
-
getTextureCoordinateIndex(int texCoordSet, ...)