glBufferData - Versionsgeschichte

Glawesome: /* Siehe auch */

2014-02-21T16:51:06Z

‎Siehe auch

Shaijan am 15. Juni 2011 um 19:35 Uhr

2011-06-15T19:35:09Z

Thoronador: Kategorisierung GL1.5

2008-05-26T13:45:00Z

Kategorisierung GL1.5

Dj3hut1: /* Siehe auch */ glGetBufferPointer -> glGetBufferPointerv

2006-07-02T16:58:41Z

‎Siehe auch: glGetBufferPointer -> glGetBufferPointerv

Dj3hut1: komplette Überarbeitung

2006-07-02T14:47:05Z

komplette Überarbeitung

Änderungen zeigen

I0n0s: Unvollständig, gibt noch mehr usage-Möglichkeiten

2006-05-11T21:17:22Z

Unvollständig, gibt noch mehr usage-Möglichkeiten

Flash: Neuer Artikel

2006-05-10T09:17:53Z

Neuer Artikel

Neue Seite

= glBufferData =

== Name ==
'''glBufferData''' - erstellt und initialisiert den Datenspeicher eines Pufferobjekts.

<br>
== Delphi-Spezifikation ==

procedure '''glBufferData'''(''target'': TGLenum; ''size'': TGLsizei; '''const''' ''data'': PGLvoid; ''usage'': TGLenum);

== Parameter ==

{| border="1" rules="all"
! ''target''
| Bestimmt das Ziel des Pufferobjekts. Muss '''GL_ARRAY_BUFFER''' oder '''GL_ELEMENT_ARRAY_BUFFER''' sein.
|-
! ''size''
| Definiert die Größe des Datenspeichers in ''basic machine units''.
|-
! ''data''
| Spezifiziert die Quelldaten im Arbeitsspeicher des Klienten.
|-
! ''usage''
| Bestimmt das erwartete Benutzungsmuster für den Datenspeicher. Akzeptiert werden '''GL_STATIC_DRAW''' und '''GL_DYNAMIC_DRAW'''.
|}

== Beschreibung ==
'''glBufferData''' ermöglicht es Datenspeicher für Pufferobjekte ([[VBO]]) zu erstellen und zu initialisieren.

Wenn ''data'' nicht NULL/NIL ist, werden die Quelldaten in den Datenspeicher des Pufferobjekts kopiert. Wenn ''data'' NULL/NIL ist, ist der Inhalt des Datenspeichers undefiniert.

Für ''usage'' können folgende Werte benutzt werden:

'''GL_STATIC_DRAW'''
: Wird benutzt, wenn der Inhalt des Datenspeichers einmal durch die Anwendung gesetzt wird, und mehrfach für GL Renderbefehle benutzt wird.

'''GL_DYNAMIC_DRAW'''
: Wird benutzt, wenn der Inhalt des Datenspeichers wiederholt durch die Application geändert wird, und mehrfach für GL Renderbefehle benutzt wird.

'''glBufferData''' zerstört alle existierenden Datenspeicher und setzt die Werte der Zustandsvariablen des Pufferobjekts folgender maßen:

'''GL_BUFFER_SIZE''' initialisiert auf ''size''.
'''GL_BUFFER_USAGE''' initialisiert auf ''usage''.
'''GL_BUFFER_ACCESS''' initialisiert auf '''GL_WRITE_ONLY'''.

Klienten müssen ihre Datenelemente im Speicher konsistent und abhängig von den Anforderungen der Klientplattform ausrichten. Zu diesem Zweck exisitert eine weitere zusätzliche Anforderung, und zwar, dass der Versatz/Offset innerhalb des Puffers zwischen Daten die aus N ''basic machine units'' bestehen ein vielfaches von N sein muss.
<br>

== Hinweise ==
''usage'' dient nur als Performanzhinweis. Der angegebene Wert beschränkt nicht den tatsächlichen Einsatz des Datenspeichers.
{{Hinweis|Es ist allerdings vorstellbar, dass die Grafikkartenhersteller anhand des Wertes ihre Grafikspeicheraufteilung optimieren. Man solle sich aus Performancegründen möglichst an das angegebene Verhalten halten.}}

'''glBufferData''' und [[glBufferSubData]] definieren zwei neue Typen die auf 64-Bit Rechnern funktionieren. Analog zu intptr t in C gibt es den neuen Typ GLintptrARB welcher anstatt von GLint benutzt werden soll, wenn absehbar ist, dass die Werte größer als 2 Miliarden werden. Des Weiteren wird der Typ GLsizeiptrARB eingeführt welcher anstatt von GLsizei benutzt werden soll, wenn absehbar ist, dass eine Anzahl größer als 2 Milliarden wird.

Beide Typen sind als vorzeichenbehaftete Ganzzahlen definiert welche groß genug sind um beliebige Zeiger zu enthalten. Daraus ergibt sich, dass sie auf Systemen mit 64-Bit Zeigern (oder mehr) eine große Menge Bits benutzen.

== Fehlermeldungen ==
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' kein zulässiger Wert übergeben wurde.

'''GL_INVALID_ENUM''' wird generiert wenn ''usage'' kein zulässiger Wert übergeben wurde.

'''GL_OUT_OF_MEMORY''' wird generiert wenn es der GL nicht möglich war einen Datenspeicher der geforderten Größe anzulegen.

== Zugehörige Wertrückgaben ==
[[glGetBufferParameter]] mit Token '''GL_BUFFER_SIZE'''.

[[glGetBufferParameter]] mit Token '''GL_BUFFER_USAGE'''.

[[glGetBufferParameter]] mit Token '''GL_BUFFER_ACCESS'''.

== Siehe auch ==
[[glBufferSubData]], [[glBindBuffer]], [[glDeleteBuffers]], [[glGenBuffers]]

[[Kategorie:GL|BufferData]]

@@ Zeile 143: / Zeile 143: @@
 [[Kategorie:GL|BufferData]]
 [[Kategorie:GL1.5|BufferData]]
-[[Kategorie:GL3]]
+[[Kategorie:GL3|BufferData]]

← Nächstältere Version		Version vom 15. Juni 2011, 19:35 Uhr
Zeile 143:		Zeile 143:
	[[Kategorie:GL\|BufferData]]		[[Kategorie:GL\|BufferData]]
	[[Kategorie:GL1.5\|BufferData]]		[[Kategorie:GL1.5\|BufferData]]
		+	[[Kategorie:GL3]]

@@ Zeile 4: / Zeile 4: @@
 '''glBufferData''' - erstellt und initialisiert den Datenspeicher eines [[VBO|Pufferobjektes]].
-<br>
 == Delphi-Spezifikation ==
 == Parameter ==
@@ Zeile 27: / Zeile 29: @@
 == Beschreibung ==
 '''glBufferData''' ermöglicht es Datenspeicher für Pufferobjekte ([[VBO]]) zu erstellen und zu initialisieren.
@@ Zeile 97: / Zeile 99: @@
 Klienten müssen ihre Datenelemente im Speicher konsistent und abhängig von den Anforderungen der Klientplattform ausrichten. Zu diesem Zweck exisitert die zusätzliche Anforderung, dass der Versatz/Offset innerhalb eines Puffers zu einem Datensatz, der N ''basic machine units'' umfasst, ein Vielfaches von N sein muss.
-<br>
 == Hinweise ==
@@ Zeile 124: / Zeile 127: @@
 '''GL_OUT_OF_MEMORY''' wird generiert, wenn es OpenGL nicht möglich war einen Datenspeicher der geforderten Größe anzulegen.
-'''GL_INVALID_VALUE''' wird generiert, wenn ''size'' negativ ist.<br>
+'''GL_INVALID_VALUE''' wird generiert, wenn ''size'' negativ ist.
@@ Zeile 130: / Zeile 134: @@
 [[glGetBufferParameter]] mit Token '''GL_BUFFER_SIZE''' gibt die Größe des Puffer-Objektes in ''basic machine units'' zurück.<br>
 [[glGetBufferParameter]] mit Token '''GL_BUFFER_USAGE''' gibt den Performance-Hinweis des aktuellen Puffer-Objektes zurück.<br>
-[[glGetBufferSubData]] mit ''target'' '''GL_ARRAY_BUFFER''' oder '''GL_ELEMENT_ARRAY_BUFFER''' gibt den Inhalt des Datenspeichers des aktuellen Puffer-Objektes zurück.<br>
+[[glGetBufferSubData]] mit ''target'' '''GL_ARRAY_BUFFER''' oder '''GL_ELEMENT_ARRAY_BUFFER''' gibt den Inhalt des Datenspeichers des aktuellen Puffer-Objektes zurück.
@@ Zeile 138: / Zeile 142: @@
 [[Kategorie:GL|BufferData]]

@@ Zeile 135: / Zeile 135: @@
 == Siehe auch ==
-[[glBindBuffer]], [[glBufferSubData]], [[glDeleteBuffers]], [[glGenBuffers]], [[glGetBufferParameter]], [[glGetBufferPointer]], [[glGetBufferSubData]], [[glIsBuffer]], [[glMapBuffer]], [[glUnmapBuffer]]
+[[glBindBuffer]], [[glBufferSubData]], [[glDeleteBuffers]], [[glGenBuffers]], [[glGetBufferParameter]], [[glGetBufferPointerv]], [[glGetBufferSubData]], [[glIsBuffer]], [[glMapBuffer]], [[glUnmapBuffer]]
 [[Kategorie:GL|BufferData]]

← Nächstältere Version		Version vom 11. Mai 2006, 21:17 Uhr
Zeile 1:		Zeile 1:
		+	{{Unvollständig}}
		+
	= glBufferData =		= glBufferData =
−
−

	== Name ==		== Name ==