home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / trackhack / !TrackHack / !Help < prev    next >
Encoding:
Text File  |  1994-12-11  |  10.9 KB  |  230 lines
  1. Track Hack version 2.12 by Chris Coe
  2. ====================================
  3.  
  4. There are track rippers and there are track rippers. And then there's Track
  5. Hack. Here are some of the things Track Hack can do:
  6.  
  7.    * Extract Coconizer, STModule, ProTracker, STracker, TeqMusic and Symphony
  8.      files concealed in code.
  9.    * Scan one file or a whole game / demo.
  10.    * When scanning whole directories, check for real music files (those that
  11.      are not concealed) in every type above.
  12.    * Decompress programs that have been compressed with LZW (such as the
  13.      RiscDream megademo, Nirvana, BlackZone etc. etc.).
  14.  
  15. Using Track Hack is simplicity itself. Double-click on the !TrackHack icon
  16. and the application will install itself on the icon bar. The only button that
  17. works is MENU (the middle button), and this brings up a menu consisting of
  18. the usual Info/Quit options, plus a tickable option, Decompress. More about
  19. this later. For now, find a game or demo etc. that you want to rip the music
  20. out of and drag it to the Track Hack icon on the icon bar. A progress report
  21. window will open and will give you a running commentary as Track Hack scans
  22. through every file for every music format it recognizes. If a track is found,
  23. the scan will pause and a save box will pop up for you to drag to a filer
  24. window. Click on 'Cancel' if you do not wish to save that particular track,
  25. and the scan will continue. Occasionally, Track Hack will pick up a tune that
  26. isn't really a tune at all, and for this reason the track name is displayed
  27. in the progress report window. If it is a load of gibberish then you can be
  28. pretty sure it isn't a tune, and you would be strongly recommended to click
  29. on the 'Cancel' icon of the save box. Some applications have the music in a
  30. separate file - you can normally just copy these straight out of the
  31. application directory - but you don't need to bother any more as Track Hack
  32. will pick these up too, so every time you get a new program, all you need to
  33. do is run it through Track Hack and it'll root out the music however it's
  34. stored.
  35.  
  36. There is only one complication to all this. Many demos these days (especially
  37. the multi-part ones) are compressed so that you can get more graphics etc.
  38. onto one disk. This means that before you can scan for any music, the file
  39. has to be decompressed. To do this, choose the Decompress option on the Track
  40. Hack menu. Unfortunately, the compressed files don't have any set filetype,
  41. so there is no easy way for Track Hack to tell if a file should be
  42. decompressed or not. As it stands, only files with a first byte of zero and a
  43. second byte non-zero are decompressed (the compressed files always start with
  44. a zero, then a non-zero byte). This means that if you drag a whole
  45. application to the icon bar, any files not meeting this creteria will be
  46. loaded as usual, and any that do will be decompressed. While this rules out
  47. things like Text and Obey files which obviously won't be compressed, it is a
  48. dodgy method and can fail occasionally and CAUSE THE COMPUTER TO CRASH.
  49. Unfortunately, there isn't much I can do about that.
  50.  
  51. PROBLEMS
  52. --------
  53.  
  54. ==========> 1
  55.  
  56. Occasionally, Track Hack may be fooled into thinking that it has found a
  57. music track when in fact it hasn't. This problem is particularly noticeable
  58. with Tracker files. If this happens, one of two results may occur:
  59.  
  60. 1) You attempt to save the track but the computer returns a 'no readable
  61.    memory at this address' error.
  62. 2) The track is saved successfully, but when you attempt to load it into
  63.    another program, it returns a strange error.
  64.  
  65. Unfortunately, there is a balance between making the checking too harsh and
  66. missing some legitimate music, and making it too leniant and picking up all
  67. sorts of rubbish. There WILL be the odd track that Track Hack misses, and the
  68. odd one it picks up that isn't a track at all, but that's life, I'm afraid.
  69.  
  70. NB From versions 2.12 onwards this isn't really a problem because you can see
  71. the track name in the progress report window.
  72.  
  73. ==========> 2
  74.  
  75. The three music formats ProTracker, STracker and TeqMusic are identical
  76. except for the way the samples are stored:
  77.  
  78. STracker and TeqMusic use LINEAR samples
  79. ProTracker uses LOGARITHMIC samples
  80.  
  81. (STracker and TeqMusic are the same except for the filetype)
  82.  
  83. Whether the tune found was a ProTracker, STracker or a TeqMusic file, Track
  84. Hack will always use the STracker filetype, for this is by far the most
  85. common and standard type. If however when you try to play back the music, the
  86. samples come out all wrong, there are several things you can do:
  87.  
  88. 1) If your tracker editor/player can read ProTracker music, the best thing
  89.    to do is change the filetype to ProTracker (&701), which is probably what
  90.    the track was originally anyway.
  91. 2) If your tracker editor/player has an option regarding how to load in
  92.    samples on different types of music (such as Digital Symphony does),
  93.    select "8-bit logarithmic" samples.
  94. 3) Get a copy of the PD application !SampConv and convert all the samples
  95.    to linear, or !TrackConv to convert the music to a format you can play.
  96.  
  97. ==========> 3
  98.  
  99. If you are trying to hack files with the decompress option set and a strange
  100. error is returned, there are one of two reasons why:
  101.  
  102. 1) The file is not an LZW file
  103. 2) The decompressed file overflows the available memory
  104.  
  105. The solution is to quit the program, bring up the task manager display and
  106. make the 'Next' slot as large as you can. This determines how much memory the
  107. next task loaded will be given. If you now load Track Hack again there will
  108. be much more memory available.
  109. If it works this time, then you just needed more memory. If it still fails,
  110. then you are probably trying to decompress an ordinary file.
  111.  
  112.  
  113. EXAMPLES
  114. --------
  115.  
  116. Just to prove it works, I have successfully extracted tunes from the
  117. following programs:
  118.  
  119. Program                  Tunes ripped                           LZW
  120. -------                  ------------                           ---
  121. Nirvana Megademo         Africa-Tec, OpusDei, Taekkno,          Yes
  122.                          Mega, Tune2
  123. SquoQuo Megademo         Intro, Mountain, Night, OldSchool,     Yes
  124.                          Radio, 3Sc
  125. Premium Verum            FlashDance, Gregorian3, BladSwede      Yes
  126. Counter Act (ArcWorld93) CounterActMus                          No
  127. Xacretan (ArcWorld93)    Prelude                                No
  128. 3DTetris                 DansMusic                              No
  129. 23 Street                Excellent                              No
  130. RiscDream                ArmyBeat, Noel, Robotron2              Yes
  131. Gyrinus 3.5              Song24, Oxygene2, RainyDay             No
  132. Sprog                    [ tunes for every level ]              No
  133. Komackino                Christ-02                              No
  134. Black Zone               Intro tune, HardHouse, Virtual,        Yes
  135.                          HolyTrans, Garbage, HardCor250,
  136.                          Outtro, Recall
  137.  
  138. Those were all CocoTracks. And in the ProTracker department, we have:
  139.  
  140. The Chip Duo Demo 1      MegaForce                              No
  141. AP-Demo 1                20cc                                   No
  142. Crimbo                   Sll3                                   No
  143.  
  144.  
  145. CREDITS
  146. -------
  147.  
  148. !TrackHack  written by Chris Coe       (c) Norsoft Productions 1994
  149. LZWD        written by ???
  150.  
  151. Copy this suite of programs to whoever you want, under the following
  152. conditions:
  153.  
  154. DON'T even think about making a profit. You can use any tunes supplied with
  155. this program separately as they are PD. Supply every file in !TrackHack,
  156. including this !Help file. Do not add, alter or remove any files. You can use
  157. LZWD in your own programs but please credit the author concerned.
  158.  
  159.  
  160. CONTACT
  161. -------
  162.  
  163. If you have problems retrieving a particular tune, or you would like me to
  164. add code to rip out other music formats, tell me! I'm no musician, but I'm a
  165. whizz at pulling programs to pieces. My address is:
  166.  
  167.         Norsoft Productions,
  168.         19, Seton Road,
  169.         Taverham,
  170.         Norwich,
  171.         Norfolk,
  172.         NR8 6QE.
  173.  
  174. (with ArmyBeat in RiscDream for example I had to remove all the J00 commands
  175. from the tune (there were 61 which caused my tracker editor to crash!))
  176. It might be a good idea to include a copy of the program with your letter if
  177. possible.
  178.  
  179.  
  180. History
  181. -------
  182.  
  183. 1.00 - First release version, called !CocoRip, this version could recognize
  184.        only one type of music (Coconizer), LZW decompression was done by
  185.        a separate, non-multi-tasking program, and it could only scan single
  186.        files at a time.
  187. 2.00 - Many changes:
  188.        Improved Coconizer 'spotting' - some programs caused a 'no readable
  189.        memory at this address' error in 1.00 when CocoRip incorrectly
  190.        thought that it had found a track.
  191.        The latest version of my NPLibrary (1.10) is now used, which handles
  192.        Wimp_Poll calls by itself.
  193.        QuickDComp has now been integrated into the main program.
  194.        The program now contains code to rip out STModules and ProTracker
  195.        files, and the name has changed to TrackHack to reflect this.
  196.        The program supports file queueing - you can drag a game or demo to
  197.        the icon and every file will be scanned for every recognized format.
  198.        As well as ripping from code, the program will also spot raw music
  199.        files - CocoTracks, STModules, ProTracks AND Symphonies. This is so
  200.        that the user doesn't have to bother checking an application with
  201.        SHIFT+double-click for real music files as TrackHack will do it for
  202.        them.
  203.        The ProTracker-ripping code has now been extended to cover TeqMusic
  204.        and STracker modules, too.
  205. 2.10 - The program can now rip out Symphony files from within game code as
  206.        well as raw music files - it cannot yet correctly work out the length
  207.        of the track though.
  208.        Bug fixed where filenames with character 160 (hard space) in them
  209.        were chopped incorrectly, causing a 'file not found' error.
  210.        LZW file spotting formula improved - now the first byte must be zero,
  211.        and byte two must be non-zero for decompression to take
  212.        place. This rules out nearly all files.
  213.        WimpSlot command in !Run file altered so that the user can determine
  214.        how much memory the application is given by dragging the Next slot
  215.        (saves manual editing of file).
  216.        NPLibrary version updated to 1.11.
  217.        Abort option added - the user can close the progress window to abort
  218.        the current scan.
  219. 2.11 - Minor change to save box. It used to be transient - it is now
  220.        persistent and comes with an added 'Cancel' icon. This way, you are
  221.        given the chance to open or move obstructing windows away from the
  222.        destination filer window.
  223.        Also a minor change made to the STracker/ProTracker/TeqMusic scanning
  224.        routine which allows tracks with the maximum 20 letter name length to
  225.        be recognized (it used to miss these).
  226.        The tracker routine is often fooled by sprites - any suggestions?
  227. 2.12 - Name of the track is now displayed when the save box appears, so if
  228.        it is a load of gibberish you can be pretty sure it isn't a real tune.
  229.        Very handy!
  230.