home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / aga / agaasststuff4.lha / killaga / killaga.readme < prev    next >
Encoding:
Text File  |  1993-05-23  |  3.7 KB  |  124 lines
  1. KillAGA V2.0    22/May/1993
  2. ---------------------------
  3.  
  4. Written by Jolyon Ralph, Almathera Systems Ltd.
  5.  
  6. This program is *PUBLIC DOMAIN*. It may be freely distributed
  7. in any way as long as
  8.  
  9. a) The executable file (KillAGA) and this text file remain unaltered.
  10. b) This file is distributed with the KillAGA program.
  11. c) It is not used as part of a commercial product without my express
  12. permission.
  13.  
  14. If you want to include this on a commercial product or a magazine
  15. coverdisk, please email me at the address below to ensure you
  16. have the latest version:
  17.  
  18. If you like this product and really insist on sending me something,
  19. then send me your Our Price CD receipts, or WHSmiths free CD
  20. stickers so I can get some free CDs....
  21.  
  22.  
  23. What does it do?
  24. ----------------
  25.  
  26. This program allows you to run old, badly written, programs (mainly
  27. demos and some games) from your A1200/4000 hard disk without having
  28. to continually reboot and switch chip settings. On return from
  29. the program the system returns to full AGA state!
  30.  
  31. While loading your program the screen goes black, so don't panic!
  32.  
  33.  
  34. How does it do it?
  35. ------------------
  36.  
  37. It fixes three major problems with running old demos on new AGA
  38. machines.
  39.  
  40. 1. AGA Chipset registers - These are temporarily disabled while running
  41. KillAGA. *FAR* more old demos and games work now..
  42.  
  43. 2. Sprite resolution - Sprites are forced back to standard ECS resolution
  44.  
  45. 3. Caches - All processor caches are disabled, and restored to the
  46. original state on exiting KillAGA
  47.  
  48.  
  49. How do you use it?
  50. ------------------
  51.  
  52. It's simple. Use from the CLI (or a ICONX script file):
  53.  
  54. killaga <programname>
  55.  
  56. Just type killaga followed by the program name from the CLI 
  57. (unlike the RUN command, it does not return until after your
  58. program has finished)
  59.  
  60. Creating an ICON is just as easy.
  61.  
  62. So, for example, to run dh0:demos/OldNaffDemo, you would create a text
  63. file containing
  64.  
  65. killaga dh0:demos/OldNaffDemo
  66.  
  67. and save that. Edit the icon tooltype to use C:ICONX as the default tool,
  68. and just double-click the icon.
  69.  
  70.  
  71. To call a program that requires CLI parameters, just enclose the string
  72. you would normally type in speech marks:
  73.  
  74. killaga "mydemo 1 2 3 4 5 6"
  75.  
  76.  
  77. If, for some reason, you accidentally run KillAGA with an OS
  78. friendly program the screen may stay blank. Press Amiga-M or Amiga-N
  79. (the screen shuffle keys) to get your screens back. You should
  80. not use KillAGA with these kind of programs.
  81.  
  82.  
  83.  
  84. What it *doesn't* do:
  85. ---------------------
  86.  
  87. It *doesn't* give you fake fastram. Buy real fastram, it's
  88. the only way to get *fast* ram on an A1200. Chip ram is terribly
  89. slow. KillAGA 3 may well be able to give you *REAL* $c00000 memory
  90. for your A1200 or A4000 (although this will require an MMU, not
  91. present in standard A1200 or A4000/030)
  92.  
  93. It *doesn't* yet have options to keep caches enabled. I guess
  94. some vector games/demos would be better with this...
  95.  
  96. It doesn't do *ANY* illegal hardware access, all code is 100%
  97. OS friendly, so this should work on AAA (!!!!!).
  98.  
  99. It *doesn't* work on any machine with Kickstart 1.x or 2.x, but
  100. you shouldn't need this anyway!
  101.  
  102. It *doesn't* work with programs that set up their own background task
  103. and then quit (programs that immediately return to the CLI prompt
  104. before quitting - eg Protracker 3.01).
  105.  
  106. It doesn't work with compiled AMOS programs. They open up an
  107. (almost) invisible Intuition screen to handle input, etc... This
  108. annoys KillAGA. Recompile AMOS programs with Amos 1.35 Compiler and
  109. you won't need to use KillAGA.
  110.  
  111.  
  112. Email to: jralph@cix.compulink.co.uk. for bug reports, information
  113. on new versions, etc....
  114.  
  115. If you have found anything that still doesn't work with this, please
  116. tell me about it and I'll try and make KillAGA 3 fix the problem.
  117.  
  118. Snail mail (and your receipts :) to:
  119.  
  120. Jolyon Ralph,
  121. 81 Woodcote Grove Rd,
  122. Coulsdon, Surrey,
  123. CR5 2AL
  124.