home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaMiscModsCD3.iso / _PROGRAMME / TOOLS / ModuleInfo0_98.lha / ModuleInfo / ModuleInfo.doc < prev    next >
Encoding:
Text File  |  1996-06-03  |  6.7 KB  |  168 lines
  1. ---------------------------------------------------------------------------
  2.                             ModuleInfo 0.98                       03-Jun-96
  3. ---------------------------------------------------------------------------
  4.  
  5. Introduction
  6. ~~~~~~~~~~~~
  7. ModuleInfo is a small program that will help you to change the songname,
  8. and instrument names of a ST/NT/PT-Module.
  9.  
  10. I programmed this small utility because I was changing the instrument
  11. names in lots of modules, and I'm too lazy to do it all by hand..
  12.  
  13. You can of course change these things by loading the module into ProTracker,
  14. but it's much easier with ModuleInfo.
  15.  
  16. ModuleInfo also has support for unpack.library by SHI (included), so you
  17. can load a lot of kinds of packed modules without having to decrunch them
  18. by hand.
  19.  
  20. ModuleInfo can also use ptreplay.library for playing modules from version
  21. 0.92ß and on.
  22.  
  23. I'm currently doing my military duty, so I do not have as much time to
  24. program as I would like. (That's why this version delayed for several
  25. months..)
  26.  
  27. Disclaimer
  28. ~~~~~~~~~~
  29. THIS SOFTWARE AND INFORMATION IS PROVIDED "AS IS". NO REPRESENTATIONS OR
  30. WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY, RELIABILITY, PERFORMANCE,
  31. CURRENTNESS, OR OPERATION OF THIS SOFTWARE AND INFORMATION, AND ALL USE IS
  32. AT YOUR OWN RISK. THE AUTHOR DOES NOT ASSUME ANY RESPONSIBILITY OR LIABILITY
  33. WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE AND INFORMATION.
  34.  
  35. Copyright
  36. ~~~~~~~~~
  37. This program is FREEWARE. It may be freely distributed as long as all files
  38. in it remain unchanged and are included in the distribution. Also no more
  39. than a nominal copy fee may be charged for the distribution. This program
  40. cannot be used for commercial purposes without written permission from the
  41. author.
  42.  
  43. Installing
  44. ~~~~~~~~~~
  45. Copy these libraries to LIBS:
  46.  
  47. gadutil.library   -  This is required by the program.
  48.  
  49. unpack.library    -  This is not required, but if you have this, the program
  50.                      will be able to decrunch the modules.
  51.  
  52. ptreplay.library  -  This isn't either required, but if you have this, the
  53.                      program will be able to play the modules.
  54.  
  55. The most recent versions of the libraries that I currently have, has been
  56. incuded. This is just because I do not like to get a new program that I
  57. can't use, just because I had not the right version of the libraries that
  58. the program needed.
  59.  
  60. Function
  61. ~~~~~~~~
  62. I programmed ModuleInfo because I wanted an easier way to change the sample/
  63. song-names of an ST/NT/PT-module.
  64.  
  65. This could be done with a hex-editor, but then there's always a risk that you
  66. edit something that you shouldn't have edited.
  67.  
  68. Why I wanted to change the modulenames was:
  69.  
  70. In lots of old modules, the author has written his name in a way that is not
  71. standard for the author name. So those programs that recognise the name will
  72. not work.
  73.  
  74. The standard way of doing this is to use the #-sign, followed by the name of
  75. the author, as the first samplename.
  76.  
  77. Like this:
  78.  
  79. 1: #Heatbeat / Carillon         ; This is the name of the author
  80. 2:                              ; These other sample names
  81. 3: This beat was composed       ; can be used for other comments,
  82. 4: in january 1995.             ; like this.
  83.  
  84. The program will also load packed modules, so there's no need to decrunch
  85. these modules before loading.
  86.  
  87. Here comes the description over the gadgets that's in the window, as you can
  88. see, all gadgets have hotkeys (controlled by gadutil.library!).
  89.  
  90. Gadget   Hotkey Description
  91. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  92. Name:           This shows the name of the module (filename)
  93. Requester:  l   This brings up a file-requester (load file).
  94. Save:       s   Saves the file. You can select another name if you like.
  95. About:      a   An about requester..
  96. Song Name:  n   The real name of the song. (The name that's in the module).
  97. Play:       p   If you have ptreplay.library in libs:, then this gadget will
  98.                 be enabled. It allows you to play (PT) modules. If the module
  99.                 you try to load is not a PT module, then this gadget will be
  100.                 disabled, ModuleInfo will allow you to load it anyway, just
  101.                 in case that the module names can be edited anyway. If you do
  102.                 not have enough chip-mem for module, it will be loaded into
  103.                 fastmem instead, but the Play gadget will be disabled.
  104.  
  105. The rest of the gadgets are for the sample names.
  106.  
  107.  
  108. Usage
  109. ~~~~~
  110. An example:
  111.  
  112. 1) Start the program ;)
  113. 2) Click on the requester gadget (the one to the right of the name gadget.
  114. 3) Select a module to load
  115. 4) Change the samplenames / songname.
  116. 5) Select Save
  117. 6) Choose a name for the module
  118.  
  119.  
  120. If you load something that's not a module, or the module can't be decrunched,
  121. the sample names will look strange. If this happens, don't save the module.
  122. If the loaded file is a ST/NT/PT-module that's packed with some kind of
  123. unknown packer, use a decrunch program for that cruncher to decrunch it.
  124.  
  125. If the module can't be decrunched, another probable cause is that you don't
  126. have the unpack.library installed.
  127.  
  128. If the file is not a module, just load a real module...
  129.  
  130.  
  131. History:
  132. ~~~~~~~~
  133. 0.8   (21-May-1995) - First release.
  134. 0.9ß  (31-Oct-1995) - Internal beta version. Tried with different PT-replay
  135.                       routines, but none of them were good enough.
  136. 0.91ß (31-Oct-1995) - Started testing with ptreplay.library.
  137. 0.92ß (01-Nov-1995) - PTreplay.library works just fine by now, the problems
  138.                       I had earlier was caused by unpack.library (didn't
  139.                       unpack to chipmem), but I did a simple routine that
  140.                       cares about that, it's a bit memory expensive though,
  141.                       but I'll have that fixed 'till version 1.0.
  142. 0.93ß (02-Nov-1995) - Minor fixes. beta testing.
  143. 0.94ß (02-Nov-1995) - Minor fix.
  144. 0.95ß (02-Nov-1995) - Added checking for PT-modules. Ability to load even
  145.                       if the file is not a PT-module, but with the
  146.                       restriction that you can't play it.
  147. 0.96ß (05-Nov-1995) - A lot of minor bugfixes and minor additions.
  148. 0.97  (05-Nov-1995) - Yeah!. Now it seems to work just as it should.
  149.                       Added hotkey to load gadget too, so now all gadgets
  150.                       that should have hotkeys have it!.
  151.  
  152. 0.98  (03-Jun-1996) - Fixed a little bug that could only be seen if you had
  153.                       the new version of unpack.library.
  154.  
  155.  
  156.  
  157.     Send bug reports, ideas, PD Programs etc. to:
  158.  
  159.                      \|/
  160.                      @ @
  161.   .--------------oOO-(_)-OOo--------------------------.
  162.  / Staffan Hämälä           Email: staham@pluggnet.se  \
  163. (  Pellovägen 268           Tel: (+46) 927-22158        )
  164. |  S-957 93 Pello           'C' & Assembler programmer  |
  165. |  SWEDEN                   Amiga 3000/25MHz/10MB/1.4GB |
  166. !_______________________________________________________!
  167.                   (__) (__)
  168.