glEnableClientState: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Fehlermeldungen)
K (Kategorisierung unter GL1.1)
 
(23 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
=glEnableClientState, glDisableClientState=
 
=glEnableClientState, glDisableClientState=
  
<br>
 
== glEnableClientState, glDisableClientState ==
 
Mit Hilfe von '''glEnableClientState''' und '''glDisableClientState''' kann festgelegt werden welche Arrays von den Funktionen [[glArrayElement]], [[glDrawElements]] und [[glDrawArrays]] genutzt werden.
 
  
<br>
+
 
 +
== Name ==
 +
'''glEnableClientState''' und '''glDisableClientState''' aktivieren und deaktivieren clientseitige Eigenschaften.
 +
 
 +
 
 +
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
  
  '''procedure''' glEnableClientState(''_array'': TGLenum);
+
  '''procedure''' glEnableClientState(''cap'': TGLenum);
+
  '''procedure''' glDisableClientState(''cap'': TGLenum);
  '''procedure''' glDisableClientState(''_array'': TGLenum);
+
 
  
<br>
 
  
 
==Parameter==
 
==Parameter==
<table border=1 rules=all>
+
{| border=1 rules=all
<tr>
+
! ''cap''
<td>''_array''</td>
+
| Bestimmt, welche Eigenschaft aktiviert/deaktiviert werden soll. Mögliche Parameter sind: <br>
<td>Enthält die Konstante des zu aktivierenden/deaktivierenden Arrays.</td>
+
'''GL_COLOR_ARRAY, GL_EDGE_FLAG_ARRAY, GL_INDEX_ARRAY, GL_NORMAL_ARRAY, GL_TEXTURE_COORD_ARRAY''' und '''GL_VERTEX_ARRAY'''
</tr>
+
|}
</table>
 
  
''_array'' kann folgende Werte annehmen:
+
 
{| border="1" rules="all"
+
 
|GL_VERTEX_ARRAY
+
 
|Eine Array von Vertexen welches mit [[glVertexPointer]] geladen wurde.
+
== 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:
 +
 
 +
{| {{Prettytable_B1}}
 +
!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_COLOR_ARRAY
+
!GL_EDGE_FLAG_ARRAY
|Farben Array der mit [[glColorPointer]] geladen wurde.
+
|Wenn aktiviert, wird der Schreibzugriff des EdgeFlag-Arrays aktiviert und für die Aufrufe von [[glDrawArrays]] und [[glDrawElements]] benutzt. (Siehe [[glEdgeFlagPointer]].)
 
|-
 
|-
|GL_INDEX_ARRAY
+
!GL_INDEX_ARRAY
|Ein Array welches mit [[glIndexPointer]] geladene Farb-Indizien enthält.
+
|Wenn aktiviert, wird der Schreibzugriff des Index-Arrays aktiviert und für die Aufrufe von [[glDrawArrays]] und [[glDrawElements]] benutzt. (Siehe [[glIndexPointer]].)
 
|-
 
|-
|GL_EDGE_FLAG_ARRAY
+
!GL_NORMAL_ARRAY
|Ein Array der mit [[glEdgeFlagPointer]] geladen wurde.
+
|Wenn aktiviert, wird der Schreibzugriff des Normalen-Arrays aktiviert und für die Aufrufe von [[glDrawArrays]] und [[glDrawElements]] benutzt. (Siehe [[glNormalPointer]].)
 
|-
 
|-
|GL_NORMAL_ARRAY
+
!GL_TEXTURE_COORD_ARRAY
|Ein Array von Normalen welcher mit [[glNormalPointer]] geladen wurde.
+
|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]].)
 
|-
 
|-
|GL_TEXTURE_COORD_ARRAY
 
|Ein Array von Textur Koordinaten welche mit [[glTexCoordPointer]] geladen wurden.
 
 
|}
 
|}
  
<br>
+
 
 +
Momentan sind alle clientseitigen Eigenschaften Vertex-Arrays oder Array mit Vertexeigenschaften, welche von den Funktionen [[glDrawArrays]], [[glArrayElement]] und [[glDrawElements]] genutzt werden.
 +
 
 +
 
 +
 
 
== Hinweise ==
 
== Hinweise ==
 
Erst ab der OpenGL '''Version 1.1''' verfügbar.
 
Erst ab der OpenGL '''Version 1.1''' verfügbar.
  
<br>
+
 
 +
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn ''cap'' ein ungültiger Wert übergeben wurde.
+
'''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 [http://developer.3dlabs.com/glmanpage_index.htm 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.
  
'''glEnableClientState''' darf nicht innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen werden. Laut den [http://developer.3dlabs.com/glmanpage_index.htm 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.
 
  
<br>
 
  
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
 
Die aktuellen Werte können mit [[glGet]] oder [[glIsEnabled]] ermittelt werden.
 
Die aktuellen Werte können mit [[glGet]] oder [[glIsEnabled]] ermittelt werden.
 +
 +
  
 
==Siehe auch==
 
==Siehe auch==
Zeile 62: Zeile 77:
  
 
[[Kategorie:GL|EnableClientState]]
 
[[Kategorie:GL|EnableClientState]]
 +
[[Kategorie:GL1.1|EnableClientState]]

Aktuelle Version vom 3. Juni 2008, 18:32 Uhr

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