CatchSound()

Syntax

Ergebnis = CatchSound(#Sound, Speicheradresse [, Länge [, Flags]])

Lädt einen WAV Sound oder jedes andere von der SoundPlugin Library unterstützte Format, das sich an der angegebenen Speicheradresse befindet.

Wenn #PB_Any als '#Sound' Parameter verwendet wird, dann wird die Nummer des neuen Sounds als 'Ergebnis' zurückgegeben.

Ist das 'Ergebnis' ungleich 0, wurde der Sound korrekt geladen und ist bereit zum Abspielen mittels dem Befehl PlaySound(), andernfalls ist das Laden des Sounds fehlgeschlagen.

Bei WAV-Dateien muss der 'Länge' Parameter nicht angegeben werden.

Die folgenden Funktionen können verwendet werden, um automatisch mehr Sound-Formate zu aktivieren:

UseFLACSoundDecoder(): der Parameter 'Länge' muss angegeben werden
UseOGGSoundDecoder(): der Parameter 'Länge' muss angegeben werden

Der optionale 'Flags' Parameter kann eine Kombination der folgenden Werte sein:

  #PB_Sound_Streaming: Aktiviert "Streaming Playback" - einem System zum gleichzeitigen 
           Laden und Abspielen, wodurch nicht erst die gesamte Sound-Datei in den Speicher
           geladen werden muss (nur unterstützt für FLAC und OGG)

Beispiel:

  CatchSound(0, ?Music)
  End

  DataSection
    Music: IncludeBinary "Sound.wav"

Hinweis: Das "?" ist ein Zeiger auf eine Sprungmarke. Weitere Informationen über Zeiger und Speicherzugriff finden Sie im zugehörigen Kapitel hier.

Unterstützte OS

Alle