alutLoadMemoryHelloWorld: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: = alutLoadMemoryHelloWorld = == Name == '''alutLoadMemoryHelloWorld''' - Lädt einen "Hello, world!"-Sound in den Speicher. == Delphi-Spezifikation == function '...)
 
(kein Unterschied)

Aktuelle Version vom 6. Mai 2008, 15:55 Uhr

alutLoadMemoryHelloWorld

Name

alutLoadMemoryHelloWorld - Lädt einen "Hello, world!"-Sound in den Speicher.


Delphi-Spezifikation

function alutLoadMemoryHelloWorld(format: PALenum; size: PALsizei; frequency: PALfloat): PALvoid;


Parameter

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 alutLoadMemoryHelloWorld lädt die Audiodaten, wie jemand "Hello, world!" sagt, in einen neu angelegten Puffer. Es ist sichergestellt, dass Audiodaten in einem Standardformat der OpenAL vorliegen und eine von der ALUT-Implementierung bestimmte Samplefrequenz haben. Bei Erfolg gibt die Funktion einen Zeiger auf den neu angelegten Speicherbereich zurück, welcher die Audiodaten enthält. 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.

Alternativ kann man auch die Funktion alutCreateBufferHelloWorld benutzen, welche einen entsprechenden Sound gleich in einen AL-Puffer lädt.


Fehlermeldungen

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

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

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

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

ALUT_ERROR_OUT_OF_MEMORY wird generiert, wenn nicht genügend Speicher zur Verfügung steht.


Siehe auch

alutCreateBufferHelloWorld