home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / gfx / misc / patchdt / readme.txt < prev    next >
Text File  |  1993-12-21  |  4KB  |  106 lines

  1.                        ========================================
  2.  
  3.                                        PatchDT
  4.  
  5.                          Copyright (c) 1993 by Stefan Boberg
  6.  
  7.                              Freely Distributable Software
  8.  
  9.                        ========================================
  10.  
  11. DESCRIPTION
  12.         
  13.         PatchDT is a program that patches a few functions in the datatypes
  14.         library in order to speed up the Workbench screen update when using
  15.         datatypes objects as backdrops in the workbench windows. This is
  16.         only useful with graphics cards such as the Piccolo or GVP Spectrum;
  17.         you will see no speedup when using the native Amiga graphics.
  18.  
  19. PERFORMANCE
  20.  
  21.         When using the patch on a Piccolo graphics board in Zorro-II mode,
  22.         workbench windows open and close approximately four times as quick
  23.         as an unpatched workbench. In Zorro-III mode it is even faster.
  24.  
  25.         Here's a rough comparison of timings with and without PatchDT:
  26.         
  27.         Screen: 1024*768, 256 colors, opening a full-screen empty drawer
  28.         window containing a 256-colour backdrop over a 256-colour
  29.         workbench backdrop.
  30.  
  31.               +--------+---------+
  32.               |Original| PatchDT |
  33.         +-----+--------+---------+
  34.         |Z2   |  2.0 s |  0.5 s  |
  35.         |Z3   |  1.8 s |  0.4 s  |
  36.         +-----+--------+---------+
  37.  
  38.         Timings are for an A4000/040. Depending on your screen mode and
  39.         host system, you may get different results.
  40.  
  41.  
  42. WHAT CARDS DOES IT WORK ON?
  43.  
  44.         All graphics cards using the EGS WBEmu software. Among these are
  45.         the Piccolo, and the GVP EGS Spectrum.
  46.  
  47.         This has not been tested on the Picasso II board, but if the
  48.         Picasso emulation software is well-written, it should work
  49.         there as well.
  50.  
  51. SYSTEM REQUIREMENTS
  52.  
  53.         CPU: 68020 or higher.
  54.         OS:  Kickstart 3.0 or later
  55.  
  56. USAGE
  57.  
  58.         Put the line:
  59.         
  60.           run >nil: <nil: PatchDT
  61.  
  62.         at the end of your `sys:s/User-Startup' file. Important: the program
  63.         must be run AFTER any Workbench-emulators have been installed. I.e.
  64.         on a system using the EGS software, insert the above line after the
  65.         `execute s:EGS-Startup' line.
  66.  
  67. REMOVING THE PATCH
  68.  
  69.         If you want to remove the patch without editing your `User-Startup'
  70.         file and rebooting, simply send it a break signal with the `break'
  71.         CLI command. Notice that any cached bitmaps will NOT be freed when
  72.         the patch is removed. This memory is lost until the next reboot.
  73.  
  74.         Also, after you have removed the patch, the effect of the PatchDT
  75.         program will remain until you change the Workbench screen mode, or
  76.         select new backdrop pictures. This is because the Workbench caches
  77.         the bitmap pointers internally (it doesn't ask the object for it
  78.         each time it does a refresh).
  79.  
  80.  
  81. HOW IT WORKS
  82.  
  83.         Take a look at the commented source if you want to know what it
  84.         does. Basically, it caches the remapped datatype bitmaps in
  85.         FastRAM.
  86.  
  87.  
  88. CONTACTING THE AUTHOR
  89.  
  90.         I am reachable at the following electronic mail addresses:
  91.         
  92.         email:  boberg@lysator.liu.se
  93.         FIDO:   "Stefan Boberg" @ 2:204/404.7
  94.         
  95.         And standard snail-mail:
  96.         
  97.                 Stefan Boberg
  98.                 Rydsvägen 260 C:33
  99.                 S-58251 Linköping
  100.                 Sweden
  101.  
  102.         If you have any problems with the program, or have any comments
  103.         or questions regarding it, please let me know. If you update the
  104.         program, please send me a copy.
  105.  
  106.