glEdgeFlagPointer

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glEdgeFlagPointer

Name

glEdgeFlagPointer - definiert einen Zeiger auf ein Feld von EdgeFlags. (siehe glEdgeFlag)


Delphi-Spezifikation

procedure glEdgeFlagPointer(stride: TGLsizei; const _pointer: PGLvoid);


Parameter

stride Definiert den Byteoffset zwischen aufeinanderfolgenden Einträgen im Feld. Wenn stride 0 ist (Initialzustand) wird dies so interpretiert, dass die EdgeFlags ohne Zwischenraum im Feld zusammengepackt sind. Der Initialzustand ist 0.
_pointer Ist ein Zeiger auf den ersten Eintrag in das EdgeFlag Array. (Für C-Programmierer: Der Initialzustand ist 0)



Beschreibung

glEdgeFlagPointer bestimmt Ort und Inhalt eines Feldes mit Booleanwerten, welches EdgeFlags (siehe glEdgeFlag) darstellt, die während des Renders benutzt werden sollen. stride bestimmt den Abstand der Bytes zwischen aufeinanderfolgenden Flags. Dies erlaubt es Vertices und Vertexeigenschaften in ein bzw. mehrere Felder zu speichern. (Das Speichern in einem Feld kann bei einigen Implementationen effizienter sein, siehe glInterleavedArrays.)

Wenn ein EdgeFlag-Array spezifiziert wird, werden stride und _pointer als klientseitige Zustände gespeichert.

Um das EdgeFlag Array zu aktivieren bzw. deaktivieren, rufen Sie glEnableClientState und glDisableClientState mit dem Argument GL_EDGE_FLAG_ARRAY auf. Wenn aktiviert wird das EdgeFlag-Array bei Aufrufen von glDrawArrays, glDrawElements, oder glArrayElement benutzt.

Benutzen Sie glDrawArrays, um eine Sequenz von Primitiven (alle vom selben Typ) aus vordefinierten Vertex- und Vertexattributfeldern zu konstruieren.

Benutzen Sie glArrayElement, um Primitive durch Indizierung von Vertices und Vertexattributen zu spezifizieren.

Benutzen Sie glDrawElements, um eine Sequenz von Primitiven durch Indizierung von Vertices und Vertexattributen zu konstruieren.


Hinweise

glEdgeFlagPointer ist erst ab OpenGL Version 1.1 oder höher verfügbar.

Das EdgeFlag Array ist standardmäßig deaktiviert und wird bei Aufrufen von glArrayElement, glDrawElements oder glDrawArrays nicht benutzt.

Ein Aufruf von glEdgeFlagPointer innerhalb eines glBegin-glEnd-Blocks ist nicht erlaubt. Ein Fehler kann, muss aber nicht generiert werden. Wenn kein Fehler generiert wurde, ist die Operation undefiniert.

glEdgeFlagPointer ist normalerweise klientseitig implementiert.

Parameter für das EdgeFlag Array sind klientseitige Zustände und werden deshalb nicht von glPushMatrix bzw. glPopMatrix gespeichert bzw. wiederhergestellt. Benutzen Sie statt dessen glPushClientAttrib und glPopClientAttrib.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn stride negativ ist.

GL_INVALID_OPERATION kann(!) generiert werden, wenn glEdgeFlagPointer innerhalb eines glBegin-glEnd-Blocks aufgerufen wird. (Siehe Hinweise.)


Zugehörige Wertrückgaben

glIsEnabled mit Token GL_EDGE_FLAG_ARRAY

glGet mit Token GL_EDGE_FLAG_ARRAY_STRIDE

glGet mit Token GL_EDGE_FLAG_ARRAY_BUFFER_BINDING

glGet mit Token GL_ARRAY_BUFFER_BINDING

glGetPointerv mit Token GL_EDGE_FLAG_ARRAY_POINTER


Siehe auch

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