home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / a / amigapatchlistv2.0.lha / AmigaPatchList2.0 / ByteKiller / ByteKiller1.3.doc < prev    next >
Text File  |  2000-03-01  |  4KB  |  129 lines
  1.  
  2.  
  3.  
  4.  
  5.                              BYTE-KILLER  v1.3
  6.                              ~~~~~~~~~~~~~~~~~
  7.                              (by Lord Blitter)
  8.  
  9.          Official Dealer    : BAMIGA SECTOR ONE
  10.          Release date       : January, 2th 1988.
  11.  
  12. Changes made: All fixed branches are now relatives (faster - shorter - easier
  13. to work with). A bug in the compression was fixed, thanks to Twilight for 
  14. letting us know it !
  15.  
  16. Changes made: A real cool guy from THE BLIZZARD wrote a great user
  17. interface for your favorite cruncher.
  18.  
  19. Note to J.J. : please send your address again because we lost it and
  20. we would like you to be the first to test the next version (2.0)
  21. of the Byte Killer.
  22.  
  23.  
  24. A FEW NOTES FROM J.J.
  25. ---------------------
  26.  
  27. WELL THE CRUNCH AND DECRUNCH ROUTINES ARE THE SAME,
  28. BUT I WROTE A PROGRAMM AROUND WHICH ALLOWS TO WORK WITH THE CRUNCHER,
  29. WITHOUT THE SEKA. ALSO THIS PROGRAMM IS ABLE TO CREATE A FILE ,
  30. WHICH CONTAINS ALL THE DECRUNCHER AND THE CRUNCHED DATA IN ONE FILE
  31. AND WHICH IS STARTABLE FROM CLI.
  32. (I THINK THIS IS THE FIRST CRUNCHER, WHICH ALLOWS THIS)
  33.  
  34. HOW TO HANDLE:
  35.  
  36. TYPE 'BKiller' FROM CLI
  37. THE PRG ASKS NOW FOR MEMORY TO BE ALLOCATED FROM THE SYSTEM
  38. TYPE IN A VALUE OF 1 - 999
  39. IF MEMORY ALLOCATION FAILS, THE CRUNCHER WILL RESTART
  40.  
  41. NOW YOU CAN TYPE THE FILENAME OF THE PRG YOU WANT TO CRUNCH
  42. EXEPTS:
  43. 'EXIT' WILL EXIT THE CRUNCHER
  44. '-' FOLLOWED BY A CLI COMMAND WILL EXECUTE THE COMMAND
  45. THE COMMAND HAD TO BE IN THE CURRENT DIR OR IN THE C DIR
  46.  
  47. THE PRG NOW TRIES TO LOAD THE FILE
  48. IF THE FILE IS NOT FOUND, OR THE FILE IS LONGER THAN THE ALLOCATED BUFFER
  49. THE PRG WILL ASK FOR ANNOTHER FILENAME
  50.  
  51. AFTER YOU GET THE LENGTH OF THE UNPACKED FILE,
  52. YOU HAVE TO TYPE IN A VALUE (crunch factor) OF MAX $1000 (SEE LOWER FOR THE
  53.  MEANING OF THE VALUE)
  54.  
  55. WHILE THE CRUNCHER WORKS THE SCREEN FLASHES FROM TIME TO TIME
  56.  
  57. AFTER CRUNCHING YOU GET THE LENGTH OF THE CRUNCHED FILE AND THE CHOICE,
  58. BETWEEN SAVING A EXECUTEABLE FILE (TO RUN FROM CLI) OR A DATA FILE (TO USE
  59. IN YOUR OWN PROGRAMMS)
  60.  
  61. IF YOU CHOOSE THE EXECUTEABLE FILE,THE CRUNCHER NOW ASKS FOR THE ADRESS,
  62. WHERE THE PROGRAMM SHOULD STAND AFTER DECRUNCHING.
  63.  
  64. NOW THE JUMP IN ADDRESS IS ASKED
  65.  
  66. AFTER YOU HAVE ENTERED THE SAVE FILENAME , THE CRUNCHER FREES MEMORY AND
  67. EXITS TO CLI
  68.  
  69. IF YOU HAVE SAVED ONLY DATA, YOU CAN USE THE READCRUNCHED ROUTINE TO LOAD
  70. THE DATA TO MEMORY
  71.  
  72.  
  73. A NOTE FROM LORD BLITTER
  74. ------------------------
  75.  
  76. The byte killer was designed to crunch RAW DATA (sound,code,graphics,...)
  77. but not CLI-executable code,this means that you CANNOT crunch a program
  78. like the seka assembler directly , you have to crunch it at a FIXED address
  79. (This is nearly impossible for big programs which are divided in many
  80. parts that load at different VARIABLE places in the memory !!!); but you
  81. can crunch your own programs written in assembly by using absolute
  82. addressing (use ORG & LOAD options under SEKA).
  83. By the way you can use it to make your own hires page SHOW and have
  84. twice as much pictures on a disk than with the standard IFF page show
  85. (you'll have to write your own IFF -> Bkiller converter).
  86.  
  87. The meaning of the "CRUNCH FACTOR"
  88. ----------------------------------
  89.  
  90. This factor tells the cruncher if it has to be efficient or if it has
  91. to be fast, if you use a big factor the cruncher will be very slow but
  92. very efficient and of course a small factor will be superfast but less
  93. efficient.
  94. If you don't have too much time and you want and good crunch of your
  95. program choose $400.
  96. Please do not use a factor less than 10 because if can cause decrunch
  97. problems.
  98.  
  99.  
  100.  
  101. Lord Blitter's regards are going to
  102.  
  103. 1. The belgians
  104. ---------------
  105. The Hobbit
  106. Ermida
  107. Skylight (you'll hear about him in the future)
  108. Chatterbox (another cool bug smasher of the BS1 team)
  109. Big Fat Lamer (you've probably heard about him)
  110.  
  111. 2. The germans
  112. --------------
  113. The Blizzard - Unit A - The Mad Thinker - Twilight - The Star Frontiers
  114. High Quality Crackings
  115.  
  116. 3. The 64'ers
  117. -------------
  118. Fairlight - The Sharks - Scoop - Ikari - Beastie Boys
  119.  
  120.  
  121.  
  122.   Note: If you have any remarks or questions about this program, please,
  123.         contact BAMIGA SECTOR ONE at:
  124.  
  125.                                 P.O.BOX 163
  126.                                 2018 ANTWERP 14
  127.                                 BELGIUM.
  128.  
  129.