home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / compress / packers / decrunchers / decrunchers.doc < prev    next >
Text File  |  1995-02-27  |  6KB  |  121 lines
  1. DeCrunchers - English Manual
  2.  
  3. MOTIVATION
  4. Decrunch this old cool demos wasting their time in your overloaded disk-box
  5. and  rip  the music, gfx and mybe the code from them, even on an Amiga with
  6. Kick 2.04 and 68020 or more...
  7.  
  8.  
  9. DISCLAIMER
  10. The  author  cannot  be held liable for the suitability or accuracy of this
  11. manual  and/or  the  program(s)  it  describes.   Any  damage  directly  or
  12. indirectly caused by the use or misuse of this manual and/or the program it
  13. describes is the sole responsibility of the user her/him self.
  14.  
  15. NAMES
  16. DeBytekiller
  17. DeTetragon
  18.  
  19. SYNOPSIS
  20. DeBytekiller <filename/s>
  21. DeTetragon <filename/s>
  22.  
  23. DESCRIPTION
  24. DeBytekiller   and   DeTetragon   are  command  line  decruncher  utilities
  25. especially  designed  for  use  with  file  manipulating  gui tools as SID,
  26. Directory Opus or anything similar that is able to understand file-classes.
  27. But  they  can  of course also be used in a normal shell-environment.  They
  28. were  made  to  enable  you  to  decrunch programs (usually demos) that are
  29. crunched  with  the  Bytekiller  V2.0  cruncher  or  the  Tetragon Cruncher
  30. V2.2(norm).   Programs  crunched by this tools depend on absolute addresses
  31. and  are  in no way designed to work well on a multitasking enviroment such
  32. as  the  amiga-operating  system  is.   It is quite dangerous to start this
  33. programs  on  any  Amiga-Workbench  driven system and not to get in serious
  34. trouble   with   system-shutdowns,   because   of   the   illegal  absolute
  35. mem-adressing  used  by the decruncher.  So I decided to write a tool which
  36. decrunches these files in a safe way, to get them back in raw-format.  This
  37. is  e.g.   useful  for  people  who want to rip music-mod files or gfx from
  38. these programs, or just to read the long scroll texts of demos to the end.
  39.  
  40. WARNING
  41. This  programs  are in no way designed to violate the rights of any kind of
  42. copyrighted software.  Be careful with the use of this tools on any kind of
  43. soft  where  you  expect to give parts of the developed raw file to anybody
  44. else.   Usually  demos  aren`t copyrighted in this way, but it could offend
  45. the  people  who  worked hours and hours on this treasures if you will send
  46. the modules, gfx and maybe the resourced code of their software through the
  47. world.  I (the programer of this tools) could in no way be made responsible
  48. for the misuse of this tools!
  49.  
  50. SYSTEM REQUIREMENTS
  51. DeBytekiller  and  DeTetragon  will  run  on any Amiga system with at least
  52. 512KB  RAM , one diskdrive and OS 2.04.  But if you want to decrunch bigger
  53. files  it  is  responsible  to have more memory, because the source and the
  54. destination  must  be  held  together in the mem while decrunching.  Due to
  55. modifications to the decrunch routines it is even possible to run the tools
  56. on  any  processor  platform,  where the original routine fails.  They were
  57. tested on an A500, A3000 and A4000/40 without any problems occurring.
  58.  
  59. USAGE
  60. From shell:
  61. Select  the  file  you  want to decrunch by snooping through it with a file
  62. examiner tool or try it simply out.  Make sure you have enough space on the
  63. device where the the file xxx to decrunch is stored, because the tools will
  64. store  the  raw  data in the same directory with the extension xxx.raw.  If
  65. xxx.raw  already  exists, you will get an error-message and nothing will be
  66. stored.
  67.  
  68. From other gui-driven directory-tools:
  69. This  depends  heavily  on the tools you use.  But I think there will be no
  70. difficulties  to develop a file class for autodetecting Bytekiller V2.0 and
  71. Tetragon  V2.2n  crunched  files,  if  you  are experienced with using this
  72. tools.   A  look  in  the  source  code  will help, if you want to know the
  73. characteristics of the filetypes.
  74.  
  75. KNOWN DIFFICULTIES
  76. The  filetype  checking  especially  of  the  DeBytekiller tool is not that
  77. perfect as it could be, because of lacking of too much characteristic bytes
  78. in  the  decrunch  header.   So it could be that the decruncher will know a
  79. file  as a Bytekiller crunched file where there isn`t one.  But that didn`t
  80. happen  to  me while I am decrunching more than 100 old demos, but maybe it
  81. could be....
  82.  
  83. FUTURE MOTIVATION
  84. If  you think there exists interest in the support of multitasking friendly
  85. decrunchers  for other "famous" absolute-adress based crunchers used by the
  86. demo-scene,  or if you recognize any difficulties by the use of this little
  87. tools,  then you should contact me as soon as possible.  Maybe, I decide to
  88. write  a  file  recognizing  tool  that automatically decrunches files with
  89. known filetypes.
  90.  
  91. HISTORY
  92.     DeBytekiller 1.0 
  93.     DeTetragon 1.0
  94.     - first and hopefully last public Release
  95.  
  96. COPYRIGHT
  97. DeBytekiller  and DeTetragon are Copyright 1993 by Jürgen Lang.  All rights
  98. reserved.   These  programs  are  FREEWARE,  so  no financial donations are
  99. required  (but  welcome).  These programs may be freely distributed as long
  100. as  all  documentation  and executable(s) remain unchanged and are included
  101. with  the  distribution.   Also  no  profit  is to be made by selling these
  102. programs.   They must not be added to other PD-libraries than AmigaLibDisks
  103. from  Fred  Fish  without my written permission.  The price must not exceed
  104. the costs of disk, package and mailing.
  105.  
  106. NOTES
  107. Directory Opus is copyright by INOVATRONICS and Jonathan Potter
  108. SID is copyright by Timm Martin
  109. SAS is copyright by SAS Institute, Inc, Cary, NC
  110.  
  111. Bug  reports,  suggestions,  postcards,  flames,  criticism, contributions,
  112. ideas, gifts, etc., etc., etc...........  go to the author!
  113.  
  114. AUTHOR
  115.     Jürgen Lang
  116.     Hinter der Mühle 4
  117.     6107-Reinheim 1
  118.  
  119.     InterNet: chess@rbhp57.rgb.informatik.th-darmstadt.de
  120.     FidoNet:  Jürgen Lang@2:247/4.8
  121.