glVertexAttribPointer

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glVertexAttribPointer

Name

glVertexAttribPointer - Definiert ein generisches Vertexattribut-Array


Delphi-Spezifikation

procedure glVertexAttribPointer(index : GLuint; size : GLint; type : GLenum; 
normalized : GLboolean; stride : GLsizei; const pointer : PGLvoid)


Parameter

index Gibt den Index des zu verändernden generischen Vertexattributs an.
size Gibt die Anzahl der Werte für jedes Element des generischen Vertexattribut-Arrays an. Muss 1, 2, 3 oder 4 sein.
type Gibt den Datentyp der Komponenten im Array an. Die symbolischen Konstanten GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT und GL_DOUBLE sind zugelassen.
normalized Gibt an, ob Festkomma-Werte normalisiert werden sollen (GL_TRUE) oder direkt als Festkomma-Werte konvertiert werden sollen (GL_FALSE), wenn auf sie zugegriffen wird.
stride Gibt den Byte-Offset zwischen aufeinanderfolgenden Attribut-Werten an. Wenn stride gleich 0 (der Standard-Wert) ist, werden die Attributvariablen als direkt aufeinanderfolgend im Array angenommen.
pointer Ein Pointer zu der ersten Komponente des ersten Attribut-Werts im Array.


Beschreibung

glVertexAttribPointer legt fest, wo sich ein generisches Array von Vertexattributen befindet und wie dieses aufgebaut ist. Die übergebenen Argumente werden Clientseitig gespeichert. Ist normalized GL_TRUE dann werden vorzeichenbehaftete Integer Werte auf den Bereich [-1,1] und vorzeichenlose auf den Bereich [0,1] übertragen.

Bevor das Array benutzt werden kann, muss es mit glEnableVertexAttribArray aktiviert werden (deaktivieren entsprechend mit glDisableVertexAttribArray). Hierbei muss der gleiche index angegeben werden.

Wenn das Array aktiviert ist, wird es bei glDrawArrays, glDrawElements, glDrawRangeElements, glArrayElement, glMultiDrawElements, oder glMultiDrawArrays Aufrufen verwendet.

Beispiele

Angenommen, man möchte, dass ein Vertex aus Position und Normalenvektor besteht. Dann gibt es im Wesentlichen zwei verschiedene Möglichkeiten, diese Daten im Speicher abzulegen: Abwechselnd (interleaved) oder nacheinander, also zuerst alle Positionsdaten und dann alle Normalenvektoren. In den folgenden Beispielen habe Position den index=0 und Normal den index=1. Außerdem wird davon ausgegangen, dass ein Vektor aus 3 floats (32-bit Fließkommazahl) besteht, sodass die Größe eines einzelnen Vektors 12 Byte sind.

Interleaved

glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 24,  0);
glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 24, 12);

Nach diesen beiden Funktionsaufrufen wird OpenGL den Inhalt des VBOs so interpretieren:

Byte Inhalt
0 Position
12 Normal
24 Position
36 Normal
48 Position
60 Normal


Nacheinander

glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 12,  0);  // alternativ auch stride=0
glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 12, 36);  // alternativ auch stride=0

Nach diesen beiden Funktionsaufrufen wird OpenGL den Inhalt des VBOs so interpretieren:

Byte Inhalt
0 Position
12 Position
24 Position
36 Normal
48 Normal
60 Normal


Hinweise

glVertexAttribPointer ist erst ab OpenGL Version 2.0 oder später verfügbar.

glVertexAttribPointer darf nicht zwischen glBegin und glEnd ausgeführt werden. Wird dies denoch gemacht, kann es sein das ein Fehler generiert wird. Es kann aber auch sein das kein Fehler generiert wird und der Zustand der Operation undefiniert ist.

glVertexAttribPointer ist üblicherweise auf der Client Seite implementiert.

Die Parameter des generischen Vertexattribut-Arrays werden auf der Client Seite gespeichert, und können daher nicht mit glPushAttrib und glPopAttrib gespeichert und wiederhergestellt werden. Statt dessen verwendet man glPushClientAttrib und glPopClientAttrib.

Wenn beim Aufruf von glVertexAttribPointer ein VBO gebunden ist, muss dieses nicht nochmals vor dem Zeichnen z.B. mittels glDrawArrays gebunden werden.

Fehlermeldungen

GL_INVALID_VALUE wird generiert, wenn index größer oder gleich GL_MAX_VERTEX_ATTRIBS ist.

GL_INVALID_VALUE wird generiert, wenn size nicht 1, 2, 3, oder 4 ist.

GL_INVALID_VALUE wird generiert, wenn stride negativ ist.

GL_INVALID_ENUM wird generiert, wenn type kein akzeptierter Wert ist.

Zugehörige Wertrückgaben

Siehe auch

Hintergrundwissen: VBO ohne glInterleavedArrays

Vertex Array Object

glArrayElement, glBindAttribLocation, glDisableVertexAttribArray, glDrawArrays, glDrawElements, glDrawRangeElements, glEnableVertexAttribArray, glMultiDrawArrays, glMultiDrawElements, glPopClientAttrib, glPushClientAttrib, glVertexAttrib