Flash: /* Delphi-Spezifikation */

2008-04-23T12:39:48Z

‎Delphi-Spezifikation

Thoronador: Die Seite wurde neu angelegt: = alutLoadMemoryFromFile = == Name == '''alutLoadMemoryFromFile''' - Lädt eine Audiodatei in den Speicher. == Delphi-Spezifikation == function '''alutLoadMemory...

2008-04-21T13:30:07Z

Die Seite wurde neu angelegt: = alutLoadMemoryFromFile = == Name == '''alutLoadMemoryFromFile''' - Lädt eine Audiodatei in den Speicher. == Delphi-Spezifikation == function '''alutLoadMemory...

Neue Seite

= alutLoadMemoryFromFile =

== Name ==
'''alutLoadMemoryFromFile''' - Lädt eine Audiodatei in den Speicher.

== Delphi-Spezifikation ==
function '''alutLoadMemoryFromFile'''(const ''filename'': PChar; ''format'': PALenum; ''size'': PALsizei; ''frequency'': PALfloat): PALvoid;

== Parameter ==

{| border="1" rules="all"
! ''filename''
| Zeiger auf einen [[Null-terminiert|nullterminierten]] String, welcher den Namen der Audiodatei enthält
|-
! ''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 '''alutLoadMemoryFromFile''' versucht, das Audiodatenformat anhand des Dateinamens und/oder des Dateiinhaltes zu bestimmen und lädt die Audiodaten in einen neu angelegten Puffer, wobei die Daten möglicherweise konvertiert werden. Es wird garantiert, dass das Format nachher ein Standardformat von [[OpenAL]] ist. Im Erfolgsfall gibt die Funktion einen Zeiger auf den neu angelegten Speicherbereich zurück, der die Audiodaten enthält. Der Speicherbereich kann von der Anwendung freigegeben werden, sobald die darin enthaltenen Daten nicht mehr benötigt werden. Bei Fehlschlag ist der Rückgabewert '''nil'''. Sollten eines oder mehrere der Parameter ''format'', ''size'' oder ''frequency'' kein '''nil'''-Zeiger sein, so wird die entsprechende Information über die Audiodaten in den referenzierten Variablen 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, falls beim Aufruf der Funktion schon ein ALC-Fehlerstatus gesetzt war. (Siehe [[alcGetError]].)

'''ALUT_ERROR_CORRUPT_OR_TRUNCATED_DATA''' wird generiert, wenn die Audiodaten fehlerhaft sind.

'''ALUT_ERROR_INVALID_OPERATION''' wird generiert, falls [[ALUT]] nicht initialisiert wurde.

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

'''ALUT_ERROR_NO_CURRENT_CONTEXT''' wird generiert, falls es keinen aktuellen AL-Kontext gibt. (Siehe auch [[alcGetCurrentContext]].)

'''ALUT_ERROR_OUT_OF_MEMORY''' wird generiert, wenn nicht genügend Speicher vorhanden ist.

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

'''ALUT_ERROR_UNSUPPORTED_FILE_TYPE''' wird generiert, sofern der Dateityp der durch ''filename'' angegebenen Datei 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]], [[alutLoadMemoryFromFileImage]]

[[Kategorie:ALUT|LoadMemoryFromFile]]

@@ Zeile 9: / Zeile 9: @@
 == Delphi-Spezifikation ==
-  function '''alutLoadMemoryFromFile'''(const ''filename'': PChar; ''format'': PALenum; ''size'': PALsizei; ''frequency'': PALfloat): PALvoid;
+  function '''alutLoadMemoryFromFile'''(const ''filename'': PChar; ''format'': PALenum;
+                                 ''size'': PALsizei;
+                                 ''frequency'': PALfloat): PALvoid;
 == Parameter ==

alutLoadMemoryFromFile - Versionsgeschichte

Flash: /* Delphi-Spezifikation */

Thoronador: Die Seite wurde neu angelegt: = alutLoadMemoryFromFile = == Name == '''alutLoadMemoryFromFile''' - Lädt eine Audiodatei in den Speicher. == Delphi-Spezifikation == function '''alutLoadMemory...