https://wiki.delphigl.com/index.php?action=history&feed=atom&title=alGetBuffer 2026-04-30T21:42:34Z Versionsgeschichte dieser Seite in DGL Wiki MediaWiki 1.27.4 https://wiki.delphigl.com/index.php?title=alGetBuffer&diff=21389&oldid=prev 2008-04-08T15:22:59Z

<p>Die Seite wurde neu angelegt: = alGetBuffer = == Name == &#039;&#039;&#039;alGetBuffer&#039;&#039;&#039; - Liefert Eigenschaften eines Puffers der OpenAL. == Delphi-Spezifikation == procedure &#039;&#039;&#039;alGetBuffer3f&#039;&#039;&#039;(&#039;&#039;buffer&#039;...</p> <p><b>Neue Seite</b></p><div>= alGetBuffer =<br /> <br /> <br /> <br /> == Name ==<br /> '''alGetBuffer''' - Liefert Eigenschaften eines Puffers der OpenAL.<br /> <br /> <br /> <br /> == Delphi-Spezifikation ==<br /> procedure '''alGetBuffer3f'''(''buffer'': TALunit; ''param'': TALenum; ''v1'': PALfloat; ''v2'': PALfloat; ''v3'': PALfloat);<br /> procedure '''alGetBufferf'''(''buffer'': TALunit; ''param'': TALenum; ''value'': PALfloat);<br /> procedure '''alGetBufferfv'''(''buffer'': TALunit; ''param'': TALenum; ''values'': PALfloat);<br /> procedure '''alGetBuffer3i'''(''buffer'': TALunit; ''param'': TALenum; ''v1'': PALint; ''v2'': PALint; ''v3'': PALint);<br /> procedure '''alGetBufferi'''(''buffer'': TALunit; ''param'': TALenum; ''value'': PALint);<br /> procedure '''alGetBufferfi'''(''buffer'': TALunit; ''param'': TALenum; ''values'': PALint);<br /> <br /> <br /> <br /> == Parameter ==<br /> <br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''buffer'' <br /> | Name des Puffers, dessen Eigenschaften bestimmt werden sollen.<br /> |-<br /> ! ''param'' <br /> | Symbolische Konstante, welche die zurückzugebende Eigenschaft festlegt<br /> |-<br /> ! ''value'' <br /> | Zeiger auf eine TALfloat- bzw. TALint-Variable, in welcher der zurückgegebene Wert abgelegt wird (nur bei '''alGetBufferf''' bzw. '''alGetBufferi''')<br /> |-<br /> ! ''values'' <br /> | Zeiger auf einen Array von TALfloat- bzw. TALint-Werten, in welchen die zurückgegebenen Werte gespeichert werden (nur bei '''alGetBufferfv''' bzw. '''alGetBufferiv''')<br /> |-<br /> ! ''v1, v2, v3'' <br /> | Zeiger auf TALfloat- bzw. TALint-Variablen, in denen die zurückgegebenen Werte gespeichert werden (nur bei '''alGetBuffer3f''' bzw. '''algetBuffer3i''')<br /> |}<br /> <br /> <br /> <br /> == Beschreibung == <br /> Die Funktion '''alGetBuffer''' bzw. ihre Varianten für verschiedene Wertargumente liefern Attribute eines Puffers der AL zurück. Welches Attribut genau zurückgeliefert wird, hängt vom Parameter ''param'' ab.<br /> <br /> Folgende Werte sind für den Parameter ''param'' zulässig:<br /> === AL_BITS ===<br /> : Gibt die Anzahl der Bits pro Sample für die Daten im Puffer ''buffer'' zurück. Dieser Wert kann nur durch einen Aufruf von [[alBufferData]] gesetzt werden, typische Werte sind 8 oder 16. '''AL_BITS''' ist nur für die Funktionsvarianten '''alGetBufferi''' und '''alGetBufferiv''' als Parameter zulässig.<br /> <br /> === AL_CHANNELS ===<br /> : Gibt die Anzahl der Audiokanäle der im Puffer gespeicherten Daten zurück. Der Wert kann über [[alBufferData]] gesetzt werden. '''AL_CHANNELS''' ist nur für die Funktionsvarianten '''alGetBufferi''' und '''alGetBufferiv''' als Parameter zulässig.<br /> <br /> === AL_FREQUENCY ===<br /> : Gibt die Frequenz der Audiodaten in Hertz (Hz) bzw. in Samples pro Sekunde zurück. Der Wert kann über [[alBufferData]] gesetzt werden. '''AL_FREQUENCY''' ist nur für die Funktionsvarianten '''alGetBufferi''' und '''alGetBufferiv''' als Parameter zulässig.<br /> <br /> === AL_SIZE ===<br /> : Gibt die Größe der Pufferdaten in Bytes zurück. Dieser Wert kann nur durch einen Aufruf von [[alBufferData]] gesetzt werden. '''AL_SIZE''' ist nur für die Funktionsvarianten '''alGetBufferi''' und '''alGetBufferiv''' als Parameter zulässig.<br /> <br /> <br /> <br /> == Hinweise ==<br /> Für die Funktionsvarianten '''alGetBuffer3f''', '''alGetBufferf''', '''alGetBufferfv''' und '''alGetBuffer3i''' sind in der Spezifikation für OpenAL 1.1 keine relevanten Puffereigenschaften festgelegt, welche mit diesen Funktionen ermittelt werden können. Jedoch könnte eine OpenAL-Erweiterung diese Funktionen benutzen.<br /> <br /> Wer sich [[alBufferData]] anschaut, wird feststellen, dass dort auch das Format der Audiodaten im Puffer festgelegt wird, aber '''alGetBuffer''' keinen Parameter hat, der diese Angabe direkt zurückliefert. Jedoch lässt sich das Format mit Hilfe von '''alGetBuffer''' durch zwei kombinierte Aufrufe mit den Parameter '''AL_BITS''' und '''AL_CHANNELS''' bestimmen.<br /> <br /> Falls bei der Abarbeitung ein Fehler auftritt, kann dieser mit [[alGetError]] abgefragt werden.<br /> <br /> <br /> <br /> == Änderungen ==<br /> Folgende Erweiterungen hat die Funktion erfahren:<br /> === Ab OpenAL-Version 1.1 ===<br /> In der OpenAL-Version 1.1 wurden die Funktionsvarianten für drei Wertargumente und für Vektorwerte, also '''alGetBuffer3f''', '''alGetBufferfv''', '''alGetBuffer3i''' und '''alGetBufferiv''', eingeführt.<br /> <br /> <br /> <br /> == Fehlermeldungen ==<br /> '''AL_INVALID_ENUM''' wird generiert, wenn der angegebene Parameter ''param'' unzulässig ist.<br /> <br /> '''AL_INVALID_NAME''' wird generiert, sofern der angegebene Puffer ''buffer'' keine Eigenschaften hat (d.h. der Nullpuffer ist) oder nicht existiert. (Siehe auch [[alIsBuffer]].)<br /> <br /> '''AL_INVALID_VALUE''' wird generiert, falls die Wertezeiger ungültig sind. Im Fall von '''alGetBufferf''' und '''alGetBufferi''' betrifft dies ''value'', für den Fall der Funktionsvarianten für Vektoren ('''alGetBufferfv''' bzw. '''alGetBufferiv''') betrifft dies den Parameter ''values'' und im Fall der Funktionsvarianten mit drei Wertargumenten, '''alGetBuffer3f''' und '''alGetBuffer3i''' ist mindestens einer der Zeiger ''v1'', ''v2'' oder ''v3'' unzulässig.<br /> <br /> <br /> <br /> == Siehe auch ==<br /> [[alBuffer]], [[alBufferData]]<br /> <br /> [[Kategorie:AL|GetBuffer]]</div>

Thoronador