glIndexPointer
(Mehr Informationen/weitere Artikel) {{{1}}} |
 |
Inhaltsverzeichnis
glIndexPointer
Name
glIndexPointer - definiert ein Feld mit Farbindizes.
Delphi-Spezifikation
procedure glIndexPointer(_type: TGLenum; stride: TGLsizei; const _pointer: PGLvoid);
Parameter
| _type | Bestimmt den Datentyp aller Farbindizes im Feld. Folgende symbolische Konstanten werden akzeptiert: GL_UNSIGNED_BYTE, GL_SHORT, GL_INT, GL_FLOAT, und GL_DOUBLE |
|---|---|
| stride | Bestimmt den Byte-Versatz (Offset) für aufeinanderfolgende Farbindizes. Wenn stride gleich 0 ist (Initalwert) werden die Farbindizes dicht zusammengepackt im Feld gespeichert. |
| _pointer | Ist der Pointer auf den ersten Farbindex im Feld. |
Beschreibung
glIndexPointer specifies the location and data format of an array of color indexes to use when rendering. type specifies the data type of each color index and stride gives the byte stride from one color index 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.)
type, stride, and pointer are saved as client-side state.
The color index array is initially disabled. To enable and disable the array, call glEnableClientState and glDisableClientState with the argument GL_INDEX_ARRAY. If enabled, the color index array is used when glDrawArrays, glDrawElements or glArrayElement is called.
Use glDrawArrays to construct a sequence of primitives (all of the same type) from prespecified vertex and vertex attribute arrays. Use glArrayElement to specify primitives by indexing vertexes and vertex attributes and glDrawElements to construct a sequence of primitives by indexing vertexes and vertex attributes.
Hinweise
glIndexPointer ist erst ab OpenGL Version 1.1 verfügbar.
Das Farbindexfeld ist nach der Initialisierung der GL deaktiviert und wird nicht benutzt wenn glArrayElement, glDrawElements oder glDrawArrays aufgerufen wird.
glIndexPointer darf nicht innerhalb von glBegin-glEnd Blöcken ausgeführt werden. Wird dies doch gemacht, kann nicht garantiert werden, dass ein Fehler generiert wird. Sollte kein Fehler generiert werden ist die Operation undefiniert.
glIndexPointer ist typischerweise Klientseitig implementiert. (siehe OpenGL Eigenschaften)
Da die Parameter für das Farbindexfeld Zustände des Klientrechners sind, werden sie nicht von glPushAttrib/glPopAttrib gespeichert. Nutzen Sie dazu statt dessen glPushClientAttrib/glPopClientAttrib.
Fehlermeldungen
GL_INVALID_ENUM wird generiert wenn _type kein gültiger Wert übergeben wurde.
GL_INVALID_VALUE wird generiert wenn stride negativ ist.
Zugehörige Wertrückgaben
glIsEnabled mit Token GL_INDEX_ARRAY
glGet mit Token GL_INDEX_ARRAY_TYPE
glGet mit Token GL_INDEX_ARRAY_STRIDE
glGetPointerv mit Token GL_INDEX_ARRAY_POINTER
Siehe auch
glArrayElement, glColorPointer, glDrawArrays, glDrawElements, glEdgeFlagPointer, glEnable, glGetPointerv, glInterleavedArrays, glNormalPointer, glPopClientAttrib, glPushClientAttrib, glTexCoordPointer, glVertexPointer
