glGetBufferPointerv

glGetBufferPointerv

Name

glGetBufferPointerv - Liefert einen Zeiger auf den Datenbereich eines gemappten Puffer-Objektes.

Delphi-Spezifikation

 procedure glGetBufferPointerv(target: TGLenum; pname: TGLenum; params: PGLvoid);

Parameter

target	Ziel des Puffer-Objekts. Muss GL_ARRAY_BUFFER oder GL_ELEMENT_ARRAY_BUFFER sein.
pname	Der abzufragende Zeiger. Nur symbolische Konstante GL_BUFFER_MAP_POINTER ist zulässig.
params	Zeiger auf Speicher, wo das Abfrageergebnis gespeichert werden soll.

Beschreibung

glGetBufferPointerv mit target GL_ARRAY_BUFFER oder GL_ELEMENT_ARRAY_BUFFER und pname GL_BUFFER_MAP_POINTER gibt über params den Zeiger zurück, auf den der Datenspeicher eines Puffer-Objektes gemappt ist.

target gibt an, von welcher Art das abzufragende, (mit glBindBuffer) momentan gebundene Puffer-Objekt sein soll:

GL_ARRAY_BUFFER

Das momentan gebundene Puffer-Objekt dient zur Speicherung von Vertexarray-Daten.

GL_ELEMENT_ARRAY_BUFFER

Das momentan gebundene Puffer-Objekt dient zur Speicherung von Indexwerten für Vertexarrays.

Falls der Datenspeicher des Puffers momentan nicht auf dem OpenGL-Server gemappt wird, liefert params NULL/NIL zurück. Abhängig von der Implementation kann params auch NULL/NIL zurückgeben, falls nur der aufzurufende Client den Datenspeicher des Puffers nicht gemappt hat.

Hinweise

glGetBufferPointerv ist erst ab OpenGL Version 1.5 verfügbar!

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target oder pname ungültige Werte übergeben werden.
GL_INVALID_OPERATION wird generiert, wenn glGetBufferPointerv innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

glGetBufferParameter mit Token GL_BUFFER_SIZE gibt die Größe des Puffer-Objektes in basic machine units zurück.
glGetBufferParameter mit Token GL_BUFFER_MAPPED gibt zurück, ob ein Puffer-Objekt momentan gemappt wird.
glGetBufferParameter mit Token GL_BUFFER_ACCESS gibt den Schreib-Lese-Modus des Puffer-Objektes zurück.

Siehe auch

glBindBuffer, glBufferData, glBufferSubData, glDeleteBuffers, glGenBuffers, glGetBufferParameter, glGetBufferSubData, glIsBuffer, glMapBuffer, glUnmapBuffer