CatchModule()

Syntaxe

Resultat = CatchModule(#Module, *AdresseMemoire, Longueur)

Charge le #Module situé à l'adresse mémoire spécifiée. Si #PB_Any est utilisé pour le paramètre '#Module', le numéro du nouveau module sera renvoyé dans 'Resultat'. Si 'Resultat' est 0 alors le chargement a échoué, sinon le module est prêt à être joué avec la commande PlayModule(). Si le #Module était déjà créé, il est automatiquement supprimé et remplacé par le nouveau.

ModPlug supporte de nombreux formats de modules, parmi lesquels: Protracker (4 canaux), FastTracker (plus de 32 canaux, qualité 16-bit), Impulse Tracker, etc.

Cette commande est utile pour inclure des modules directement dans l'exécutable avec la commande IncludeBinary. Néanmoins, n'abusez pas de cette fonctionnalité car un module inclus dans un exécutable consomme automatiquement de la mémoire supplémentaire (car tout l'exécutable, y compris les modules, sont chargés en mémoire).

Exemple

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

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

OS Supportés

Tous