To Next Page

To Previous Page

glColorPointer

Chapter 3

glColorPointer

glColorPointer: deﬁne an array of colors.

C Speciﬁcation

void glColorPointer(

GLint size,

GLenum type,

GLsizei stride,

const GLvoid *pointer)

Parameters

size Speciﬁes the number of components per color. Must be 3 or 4.

type Speciﬁes the data type of each color component in the array. Symbolic

constants GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT,

GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT,

and GL_DOUBLE are accepted.

stride Speciﬁes the byte offset between consecutive colors. If stride is 0, (the

initial value), the colors are understood to be tightly packed in the

array.

pointer Speciﬁes a pointer to the ﬁrst component of the ﬁrst color element in

the array.

Description

glColorPointer speciﬁes the location and data format of an array of color components to

use when rendering. size speciﬁes the number of components per color, and must be 3 or

4. type speciﬁes the data type of each color component, and stride speciﬁes the byte stride

from one color to the next allowing vertexes and attributes to be packed into a single

array or stored in separate arrays. (Single-array storage may be more efﬁcient on some

implementations; see glInterleavedArrays.)

When a color array is speciﬁed, size, type, stride, and pointer are saved as client-side

state.

To enable and disable the color array, call glEnableClientState and glDisableClientState

with the argument GL_COLOR_ARRAY. If enabled, the color array is used when

glDrawArrays, glDrawElements, or glArrayElement is called.

Notes

glColorPointer is available only if the GL version is 1.1 or greater.

The color array is initially disabled and isn’t accessed when glArrayElement,

glDrawArrays, or glDrawElements is called.

HP b2600 Reference Guide

Other manuals for HP b2600