home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !FALCON / RG / RES_RIPR.ZIP / RES_RIPR / RIPPER.ASC < prev    next >
Encoding:
Text File  |  2005-04-30  |  10.4 KB  |  323 lines
  1.                            RESERVOIR RIPPER
  2.                            ----------------
  3.  
  4.                            CODED BY MR PINK
  5.  
  6.                        (C) 1995 RESERVOIR GODS
  7.  
  8.                 ** INTERNAL RELEASE - NO SPREADING **
  9.  
  10. The "Reservoir Ripper" is  designed  for  ripping graphics from Falcon
  11. games and demos for use as screenshots in Maggie.
  12.  
  13. Its store pictures  in  a  new  GRIP  (Gods  RIPper)  format  with the
  14. extension .RIP - this contains all picture data, screen dimensions and
  15. all palette data.
  16.  
  17. Unfortunately this format  is  not  supported  by  any  art package or
  18. viewer yet as I have just invented it. I am currently coding a viewer.
  19.  
  20. There is now also the option  to  save  in .GOD format. No matter what
  21. resolution you are running from it will convert the screen into a true
  22. colour picture.
  23.  
  24. To access the ripper you will have  to  plug a jaguar joypad into Port
  25. A. Run the ripper, install your  vectors, run your target program, get
  26. to the place you want and press option!
  27.  
  28.                                LOADING
  29.                                =======
  30.  
  31. The Reservoir Ripper can be loaded  in  one  of  two ways - either the
  32. conventional way by just double clicking  on  it, or you can drag your
  33. target program onto it. It fully supports  the command line, so if you
  34. wish to rip a demo, drag it  onto  the ripper and this program will be
  35. executed when the vector menu is exited.
  36.  
  37. On loading you will get some  text  in  the normal TOS font, press any
  38. key to go onto the vector installation menu.
  39.  
  40.  
  41.                        VECTOR INSTALLATION MENU
  42.                        ========================
  43.  
  44. This is the main control menu for the ripper.
  45.  
  46. The ripper works by latching itself onto various vectors, and here you
  47. can choose which vectors to take  over.  The more vectors you use, the
  48. slower the system will be and the greater the likelyhood of a crash.
  49.  
  50. I will give a quick over-view of the vectors and their functions:
  51.  
  52. TIMER A
  53. -------
  54.  
  55. Used for DMA-Sound, tracker players etc.
  56.  
  57. TIMER B
  58. -------
  59.  
  60. Used for palette switching, rasters.
  61.  
  62. TIMER C
  63. -------
  64. Use by TOS to monitor keyboard input - keyclick, key repeat etc.
  65.  
  66. TIMER D
  67. -------
  68. RS-232 baud rate generator  -  usually  unused.  This  is  a very fast
  69. interrupt (very frequently called) and  will  slow things down quite a
  70. bit.
  71.  
  72. VBL
  73. ---
  74. Interrupt at the start of every frame.
  75.  
  76. VBL QUEUE
  77. ---------
  78. When system VBL is installed, routines here are executed.
  79.  
  80. TRAP #1
  81. -------
  82. File loading operations,  screen  printing,  key  inputs,  super mode,
  83. executing files, memory allocation.
  84.  
  85. TRAP #2
  86. -------
  87. For GEM only - AES/VDI calls.
  88.  
  89. TRAP #13
  90. --------
  91. Key/printer i-o, exception setting,  system  timer info, drive bitmap,
  92. keyboard shift info, read/write disk sectors.
  93.  
  94. TRAP #14
  95. --------
  96. Get/set screen, WAITING FOR VBL,  random, dsp communication, DMA sound
  97. control, track read/write, exec in super mode, get/set time
  98.  
  99. IKBD
  100. ----
  101. Keyboard Handler (+mouse & joystick)
  102. Occurs on keyboard/mouse/joystick event.
  103.  
  104. BLITTER DONE
  105. ------------
  106. Blitter command complete (usually off)
  107.  
  108. LINE A
  109. ------
  110. Non-fast graphics functions. Mouse sprite on/off.
  111.  
  112. LINE F
  113. ------
  114. some crap routines that no-one ever uses.
  115.  
  116. HBL
  117. ---
  118. Horizontal blank - at low IPL levels only!
  119.  
  120. ERROR EXCEPTIONS
  121. ----------------
  122. Takes over all system crashes - instead of bombing out the ripper will
  123. be called. Bus error, address error, illegal instruction etc.
  124.  
  125. RS-232 INTERRUPTS
  126. -----------------
  127. All rs-232 exceptions  goto  the  ripper.  You  can  trigger events by
  128. configuring the rs-232 port.
  129.  
  130. MONO MONITOR
  131. ------------
  132. Plug in a mono monitor to trigger this interrupt.
  133.  
  134. MMU VECTORS
  135. -----------
  136. Memory configuration/addressing errors will trigger this interrupt.
  137. NB - GEMDOS usually restores all these vectors.
  138.  
  139. TRACE EXCEPTION
  140. ---------------
  141. Was going to be  the  centrepiece  of  stunning  new ripping technique
  142. which dismally failed.
  143.  
  144. ALT-HELP
  145. --------
  146. Screen dump vector. Press ALTernate + HELP & OPTION.
  147. Only valid if system IKBD handler is active.
  148.  
  149. FLOPPY/HD INTERRUPT
  150. -------------------
  151. IT IS NOT RECCOMMENDED THAT YOU USE THIS INTERRUPT!!!!
  152. IT COULD LEAD TO DATA LOSS!!! YOU HAVE BEEN WARNED!!!!
  153. If all else fails, not many games/demos take over this!
  154.  
  155. RESET
  156. -----
  157. Press reset. This is  not  for  ripping  purposes,  but for diagnostic
  158. purposes. On pressing reset it  will  jump  to the vector installation
  159. screen and the currently installed vectors will be asterisked.
  160.  
  161.                               RE-INSTALL
  162.                               ==========
  163.  
  164. If a vector is  on  re-install  mode,  it  means  that  if a game/demo
  165. disables it, it  will  be  re-installed.  It  will  intelligently jump
  166. through the new vector so the program will still run properly.
  167.  
  168. The best things to put  on  re-install  are  the TIMERS, VBL, IKBD and
  169. other MFP interrupts. It is pointless putting such things as TRAPS and
  170. LINE A/LINE F on reinstall as most programs don't take these over.
  171.  
  172.                                RESTORE
  173.                                =======
  174.  
  175. A vector which is on RESTORE mode  does all the housekeeping. That is,
  176. it make sure the  program  isn't  being  nasty and de-installing other
  177. vectors.
  178.  
  179. Vectors on RESTORE mode check all  vectors on RE-INSTALL mode and will
  180. RE-INSTALL any vectors that have been changed.
  181.  
  182. This is an intelligent re-installation  that checks for zero, negative
  183. and odd addresses, also check the relevant bits in MFP interrupt masks
  184. to  determine  whether   to   reinstall   vectors.   Because  of  this
  185. intelligence the routine can be quite time consuming, so don't put too
  186. many vectors on RESTORE mode or the system will grind to a halt.
  187.  
  188.                              SAVING FILES
  189.                              ============
  190.  
  191. You can save files in RIP or GOD (true colour) format.
  192.  
  193. Non true colour picture saved as  GOD  files will be converted to true
  194. colour mode. The current screen is used  as a buffer for conversion so
  195. ignore any mess in  the  top  lines!  (Just  pretend  it is the pompey
  196. packer or something!)
  197.  
  198.  
  199. Converting and Saving GOD files  to  FLOPPY  will  take AGES! You have
  200. been warned! (save to Hard Drive or be prepared for a LONG wait!)
  201.  
  202.                              RIPPER MENU
  203.                              ===========
  204.  
  205. On pressing 'OPTION' on  your  powerpad,  the  "Reservoir Ripper" will
  206. appear on your screen.
  207.  
  208. It changes resolution into 640 x  200  2  colour mode. This only takes
  209. 16k of memory and this  screen  memory  is  part  of  the ripper so it
  210. doesn't interfere with the game/demo you are ripping.
  211.  
  212. Screen setting is not via XBIOS, but pokes VIDEL directly.
  213.  
  214.  
  215. The main ripper screen gives  information about the current resolution
  216. and colour mode the falcon is in. The x and y dimensions of the screen
  217. are displayed, along with  the  colour  mode.  All the important VIDEL
  218. registers  are  displayed  including  all  the  horizontal  registers,
  219. vertical registers, video clock, video  control,  sync, line width and
  220. horizontal scroll.
  221.  
  222. [F1] VIEW SCREEN
  223.  
  224. Pressing F1 will revert the screen  back  to its old mode, dimensions,
  225. colour and address allowing you to preview the screen you are about to
  226. save. Pressing F1 again takes you back to the main menu.
  227.  
  228. ** NOTE **
  229. DON'T TRY THIS FUNCTION ON RGB MONITORS  IF THE SCREEN IS IN INTERLACE
  230. MODE!
  231.  
  232. [F2] VECTOR MENU
  233.  
  234. Allows you to reconfigure  the  vectors  that  are  set up and examine
  235. which vectors have been taken over by the current game/demo.
  236.  
  237. When the ripper is called, it  checks  which  of its vectors are still
  238. active. This are displayed as  asterisks  in  the install line of this
  239. menu. You can re-install  any  vectors  you  want,  and change the re-
  240. install and restore modes of vectors from here.
  241.  
  242. [F3] SAVE FILE (GOD)
  243.  
  244. Save screen in GOD file format.
  245.  
  246. If the screen mode is true colour, saving will be a quick process.
  247.  
  248. If non true colour, the picture is converted to true colour, which may
  249. take some time, especially if saving to floppy.
  250.  
  251. [F4] SAVE SCREEN (RIP)
  252.  
  253. This saves all the picture  and  palette  information from the current
  254. screen resolution.
  255.  
  256.  
  257.                             TRICKS & TIPS
  258.                             =============
  259.  
  260. The best vectors to use  are  the  TIMERS.  Timer  C  and D are rarely
  261. changed by programs. The TRAPs are  never usually changed, but are not
  262. accessed every VBL, although  some  demos/games  will  use trap #14 to
  263. wait for the vertical blank (e.g. Papa was a bladerunner by EKO).
  264.  
  265. The IKBD is another good thing to take over, although you will have to
  266. move the mouse/touch the  keyboard  AND  press  option  to trigger the
  267. ripper.
  268.  
  269. A useful default configuration would be:
  270.  
  271.             INSTALL             REINSTALL              RESTORE
  272. TIMER A        *                   *
  273. TIMER B        *                   *
  274. TIMER C        *                   *                      *
  275. TIMER D        *                   *
  276. VBL            *                   *
  277. VBL QUEUE      *
  278. TRAP #1        *                                          *
  279. TRAP #2        *                                          *
  280. TRAP #13       *                                          *
  281. TRAP #14       *                                          *
  282. IKBD           *                   *                      *
  283.  
  284.  
  285.  
  286. That is having all TIMERS, TRAPS, VBL, VBL QUEUE & IKBD installed.
  287. TIMERS, VBL and IKBD will be re-installed if disabled.
  288. The traps, ikbd and timer d handle the RE-INSTALLING.
  289.  
  290.                                  BUGS
  291.                                  ====
  292.  
  293. Loads!
  294.  
  295. The main problem is with TIMER D.
  296. DO NOT put TIMER D on RESTORE  mode  if lots of vectors are on RESTORE
  297. and REINSTALL mode! It will crash!
  298.  
  299. You can put every single  vector  on INSTALL, everything on RE-INSTALL
  300. and all on RESTORE except TIMER D.
  301.  
  302. You can put timer d on restore  mode  if not many other vectors are on
  303. restore/re-install mode.
  304.  
  305.  
  306. Keyboard hanler is shagged after reset.
  307.  
  308. ***BIG BUG****
  309.  
  310. SCREEN VIEWING DOES NOT WORK IN INTERLACE MODE!!!!
  311. If you are hacking a game/demo in  interlace mode, do not try the view
  312. screen option or the monitor will go haywire. Quitting the ripper will
  313. cause the same problem.  You  can  still  save  the current screen for
  314. later viewing.
  315.  
  316.                             SCARY WARNING
  317.                             =============
  318.  
  319. This program is not for spreading. If  demo coders see which vectors I
  320. am taking over they may trash them to prevent picture ripping.
  321.  
  322. [ MR PINK : after the storm ]
  323.