glGetBufferParameter

Aus DGL Wiki
Version vom 18. Juni 2011, 19:19 Uhr von Thoronador (Diskussion | Beiträge) (Update, Kategorisierung)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

glGetBufferParameter


Name

glGetBufferParameter - fragt Eigenschaften eines Puffer-Objektes ab.


Delphi-Spezifikation

 procedure glGetBufferParameteriv(target: TGLenum; pname: TGLenum; params: PGLint);


Parameter

target Ziel des Puffer-Objekts. Muss GL_ARRAY_BUFFER, GL_ELEMENT_ARRAY_BUFFER, GL_PIXEL_PACK_BUFFER oder GL_PIXEL_UNPACK_BUFFER sein.
pname Zustand des Puffer-Objektes, welcher abgefragt werden soll. Akzeptierte Werte sind GL_BUFFER_ACCESS, GL_BUFFER_MAPPED, GL_BUFFER_SIZE oder GL_BUFFER_USAGE.
params Zeiger auf Speicher für die abzufragenden Parameter.


Beschreibung

glGetBufferParameter fragt Eigenschaften eines Puffer-Objektes ab.

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.


pname bestimmt, welcher Parameter über params zurückgeliefert wird :

GL_BUFFER_ACCESS

Zugriffsmodus des Puffer-Objektes. Es gibt drei verschiedene Zugriffsmöglichkeiten : GL_READ_ONLY für lesenden Zugriff, GL_WRITE_ONLY für schreibenden Zugriff und GL_READ_WRITE für lesenden und schreibenden Zugriff.

GL_BUFFER_MAPPED

Hinweis, ob ein Puffer-Objekt momentan mit glMapBuffer gemappt wird.

GL_BUFFER_SIZE

Grösse des Datenspeichers eines Puffer-Objektes, gemessen in basic machine units.

GL_BUFFER_USAGE

Performance-Hinweis zur Speicherung und Nutzung der Daten eines Pufferobjektes (siehe auch glBufferData).


Hinweise

glGetBufferParameter ist erst ab OpenGL Version 1.5 verfügbar!

Die Targets GL_PIXEL_PACK_BUFFER und GL_PIXEL_UNPACK_BUFFER sind erst ab OpenGL Version 2.1 verfügbar.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target oder pname ungültige Werte übergeben werden.

GL_INVALID_OPERATION wird generiert, wenn der reservierte Pufferobjektname 0 an target gebunden ist.

GL_INVALID_OPERATION wird generiert, wenn glGetBufferParameter innerhalb eines glBegin-glEnd-Blocks aufgerufen wird.


Siehe auch

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