alBuffer
Inhaltsverzeichnis
alBuffer
Name
alBuffer - Setzt Eigenschaften eines Puffers der OpenAL.
Delphi-Spezifikation
procedure alBuffer3f(buffer: TALuint; param: TALenum; v1: TALfloat; v2: TALfloat; v3: TALfloat); procedure alBufferf(buffer: TALuint; param: TALenum; value: TALfloat); procedure alBufferfv(buffer: TALuint; param: TALenum; values: PALfloat); procedure alBuffer3i(buffer: TALuint; param: TALenum; v1: TALint; v2: TALint; v3: TALint); procedure alBufferi(buffer: TALuint; param: TALenum; value: TALint); procedure alBufferiv(buffer: TALuint; param: TALenum; values: PALint);
Parameter
| buffer | Puffer, dessen Eigenschaft gesetzt werden soll |
|---|---|
| param | Symbolische Konstante, welche die zu setzende Eigenschaft bestimmt |
| value | Der zu setzende TALfloat- bzw. TALint-Wert (nur bei alBufferf bzw. alBufferi) |
| values | Zeiger auf einen TALfloat-/ TALint-Array, welcher die zu setzenden Werte enthält (nur bei alBufferfv bzw. alBufferiv) |
| v1, v2, v3 | Die drei zu setzenden TALfloat- bzw. TALint-Werte (nur bei alBuffer3f bzw. alBuffer3i) |
Beschreibung
Die Funktion alBuffer bzw. ihre Varianten für verschiedene Wertargumente setzt die durch den Parameter param angegebene Eigenschaft eines OpenAL-Puffers.
Hinweise
In der Spezifikation für OpenAL 1.1 sind keine relevanten Eigenschaften definiert, welche durch diese Funktion gesetzt werden könnten. Puffereigenschaften werden zur Zeit allein beim Füllen eines Puffers durch alBufferData festgelegt. Jedoch besteht die Möglichkeit, dass eine OpenAL-Erweiterung die Funktion alBuffer benutzt.
Falls bei der Ausführung ein Fehler auftritt, kann dieser mit alGetError abgefragt werden.
Änderungen
Folgende Erweiterungen hat die Funktion erfahren:
Ab OpenAL-Version 1.1
Die Funktion alBuffer bzw. ihre Varianten alBuffer3f, alBufferf, alBufferfv, alBuffer3i, alBufferi und alBufferiv sind erst ab Version 1.1 der AL verfügbar.
Fehlermeldungen
AL_INVALID_ENUM wird generiert, wenn der angegebene Parameter param unzulässig ist.
AL_INVALID_NAME wird generiert, falls der Puffer buffer keine Parameter hat (sprich: der Nullpuffer ist) oder wenn dieser Puffer nicht existiert. (Siehe dazu auch alIsBuffer.)
Zugehörige Wertrückgaben
alGetBuffer mit entsprechendem Token
