CatchSound()

Syntax

Ergebnis = CatchSound(#Sound, *Puffer [, Größe [, Flags]])

Lädt einen WAV-Sound (im PCM-Format, ADPCM wird nicht unterstützt) oder jedes andere von der SoundPlugin Bibliothek unterstützte Format, der sich an der angegebenen Speicheradresse befindet.

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

UseFLACSoundDecoder()
UseOGGSoundDecoder()

Parameter

#Sound	Eine Nummer zum Identifizieren des neuen Sounds. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
*Puffer	Der für das Erstellen des Sounds zu verwendende Puffer. Dies ist eine reguläre Speicher-Adresse.
Größe (optional)	Die Puffer-Größe (in Bytes). Bei WAV-Dateien muss dieser Parameter nicht angegeben werden. Bei Verwendung anderer Sound-Decoder muss er angegeben werden.
Flags (optional)	Dies kann der folgende Wert 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)

Rückgabewert

Ein Wert ungleich Null, wenn der Sound erfolgreich erstellt wurde, andernfalls Null.

Beispiel

  CatchSound(0, ?Music)
  End

  DataSection
    Music:
      IncludeBinary "Sound.wav"

Anmerkungen

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

Siehe auch

LoadSound(), FreeSound(), PlaySound()

Unterstützte OS

Alle