alBuffer

Aus DGL Wiki
(Weitergeleitet von alBufferfv)
Wechseln zu: Navigation, Suche

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


Siehe auch

alBufferData, alGetBuffer