Aktuelle Version vom 1. Mai 2008, 17:54 Uhr

alutCreateBufferFromFile

Name

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

Delphi-Spezifikation

function alutCreateBufferFromFile(const filename: PChar): TALunit;

Parameter

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)