alutCreateBufferFromFile

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alutCreateBufferFromFile

Name

alutCreateBufferFromFile - Lädt eine Audiodatei in einen OpenAL-Puffer.


Delphi-Spezifikation

function alutCreateBufferFromFile(const filename: PChar): TALunit;


Parameter

filename Zeiger auf einen nullterminierten String, der den Namen der zu ladenden Audiodatei enthält


Beschreibung

Die Funktion alutCreateBufferFromFile versucht, das Audiodatenformat einer Datei zu bestimmen, indem sie auf den Dateinamen und/oder den Inhalt der Datei schaut, und lädt die Audiodaten dann in einen OpenAL-Puffer. Im Erfolgsfall gibt die Funktion den Namen des Puffers zurück, bei Fehlschlag wird AL_NONE zurückgegeben.


Hinweise

Falls bei der Ausführung ein Fehler auftritt, kann dieser mit alutGetError erfragt werden.


Fehlermeldungen

ALUT_ERROR_AL_ERROR_ON_ENTRY wird generiert, sofern beim Aufruf der Funktion bereits ein AL-Fehlerstatus vorhanden war. (Siehe auch alGetError.)

ALUT_ERROR_ALC_ERROR_ON_ENTRY wird generiert, wenn beim Aufruf der Funktion bereits ein ALC-Fehlerstatus vorhanden war. (Siehe auch alcGetError.)

ALUT_ERROR_BUFFER_DATA wird generiert, falls beim Befüllen eines AL-Puffers mit Audiodaten ein Fehler auftrat.

ALUT_ERROR_CORRUPT_OR_TRUNCATED_DATA wird generiert, sofern die Audiodaten fehlerhaft sind.

ALUT_ERROR_GEN_BUFFERS wird generiert, wenn beim Erzeugen des AL-Puffers ein Fehler auftrat.

ALUT_ERROR_INVALID_OPERATION wird generiert, falls ALUT noch nicht initialisiert wurde. (Siehe dazu auch alutInit.)

ALUT_ERROR_IO_ERROR wird generiert, wenn ein Eingabe-/Ausgabefehler aufgetreten ist.

ALUT_ERROR_NO_CURRENT_CONTEXT wird generiert, sofern es keinen aktuellen OpenAL-Kontext gibt. (Siehe auch alcMakeContextCurrent.)

ALUT_ERROR_OUT_OF_MEMORY wird generiert, falls nicht genügend Speicher für die Operation zur Verfügung steht.

ALUT_ERROR_UNSUPPORTED_FILE_SUBTYPE wird generiert, wenn das Unterformat eines ansonsten unterstützten Dateityps nicht unterstützt wird.

ALUT_ERROR_UNSUPPORTED_FILE_TYPE wird generiert, sofern der Dateityp von filename nicht unterstützt wird.


Zugehörige Wertrückgaben

alutGetMIMETypes mit Token ALUT_LOADER_BUFFER gibt eine Liste der unterstützten Dateitypen zurück.


Siehe auch

alutCreateBufferFromFileImage, alutLoadMemoryFromFile, alutLoadMemoryFromFileImage, alutLoadWAVFile (Letztere ist veraltet)