glColorPointer

Hinweis: Dieser Artikel ist noch unvollständig. (Mehr Informationen/weitere Artikel) {{{1}}}

---

glColorPointer

Name

glColorPointer - definiert ein Feld das Farben enthält.

Delphi-Spezifikation

procedure glColorPointer(size: TGLint; _type: TGLenum; stride: TGLsizei; const _pointer: PGLvoid);

Parameter

size	Gibt an aus wievielen Komponenten die Farbe besteht. (Muss 3 oder 4 sein)
_type	Bestimmt den Datentyp jeder Farbcomponente im Feld. Als Symbolische Konstanten werden GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT, und GL_DOUBLE akzeptiert.
stride	Specifies 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	Bestimmt einen Zeiger auf die erste Farbkomponente, der ersten Farbe im Feld.

Beschreibung

glColorPointer specifies the location and data format of an array of color components to use when rendering. size specifies the number of components per color, and must be 3 or 4. type specifies the data type of each color component, and stride specifies 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 efficient on some implementations; see glInterleavedArrays.)

When a color array is specified, 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.

Hinweise

glColorPointer ist erst ab OpenGL Version 1.1 oder später verfügbar.

Im Initialisierungszustand ist das Farbfeld deaktiviert und wird von glArrayElement, glDrawArrays bzw. glDrawElements nicht benutzt, wenn diese Befehle aufgerufen werden.

Ein Aufruf von glColorPointer innerhalb eines glBegin-glEnd Blocks ist nicht erlaubt. Trotzdem kann es sein, dass kein Fehler generiert wird. Wenn dies geschieht, ist die Operation undefiniert.

glColorPointer ist normalerweise auf der Klientseite implementiert.

Farbfeld Parameter werden klientseitig gespeichert und können deshalb nicht mit glPushAttrib und glPopAttrib gespeichert bzw. wiederhergestellt werden. Benutzen Sie stattdessen glPushClientAttrib und glPopClientAttrib.

Fehlermeldungen

GL_INVALID_VALUE wird generiert wenn size nicht 3 oder 4 ist.
GL_INVALID_ENUM wird generiert wenn type ein ungültiger Wert zugewiesen wird.
GL_INVALID_VALUE wird generiert wenn stride negativ ist.

Zugehörige Wertrückgaben

glIsEnabled mit dem Token GL_COLOR_ARRAY
glGet mit Token GL_COLOR_ARRAY_SIZE
glGet mit Token GL_COLOR_ARRAY_TYPE
glGet mit Token GL_COLOR_ARRAY_STRIDE
glGetPointerv mit dem Token GL_COLOR_ARRAY_POINTER

Siehe auch

glArrayElement, glDrawArrays, glDrawElements, glEdgeFlagPointer, glEnable, glGetPointerv, glIndexPointer, glInterleavedArrays, glNormalPointer, glPopClientAttrib, glPushClientAttrib, glTexCoordPointer, glVertexPointer