glEnableClientState

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glEnableClientState, glDisableClientState

Name

glEnableClientState und glDisableClientState aktivieren und deaktivieren clientseitige Eigenschaften.


Delphi-Spezifikation

procedure glEnableClientState(cap: TGLenum);
procedure glDisableClientState(cap: TGLenum);


Parameter

cap Bestimmt, welche Eigenschaft aktiviert/deaktiviert werden soll. Mögliche Parameter sind:

GL_COLOR_ARRAY, GL_EDGE_FLAG_ARRAY, GL_INDEX_ARRAY, GL_NORMAL_ARRAY, GL_TEXTURE_COORD_ARRAY und GL_VERTEX_ARRAY



Beschreibung

glEnableClientState und glDisableClientState aktiviert oder deaktiviert clientseitig Ressourcen. Standardmäßig sind alle clientseitigen Resourcen deaktiviert. Der Parameter cap legt fest, welche Ressource durch den Aufruf von glEnableClientState aktiviert beziehungsweise durch glDisableClientState deaktivert werden soll.

Folgende Werte kann cap annehmen:

GL_COLOR_ARRAY Wenn aktiviert, wird der Schreibzugriff des Farb-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glColorPointer.)
GL_EDGE_FLAG_ARRAY Wenn aktiviert, wird der Schreibzugriff des EdgeFlag-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glEdgeFlagPointer.)
GL_INDEX_ARRAY Wenn aktiviert, wird der Schreibzugriff des Index-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glIndexPointer.)
GL_NORMAL_ARRAY Wenn aktiviert, wird der Schreibzugriff des Normalen-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glNormalPointer.)
GL_TEXTURE_COORD_ARRAY Wenn aktiviert, wird der Schreibzugriff des Texturkoordinaten-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glTexCoordPointer.)
GL_VERTEX_ARRAY Wenn aktiviert, wird der Schreibzugriff des Vertex-Arrays aktiviert und für die Aufrufe von glDrawArrays und glDrawElements benutzt. (Siehe glVertexPointer.)


Momentan sind alle clientseitigen Eigenschaften Vertex-Arrays oder Array mit Vertexeigenschaften, welche von den Funktionen glDrawArrays, glArrayElement und glDrawElements genutzt werden.


Hinweise

Erst ab der OpenGL Version 1.1 verfügbar.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn für cap ein ungültiger Wert übergeben wurde.

glEnableClientState darf nicht innerhalb eines glBegin-glEnd Blocks aufgerufen werden. Laut den GL Man Pages ist nicht sichergestellt, dass bei einem Aufruf ein Fehler (normalerweise GL_INVALID_OPERATION) generiert wird. Sollte kein Fehler generiert werden, ist das Verhalten undefiniert.


Zugehörige Wertrückgaben

Die aktuellen Werte können mit glGet oder glIsEnabled ermittelt werden.


Siehe auch

glArrayElement, glDrawElements, glDrawArrays, glVertexPointer, glColorPointer, glIndexPointer, glEdgeFlagPointer, glNormalPointer und glTexCoordPointer