CatchModule()

Syntax

Ergebnis = CatchModule(#Modul, Speicheradresse, Groesse)

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

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

ModPlug unterstützt eine Menge an 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 Module mit in das Executable gepackt werden. Verwenden Sie diese Option trotzdem mit Bedacht, da mehr Speicher als beim Speichern des 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:

  CatchModule(0, ?Module, ?ModuleEnd-?Module)
  End

  DataSection
    Module: 
      IncludeBinary "Module.xm"
    ModuleEnd:
  EndDataSection

Unterstützte OS

Alle