glInterleavedArrays

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glInterleavedArrays

Name

glInterleavedArrays - spezifiziert und aktiviert gleichzeitig überlappende Arrays.


Delphi-Spezifikation

procedure glInterleavedArrays(format: TGLenum; stride: TGLsizei; const _pointer: PGLvoid);



Parameter

format Gibt den Typ des Arrays an der aktiviert werden soll. Folgende Konstanten werden akzeptiert:
GL_V2F, GL_V3F, GL_C4UB_V2F, GL_C4UB_V3F, GL_C3F_V3F, GL_N3F_V3F, GL_C4F_N3F_V3F, GL_T2F_V3F, GL_T4F_V4F, GL_T2F_C4UB_V3F, GL_T2F_C3F_V3F, GL_T2F_N3F_V3F, GL_T2F_C4F_N3F_V3F und GL_T4F_C4F_N3F_V4F.
stride Legt den Abstand in Bytes zwischen jedem ganzen Array Element fest.



Beschreibung

glInterleavedArrays konfiguriert und aktiviert individuelle Farben, Normalen, Textur und Vertex-Arrays, die Teil eines größeren Arrayelementes sind. Bei manchen Implementationen ist dies effizienter als mehrere kleine Arrays zu haben.

Wenn stride 0 ist, werden die zusammengefügten Elemente im Speicher hintereinander abgelegt. Andernfalls liegen stride Bytes zwischen dem Anfang des einen kompletten Arrayelementes und dem Anfang des nachfolgenden.

format funktioniert als ein Schlüssel, welcher die Extraktion der einzelnen Arrays aus dem großen gesamten Array regelt. Falls format ein T beinhaltet, enthält das Gesamtarray Texturkoordinaten, falls ein C vorhanden ist, enthält das Array Farbwerte, und falls ein N vorhanden ist sind Normalen im Array mit abgespeichert. Vertexkoordinaten sind immer im Array enthalten.

Die Ziffern 2, 3 und 4 geben an, wie viele Werte extrahiert werden. F bedeutet, dass die Werte als Gleitkommazahlen extrahiert werden. Falls eine Farbe als 4 vorzeichenlose Bytes extrahiert wird, dann befindet sich das darauf folgende Arrayelement an der ersten möglichen Gleitkommaadresse.


Hinweise

glInterleavedArrays ist erst ab der OpenGL Version 1.1 verfügbar.

Wird glInterleavedArrays während des Kompilervorgangs einer Displayliste aufgerufen, dann wird es nicht in die Liste kompilert sondern sofort ausgeführt.

Die Ausführung von glInterleavedArrays zwischen glBegin und dem dazugehörigen glEnd ist nicht erlaubt. Jedoch wird eventuell kein Fehler generiert. Falls kein Fehler geniert wird, ist der Ausgang der Operation nicht definiert.

glInterleavedArrays ist normalerweise auf der Clientseite implementiert.

Vertex Array Parameter sind Zustände der Clientseite und werden daher nicht mit glPushAttrib gespeichert oder mit glPopAttrib geladen. Stattdessen kann glPushClientAttrib und glPopClientAttrib dafür verwendet werden.

Für OpenGL Version 1.3 und höher, oder wenn die Erweiterung ARB_multitexture unterstützt wird, aktualisiert glInterleavedArrays nur den Texturkoordinatenarray für die aktive Clienttextureinheit. Der Zustand der Texturkoordinaten für andere Clienttextureinheiten wird nicht aktualisiert, unabhängig davon ob die Clienttextureinheit aktiviert ist oder nicht.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn format nicht akzeptiert wird.

GL_INVALID_VALUE wird generiert, wenn stride negativ ist.



Siehe auch

Hintergrundwissen: VBO ohne glInterleavedArrays

glArrayElement, glColorPointer, glDrawArrays, glDrawElements, glEdgeFlagPointer, glEnableClientState, glGetPointerv, glIndexPointer, glNormalPointer, glTexCoordPointer, glVertexPointer