GLREPLACEMENTCODEPOINTERSUN(3gl)GLREPLACEMENTCODEPOINTERSUN(3gl)NAME
glReplacementCodePointerSUN - define an array of replacement codes
C SPECIFICATION
void glReplacementCodePointerSUN( GLenum type,
GLsizei stride,
const GLvoid *pointer )
PARAMETERS
type Specifies the data type of each color component in the array.
Symbolic constants GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT, and
GL_UNSIGNED_INT, are accepted.
stride Specifies the byte offset between consecutive replacement
codes. If stride is 0, (the initial value), the replacement
codes are understood to be tightly packed in the array.
pointer Specifies a pointer to the first replacement code element in
the array.
DESCRIPTION
glReplacementCodePointerSUN specifies the location and data format of
an array of replacement codes to use when rendering. type specifies
the data type of each replacement code, and stride specifies the byte
stride from one replacement code to the next allowing vertices and
attributes to be packed into a single array or stored in separate
arrays. (Single-array storage may be more efficient on some implemen‐
tations; see glInterleavedArrays.)
When a replacement code array is specified, type, stride, and pointer
are saved as client-side state.
To enable and disable the replacement code array, call glEnable‐
ClientState and
glDisableClientState with the argument GL_REPLACEMENT_CODE_ARRAY_SUN.
If enabled, the replacement code array is used when glDrawArrays,
glDrawElements, or glArrayElement is called.
NOTES
glReplacementCodePointerSUN is available only if the GL_TRIAN‐
GLE_LIST_SUN extension is supported. It is applied to triangle list
primitive only.
The replacement code array is initially disabled and isn't accessed
when glArrayElement, glDrawArrays, or glDrawElements is called.
Execution of glReplacementCodePointerSUN is not allowed between the
execution of glBegin and the corresponding execution of glEnd, but an
error may or may not be generated. If no error is generated, the opera‐
tion is undefined.
glReplacementCodePointerSUN is typically implemented on the client
side.
Replacement code array parameters are client-side state and are there‐
fore not saved or restored by glPushAttrib and glPopAttrib. Use
glPushClientAttrib and glPopClientAttrib instead.
ERRORS
GL_INVALID_ENUM is generated if type is not an accepted value.
GL_INVALID_VALUE is generated if stride is negative.
ASSOCIATED GETS
glIsEnabled with argument GL_REPLACEMENT_CODE_ARRAY_SUN
glGet with argument GL_REPLACEMENT_CODE_ARRAY_TYPE_SUN
glGet with argument GL_REPLACEMENT_CODE_ARRAY_STRIDE_SUN
glGetPointerv with argument GL_REPLACEMENT_CODE_ARRAY_POINTER_SUN
SEE ALSO
glArrayElement, glColorPointer, glDrawArrays, glDrawElements, glEdge‐
FlagPointer,
glEnable, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormal‐
Pointer, glPopClientAttrib, glPushClientAttrib, glTexCoordPointer,
glVertexPointer
4 Mar 99 GLREPLACEMENTCODEPOINTERSUN(3gl)