home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Misc / ModuleMaster1,0.LHA / Documents / ModuleMaster.Doc < prev   
Encoding:
Text File  |  1994-09-29  |  8.2 KB  |  221 lines
  1.       .....:::::        .......           ...................  .....
  2.      ::::: ::::: ::::: :::: ...... ::::: ::::::::   .....::::: :::::
  3.      ::::: ::::: ::::: ::::. ::::: ::::: ::::::::  ::::: ::::: :::::
  4.      ::::: ::::: ::::: ::::: ::::: ::::: ::::::::  ::::: ::::: ::::: :::::
  5.      ::::: ::::: ::::: ::::: ::::: ::::: ::::::::  ::::: ::::: ::::: :::::
  6.      ::::: ::::: ::::: ::::: ::::: ::::: ::::::::  ::::: ::::: ::::: :::::
  7.      ::::: ::::: ::::: ::::: ::::: ::::: ::::::::  ::::: ::::: ::::: :::::
  8.     .::::: ::::: ::::: ::::: ::::: ::::: ::::::::  ::::: ::::: ::::: :::::.
  9.          `-'     :::::     `-'     :::::               `-'         `-'
  10.  
  11.    - -- ------------------ -- -  present  - -- ------------------------ -- -
  12.  
  13.                          The Module Master v1.0
  14.                          ----------------------
  15.  
  16. Author        : Chip-Ram / Digital
  17. Typ        : Tool / Editor
  18. Status        : Public Domain
  19. Requirements    : OS2.x/3.x , 512kb & ReqTools.library v38 (included!)
  20.  
  21.  
  22. Chapter 1:               About The Module Master
  23. ------------------------------------------------
  24.  
  25.     
  26.     1. What is The Module Master ?
  27.     ------------------------------
  28.  
  29.     Module Master (MM from now on) is a simple OS2.x/3.x gui-driven
  30.     editor tool, which makes editing sample- and filenamestrings
  31.     of standard Sound/Noise/Protracker-Modules an easy task.
  32.     Originally I wrote this tool only for my own, because I am
  33.     collecting modules since 6 months and I often have to edit a
  34.     module, because of corrupt samplestrings or missing composer-
  35.     names.
  36.     Moreover I often get modules which have differences in the
  37.     filename and the in-module stored modulename and so I always 
  38.     had to load such a module into Protracker to fix this.
  39.     Well, this is why MM was coded. 
  40.     You can easily select a module, edit both the sample- and module-
  41.     names or just rename the filename on disk to the name stored in
  42.     the module.
  43.  
  44.     MM is not meant to break the tools-charts, either use it or drop it!
  45.  
  46.     2. Who should use it ?
  47.     ----------------------
  48.  
  49.     Well, MM is aimly dedicated to all people, who collect modules
  50.     and want to own a tidy and well-sorted collection. 
  51.     Here MM is a really must, because it is the only way to edit hugh
  52.     amounts of modules in a short period of time.
  53.     Useful or not, decide on your own! Nobody forces you to use MM!
  54.  
  55. Chapter 2:              How to use The Module Master
  56. -----------------------------------------------------
  57.  
  58.     1. [Load Moduleheader] & [Save Moduleheader] - gadgets
  59.     ------------------------------------------------------
  60.  
  61.     Well, usage of MM is really simple.
  62.  
  63.     Click the [Load Moduleheader] - gadget and select any module.
  64.     MM will check out, whether it is a module (checks for M.K.) or not.
  65.     If not, you can confirm editing the desired module, but be sure you
  66.     are editing a real module.
  67.  
  68.     NOTE: MM accepts only PT-modules without any errorrequester.
  69.           That's because I only check for the M.K.-mark.
  70.           If you have an old ST-module or StarTrekker-module, you can
  71.           force MM continuing by confirming the requester.
  72.  
  73.     Next MM checks whether the module is powerpacked or not.
  74.     At the current version of MM powerpacked modules will not be accepted
  75.     and so MM aborts loading.
  76.  
  77.     If there has not occured any error, you will find the stringgadgets
  78.     filled with the samplestrings and the modulename below them.
  79.     The filename will be shown on the right side in the [Filename]-field.
  80.  
  81.     Now you can start editing samplestrings by simply clicking into the
  82.     stringgadgets and start typing your changes. Same with the modulename.
  83.     If you want saving your changes, just click the [Save Moduleheader]-
  84.     gadget and confirm the appearing requester. That's all.
  85.  
  86.     2. [Modulename -> Filename] - gadget
  87.     ------------------------------------
  88.  
  89.     In case the filename differs from the modulename, you can replace both
  90.     the filename by the modulename and the modulename by the filename.
  91.  
  92.     Clicking the [Modulename -> Filename] gadget will simply rename the
  93.     file on disk by the in-module stored name, i.e. :
  94.  
  95.     Modulename : biomechanoid
  96.     Filename   : mod.module_by_groo
  97.  
  98.     Clicking the [Modulename -> Filename] gadget will rename the file
  99.     'mod.module_by_groo' to 'mod.biomechanoid'. That's all.
  100.  
  101.     NOTE: Clicking the [Modulename  ->  Filename] gadget will NOT change
  102.           anything IN the module. It will simply rename a file on disk.
  103.           So it is not necessary to click the [Save Moduleheader] gadget
  104.           to keep these changes!!
  105.  
  106.  
  107.     3. [Filename -> Modulename] - gadget
  108.     ------------------------------------
  109.  
  110.     Clicking the [Filename -> Modulename] gadget will copy the filename
  111.     supplied by the filerequester directly into the module.
  112.     The 'mod.'-prefix will be cut out automatically. This is useful, when
  113.     you get a module, which has a correct filename but holds a wrong 
  114.     modulename inside its header.
  115.  
  116.     Again a little example:
  117.  
  118.     Modulename : _yyþ_______x_Dd_ (should indicate any crap in the header!)
  119.     Filename   : mod.elysion
  120.  
  121.     Clicking the [Filename -> Modulename] gadget will replace the crap in
  122.     the moduleheader by 'elysion'.
  123.     After saving the moduleheader and loading this module into any tracker
  124.     you will notice the correct modulename in the moduleheader.
  125.  
  126.     NOTE: Because of the fact, that some text is copied into the module-
  127.           header, you HAVE to click the [Save Moduleheader] gadget to keep
  128.           these changes in future!
  129.  
  130.  
  131. Chapter 3:                      General informations
  132. ----------------------------------------------------
  133.  
  134.     1. Public Domain notice
  135.     -----------------------
  136.  
  137.     MM is public domain. This means you can copy and spread it as much
  138.     as you want. No profit may be made out of it by any pd-library sel-
  139.     ling any version of MM.
  140.     
  141.     2. Future changes
  142.     -----------------
  143.  
  144.     This is version 1.0 of MM, so there are not that much functions
  145.     included yet.
  146.     In future version, you will find even more functions i.e. the 
  147.     possibility of inserting a bbs-banner. Furthermore powerpacker
  148.     will be supported. This means the selected module will be unpacked,
  149.     edited and packed with the same ratio it was packed before.
  150.  
  151.     Future versions will get a preferences editor, so you can create your
  152.     own batchpatterns i.e. replacing modulename by filename in all selected
  153.     files without clicking the same gadgets again and again.
  154.     MM will be enabled to act from CLI, too.
  155.     Furthermore you will get the possibilty to save the moduleheader with
  156.     strings upper/lower-cased.
  157.  
  158.     Version 2.0 will enable you to edit a mask of what strings should be
  159.     removed or be replaced,    i.e. : 
  160.     You want to remove the string 'converted with prowizard' in any
  161.     selected modules.
  162.     
  163. Chapter 4:                            At the end
  164. -------------------------------------------------
  165.  
  166.     1. The credits
  167.     --------------
  168.  
  169.     The Module Master V1.0 was coded by Chip-Ram of Digital.
  170.     The icon spread with Module Master V1.0 was found in a 500 wb-icons
  171.     archive, so I think it's pd, too.
  172.     ReqTools.library was coded by Nico François.
  173.  
  174.     2. The author
  175.     -------------
  176.  
  177.     Send bug-reports to me at this address :
  178.              Also for module & demoswapping
  179.  
  180.                         Chip-Ram
  181.                    ------------------
  182.                    Jens         Georg
  183.                    Ostpreußenweg   11
  184.                    58239     Schwerte
  185.                    United     Germany
  186.  
  187.                     +49-(0)230417549
  188.  
  189.       or find me somewhere in internet ....
  190.  
  191.     3. The greetings
  192.     ----------------
  193.  
  194.     First off all I want to thank Touchstone / Essence for his great
  195.     advices and incredible help to get The Module Master V1.0 to that
  196.     what you can find in here.
  197.     Furthermore greetings to my best (and TRUE) friends in scene:
  198.     ----------------------------------------------------------------
  199.  
  200.      - Pride / Stellar
  201.           - Curt Cool / Depth 
  202.        - Rahiem / Digital
  203.         - Gfx-Twins (Cevin) / Digital
  204.        - Flite / Sceptic & Haujobb
  205.       - Jazz / Haujobb
  206.      - Tint / Digital SF
  207.  
  208.     4. FileId.Diz
  209.     -------------
  210.  
  211.          ________    /\_ ______/\_ ___________  ____ 
  212.          \ ______\/\/  /  ____/  /_\ _______ /_/ _ / 
  213.           \//.  /  /  /   /__/  /   /  /_  /  /  //  
  214.           //  /  /  //  /  /  /   /  //     /  ./__ 
  215.          /      /  /.     /  /   /  /   /  /   /  / 
  216.         /____  /__/\_____/__/___/  /___/  /\_____/  
  217.              \/...:::PRESENTS TODAY:::/__/..    Sk!n
  218.         The Module Master v1.0 by Chip-Ram/Digital.
  219.           Easily edit sampletexts and modulenames.
  220.           Requires OS 2.x / 3.x & 640x256p screen.
  221.