home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / emulator-tools / shapeshifter / shapeshifteraga / amigaaga-evd.doc < prev    next >
Encoding:
Text File  |  1995-11-20  |  5.6 KB  |  144 lines
  1.  
  2. FEATURES:
  3.  
  4.   - 8-bit refresh code rewritten.  Now it's up to 1.8 times faster
  5.     (especially in doublescan modes) than my refresh routine in
  6.     ShapeShifter 3.1 (and over 25 times faster than in ShapeShifter 3.0)
  7.   - Added support for 15-bit mode with fast conversion to HAM8
  8.   - Almost 2 times faster chunky2plannar routines for 4-bit refresh
  9.   - Old 2-bit routine is added (for your comfort :) )
  10.   - All refresh routines convert only screen changes ("delta" buffer)
  11.   - Now all refresh routines are safer and don't trash screen when bitmap
  12.     width isn't multiple of 64 (ShapeShifter allows multiple of 16)
  13.  
  14.   Note: HAM8 render routine is very fast but gives very low quality so I
  15.         optimized it for some standard MacOS GUI colors. Especially small
  16.         objects like icons, non-standard gadgets are not very readable.
  17.         Refreshing with "delta" buffer isn't as fast as in other modes
  18.         because always full lines must be converted to HAM. So 15-bit
  19.         mode is good only for truecolor graphics previews, picture
  20.         viewers, etc. not for real work.
  21.         In V1.2 of driver all greys, default GUI colours even in Copland
  22.         look are taken from lookup table so it is additionally faster.
  23.  
  24.  
  25. REQUIREMENTS:
  26.  
  27.   - OS3.0+ (allocating interleaved bitmaps for 8-bit modes)
  28.   - AGA chipset (only for 8-bit screen and HAM8), 1/2/4-bit depth modes
  29.     should work on ECS machines but at least OS3.0 is still required
  30.   - ShapeShifter 3.2 or later (ShapeShifter 3.1 had a bug in RTYPE_CUSTOM
  31.     refresh)
  32.   - A lot of FastMem :) AmigaAGA-EVD uses the same amount of memory as
  33.     ShapeShifter 3.1 but remember to leave space for screen buffers in
  34.     memory configuration window.
  35.  
  36.   How to calculate it:
  37.   For 640x480x8 screen driver needs 640*480*2=614400 bytes  (2 - because
  38.   one  buffer  is  used  by ShapeShifter for screen buffer and second by
  39.   driver for "delta" buffer)
  40.   For 640x480x15 screen driver uses 1228800 bytes.
  41.  
  42.   Writing  24-bit  driver  is  possible  and  it  isn't a problem but it
  43.   requires  very  much  memory  because  all  pixels are stored as 32bit
  44.   words.  For  640x480x24 screen  over 2.4MB would be used and this mode
  45.   would be even slower than 15-bit but quality will not be better at all.
  46.  
  47.  
  48. HOW TO USE:
  49.  
  50.   Set "Screen type" as "External" and select name of driver in "External
  51.   driver" string  gadget.  Set screen mode,  width and height.  For best
  52.   performance width  should be multiple of 64, i.e.  448, 512, 576, 640,
  53.   704, 768, 832, etc. but driver works well also with other values.
  54.  
  55.   Suggested refresh rates for 68030/25MHz systems:
  56.     2-bit mode: 2 or even 1
  57.     4-bit mode: 2-5
  58.     8-bit mode: 4-6
  59.    15-bit mode: 5-9
  60.   Above values are good for Multiscan 640x480.
  61.  
  62.   For QuickTime animations use small screen and higher rate, f.e.:
  63.   - for 512x300x4 (only greys) set refresh to 2 or 3 - you get smoother
  64.     animation than even in 1bit mode
  65.   - for 448x300x8 (color mode) set refresh to 3
  66.  
  67.   NOTE: This EVD driver is suggested for 020/030 systems  (A1200/A4030).
  68.         It doesn't use MMU for faster refresh because simply  I  haven't
  69.         MMU and I don't know how to program it. But of course EVD should
  70.         work well also on 040 systems and better  optimization  for  MMU
  71.         usage is possible.  I'm still open for MMU gurus who want to add
  72.         MMU support in my driver. I think it is possible even on systems
  73.         with full 68030.
  74.    
  75.  
  76. AUTHOR:
  77.  
  78.   AmigaAGA-EVD  was  written in Devpac assembler on A4030/882/10MB/850MB
  79.   using  "ShapeShifter  External  Video  Driver  Interface Specification
  80.   (Level 1)"  by Christian Bauer.  Chunky2plannar routines were based on
  81.   several sources from Aminet and from people who supported my driver.
  82.   All comments/bug reports send to:
  83.  
  84.            Pawel Hernik
  85.            Nowowiejska 24/3
  86.            25-532 Kielce
  87.            POLAND
  88.            tel/fax (041)27012
  89.  
  90.   E-mail:  spi-ph@srv1.tu.kielce.pl
  91.            phernik@sabat.tu.kielce.pl
  92.   WWW:     http://sabat.tu.kielce.pl/~phernik
  93.  
  94.   Latest  version  of  AmigaAGA-EVD  and  other  my  programs  should be
  95.   available on my Home Page.
  96.  
  97.  
  98. THANX TO:
  99.  
  100.   - Christian Bauer for making great emulator and External Video Driver
  101.     specifications
  102.   - Peter Kunath for DrWho Genie source code and his c2p routine
  103.   - Jyrki Saarinen for suggestions and c2p routines
  104.   - also to James McCoull and Peter McGavin for making chunky2plannar
  105.     conversion on Amiga really fast
  106.   - Marcin Balewicz for beta testing
  107.  
  108.  
  109. DISTRIBUTION:
  110.  
  111.   AmigaAGA-EVD is FREEWARE.  You may use and copy this driver freely but
  112.   all  files  must be copied in an unmodified state preferably in LhA or
  113.   LZX  archive.   Use  it at your own risk.  If you use AmigaAGA-EVD and
  114.   you like it send me a postcard or message via e-mail.
  115.  
  116.   If  you  want  to  include  AmigaAGA-EVD  on  a CD-ROM and/or magazine
  117.   coverdisk,  please send me a free copy of the CD/magazine (this is not
  118.   a must, but I would appreciate it very much).
  119.  
  120.  
  121. HISTORY:
  122.  
  123.   1.0 (20.9.95)
  124.  
  125.     never released because of bug in ShapeShifter 3.1, 15-bit support
  126.     added and 8-bit c2p routines changed
  127.  
  128.   1.1 (1.10.95)
  129.  
  130.     first release, c2p routine changed again (thanx to Peter Kunath),
  131.     now it hasn't such restrictions like previous routine and is much
  132.     simplier
  133.  
  134.   1.2 (14.11.95)
  135.  
  136.    - faster 4-bit refresh (max 2 times!)
  137.    - better quality of 15-bit to HAM8 conversion and now refresh is even
  138.      a bit  faster  because of using lookup table and only right changed
  139.      parts of lines are refreshed
  140.    - now border is always black (unfortunately Christian didn't  support
  141.      "Black border"  gadget in EVD specifications),  in previous version
  142.      you had to use bblank or similar programs
  143.  
  144.