alutLoadMemoryFromFileImage

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alutLoadMemoryFromFileImage

Name

alutLoadMemoryFromFileImage - Konvertiert Audiodaten im Speicher in OpenAL-konforme Daten.


Delphi-Spezifikation

function alutLoadMemoryFromFileImage(const data: PALvoid; length: TALsizei; format: PALenum;
                                    size: PALsizei; frequency: PALfloat): PALvoid;


Parameter

data Zeiger auf die Speicherregion, in der sich die Audiodaten befinden
length Länge der Audiodaten
format Zeiger auf einen TALenum-Wert, in welchem das Format der Audiodaten abgelegt wird
size Zeiger auf einen TALsizei-Wert, in welchem die Größe der Speicherregion gespeichert werden soll
frequency Zeiger auf einen TALfloat, in welchem die Samplefrequenz der Audiodaten angegeben wird


Beschreibung

Die Funktion alutLoadMemoryFromFileImage versucht, dass Audiodatenformat in der durch data angegebenen Speicheregion zu erraten, indem der Inhalt untersucht wird. Die Audiodaten werden in einen neu allokierten Puffer geladen, wobei die Daten möglicherweise umgewandelt werden. Das Format ist danach immer ein Standardformat der AL. Im Erfolgsfall gibt die Funktion einen Zeiger auf den angelegten Speicherbereich zurück, in welchem sich die Audiodaten befinden. Der Speicherbereich kann von der Anwendung freigegeben werden, sobald die darin enthaltenen Daten nicht mehr benötigt werden. Schlägt die Funktion fehl, so wird nil zurückgegeben. Falls einer (oder mehrere) der Parameter format, size oder frequency kein nil-Zeiger ist, so wird die entsprechende Information über die Audiodaten 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 schon ein AL-Fehlerstatus gesetzt war. (Siehe alGetError.)

ALUT_ERROR_ALC_ERROR_ON_ENTRY wird generiert, wenn beim Aufruf der Funktion schon ein ALC-Fehlerstatus gesetzt war. (Siehe alcGetError.)

ALUT_ERROR_CORRUPT_OR_TRUNCATED_DATA wird generiert, falls die Audiodaten fehlerhaft sind.

ALUT_ERROR_INVALID_OPERATION wird generiert, sofern ALUT nicht initialisiert wurde. (Siehe alutInit.)

ALUT_ERROR_NO_CURRENT_CONTEXT wird generiert, wenn es keinen aktuellen AL-Kontext gibt. (Siehe auch alcGetCurrentContext.)

ALUT_ERROR_OUT_OF_MEMORY wird generiert, falls nicht genügend Speicher 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 das Audioformat nicht unterstützt wird.


Zugehörige Wertrückgaben

alutGetMIMETypes mit Token ALUT_LOADER_MEMORY gibt eine Liste der unterstützten Audioformate zurück.


Siehe auch

alutCreateBufferFromFile, alutCreateBufferFromFileImage, alutLoadMemoryFromFile