home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / svdriver-docs / aga.doc < prev    next >
Encoding:
Text File  |  1994-07-04  |  5.2 KB  |  179 lines
  1.  
  2.   AGA.svdriver
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 1.9
  9.   Release Date : 29.06.1994
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V3.00+ (V39)+ and its libraries
  15.   - 68020+
  16.   - superviewsupport.library V1+
  17.  
  18.  
  19.   Description
  20.   ~~~~~~~~~~~
  21.   AGA.svdriver is an external Library-Module for the superview.library V3+.
  22.  
  23.   It supplies functions for V2+ SVObjects to allow object-orientated
  24.   displaying of graphics on AGA Screens.
  25.  
  26.   The internal graphics interchange format is the same as supported by
  27.   superview.library V3+ in connection with V2+ SVObjects, which can be
  28.   used by external custom programs.
  29.  
  30.   AGA.svdriver is identical to ECS.svdriver, except to the "chunky pixel"
  31.   support and other features, which have been realized with V39 functions
  32.   here.
  33.  
  34.   This Driver supports the following :
  35.  
  36.   Dimensions        Depth         Type
  37.  
  38.   [AGA]             [AGA]         BITPLANE
  39.   [AGA]             8             ONEPLANE    (Chunky Pixel)
  40.  
  41.   ONEPLANE 24 Bit Graphics (RGB 3x8-ONEPLANE) will be dithered to 8 Bit.
  42.  
  43.   Autoscrolling of Screens larger than the actual display is supported :
  44.   Just move the mouse to the boundings !
  45.  
  46.  
  47.   Author
  48.   ~~~~~~
  49.   Andreas R. Kleinert
  50.   Grube Hohe Grethe 23
  51.   D-57074 Siegen
  52.   Germany
  53.  
  54.  
  55.   Known Bugs
  56.   ~~~~~~~~~~
  57.   This bug only concerns to File-Formats in which pictures with only
  58.   2 Colors may be represented as Chunky-Pixel data, e.g. :
  59.  
  60.    - 2-Color GIF87a/89a
  61.    - 2-Color IMG
  62.    - 2-Color BMP
  63.    - 2-Color FBM
  64.  
  65.   This bug does not occur always : Whether you get it or not depends on
  66.   the actual width of the image in the file.
  67.   For example a 354x410x1 graphics from a BMP File will as well cause
  68.   problems as a 694x136x1 FBM graphics file.
  69.  
  70.   What do these have in common ?
  71.  
  72.    - they are written to the RastPort via WritePixelLine8(), using
  73.      a TmpRas-Structure with attached BitMap
  74.    - they will both be displayed on a Screen, which actually has a larger
  75.      width than the display itself (320 <-> 354 and 640 <-> 694), so
  76.      that the Autoscroll-feature has to be used
  77.    - both width values do not exactly end on byte-, word- or longword-
  78.      boundaries
  79.  
  80.   Due to the fact, that all other graphics, with the same width and
  81.   height, but other color-depth and/or bitplane organization (no
  82.   WritePixelLine8() needed) are displayed correctly, I believe
  83.   that this is the result of a bug in the OS V39, maybe also V37.
  84.   Perhaps WritePixelLine8() is not fully free of bugs yet.
  85.  
  86.   Try using other programs with some "critical" graphics and I guess,
  87.   that you will get the same results like with this SVDriver :
  88.  
  89.    - either the system will slow down very much (silent crash)
  90.    - or after closing the display and freeing all memory : problems
  91.      with the memory list will be reported by exec (Recoverable or
  92.      DeadEnd Alert) when using "avail flush"
  93.  
  94.  
  95.   History
  96.   ~~~~~~~
  97.   V1.9 (29.06.1994) :
  98.  
  99.    - now attaches ViewPortExtra structure to Screens, if possible, so that
  100.      hopefully display-speed will increase
  101.    - now opening interleaved Screens, when displaying ONEPLANE graphics
  102.      for speed reasons
  103.    - also, no longer intermediate CopperList-Updates are allowed for the
  104.      display screen
  105.    - one of the optimizations done in V1.8 might have caused slowe
  106.      24 Bit display instead of faster (not sure). Now we go the safe way,
  107.      but still somewhat optimized.
  108.  
  109.  
  110.   V1.8 (11.06.1994) :
  111.  
  112.    - now at least requires 68020 CPU
  113.      (there are perhaps no AGA machines out there, which have none).
  114.      This should speed up the 24 Bit "dithering" routines.
  115.      Startup-Code is still compatible to 68000, so that an installation
  116.      on 68000 systems will not cause a crash, if running V37/38.
  117.    - made all variables 32 Bit-wide
  118.    - did some optimizations
  119.    - fixed small bug in ColorMap routine :
  120.      creation of RGB-values resulted in a mask of 0xFFFFFF00 instead
  121.      of 0xFFFFFFFF (although there's not really a mask used)
  122.    - removed some V37-code, which was never executed
  123.  
  124.  
  125.   V1.7 (22.05.1994) :
  126.  
  127.    - fixed small bug in 24-Bit-Support :
  128.      our single temporary bitplane line always had a PlaneDepth of 24,
  129.      so that 16 planes were wasted useless :-(
  130.      Now this memory is saved and also speed may increase.
  131.  
  132.  
  133.   V1.6 (07.05.1994) :
  134.  
  135.    - use of SAS/C V6.51
  136.    - use of new "superviewsupport.library" V1
  137.      This saves some space again (here : ca. 400 Bytes).
  138.    - version still reflected 1.4 instead 1.5. Now we're at 1.6 :-)
  139.  
  140.  
  141.   V1.5 (30.04.1994) :
  142.  
  143.    - fixed small bug in memory delocation (when multiply called)
  144.  
  145.  
  146.   V1.4 (18.04.1994) :
  147.  
  148.    - improved internal "regular case" BitMap-to-BitMap routine
  149.    - added code for dithering 24 Bit RGB-Oneplane pictures
  150.      (is quite slow, but results in good pictures)
  151.  
  152.  
  153.   V1.3 (25.03.1994) :
  154.  
  155.    - slightly improved internal BitMap-to-BitMap routine
  156.    - removed bug-fix from V1.2, now using BMF_DISPLAYABLE flag, no matter
  157.      if this will help or not
  158.  
  159.  
  160.   V1.2 (19.03.1994) :
  161.  
  162.    - tried to fix bug with strange-sized (temporary) bitmaps like 694x136 :
  163.      now uses size = (((x + 15) >> 4) << 4) for determinating the
  164.      desired width.
  165.      This is not completely fixed yet (seems to be an OS bug ...)
  166.  
  167.  
  168.   V1.1 (09.03.1994) :
  169.  
  170.    - first version
  171.  
  172.  
  173.   Copyrights
  174.   ~~~~~~~~~~
  175.   Some of the mentioned names or products above may be copyrighted by
  176.   companies or trademarks of companies.
  177.  
  178.  
  179.