CatchMusic()

Syntax

Ergebnis = CatchMusic(#Musik, Speicheradresse, Groesse)

Lädt das angegebene Musik-Modul vom angegebenen Speicherbereich. Wenn #PB_Any als '#Musik' Parameter verwendet wird, dann wird die Nummer des neuen Musik-Moduls als 'Ergebnis' zurückgegeben.

Ist 'Ergebnis' ungleich 0, wurde das Musik-Modul korrekt geladen und ist bereit zum Abspielen mittels PlayMusic(). Andernfalls ist das Laden des Moduls fehlgeschlagen. Wenn zuvor ein anderes Musik-Modul mit der gleichen #Musik Nummer geladen wurde, dann wird dieses vorherige Musik-Modul automatisch freigegeben.

ModPlug unterstützt eine Menge an Musik-Modul-Formaten, zu diesen gehören: Protracker (4 Kanäle), FastTracker (bis zu 32 Kanäle, 16 Bit-Qualität), Impulse Tracker, etc.

Diese Funktion ist nützlich bei Verwendung des 'IncludeBinary' PureBasic Schlüsselworts. Damit können Musik-Module mit in das Executable gepackt werden. Verwenden Sie diese Option trotzdem mit Bedacht, da mehr Speicher als beim Speichern des Musik-Moduls in einer externen Datei benötigt wird (das Modul befindet sich sowohl im Speicher des Executable und wird auch in den physikalischen Speicher geladen).

Beispiel:

  CatchMusic(0, ?Music, ?MusicEnd-?Music)
  End

  DataSection
    Music: 
      IncludeBinary "Music.xm"
    MusicEnd:
  EndDataSection

Unterstützte OS

Alle