glGetBufferPointerv

Aus DGL Wiki
Wechseln zu: Navigation, Suche

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