home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / svdriver-docs / ecs.doc < prev    next >
Encoding:
Text File  |  1994-07-04  |  4.2 KB  |  152 lines
  1.  
  2.   ECS.svdriver
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 1.8
  9.   Release Date : 11.06.1994
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V2.04+ (V37)+ and its libraries
  15.   - superviewsupport.library V1+
  16.  
  17.  
  18.   Description
  19.   ~~~~~~~~~~~
  20.   ECS.svdriver is an external Library-Module for the superview.library V3+.
  21.  
  22.   It supplies functions for V2+ SVObjects to allow object-orientated
  23.   displaying of graphics on ECS Screens.
  24.  
  25.   The internal graphics interchange format is the same as supported by
  26.   superview.library V3+ in connection with V2+ SVObjects, which can be
  27.   used by external custom programs.
  28.  
  29.   ECS.svdriver is identical to AGA.svdriver, except to the "chunky pixel"
  30.   support and other features, which have been realized without V39 functions
  31.   here.
  32.  
  33.   This Driver supports the following :
  34.  
  35.   Dimensions        Depth         Type
  36.  
  37.   [ECS]             [ECS]         BITPLANE
  38.   [ECS]             8             ONEPLANE    (Chunky Pixel)
  39.  
  40.   The 8-Bit mode will perhaps only work on ECS systems which have any
  41.   Graphic Card installed, which allows 256 or more colors in a way
  42.   of an Intuition emulation.
  43.  
  44.   Autoscrolling of Screens larger than the actual display is supported :
  45.   Just move the mouse to the boundings !
  46.  
  47.  
  48.   Author
  49.   ~~~~~~
  50.   Andreas R. Kleinert
  51.   Grube Hohe Grethe 23
  52.   D-57074 Siegen
  53.   Germany
  54.  
  55.  
  56.   Known Bugs
  57.   ~~~~~~~~~~
  58.   This bug only concerns to File-Formats in which pictures with only
  59.   2 Colors may be represented as Chunky-Pixel data, e.g. :
  60.  
  61.    - 2-Color GIF87a/89a
  62.    - 2-Color IMG
  63.    - 2-Color BMP
  64.    - 2-Color FBM
  65.  
  66.   This bug does not occur always : Whether you get it or not depends on
  67.   the actual width of the image in the file.
  68.   For example a 354x410x1 graphics from a BMP File will as well cause
  69.   problems as a 694x136x1 FBM graphics file.
  70.  
  71.   What do these have in common ?
  72.  
  73.    - they are written to the RastPort via WritePixelLine8(), using
  74.      a TmpRas-Structure with attached BitMap
  75.    - they will both be displayed on a Screen, which actually has a larger
  76.      width than the display itself (320 <-> 354 and 640 <-> 694), so
  77.      that the Autoscroll-feature has to be used
  78.    - both width values do not exactly end on byte-, word- or longword-
  79.      boundaries
  80.  
  81.   Due to the fact, that all other graphics, with the same width and
  82.   height, but other color-depth and/or bitplane organization (no
  83.   WritePixelLine8() needed) are displayed correctly, I believe
  84.   that this is the result of a bug in the OS V39, maybe also V37.
  85.   Perhaps WritePixelLine8() is not fully free of bugs yet.
  86.  
  87.   Try using other programs with some "critical" graphics and I guess,
  88.   that you will get the same results like with this SVDriver :
  89.  
  90.    - either the system will slow down very much (silent crash)
  91.    - or after closing the display and freeing all memory : problems
  92.      with the memory list will be reported by exec (Recoverable or
  93.      DeadEnd Alert) when using "avail flush"
  94.  
  95.  
  96.   History
  97.   ~~~~~~~
  98.   V1.8 (11.06.1994) :
  99.  
  100.    - fixed small bug in ColorMap routine :
  101.      creation of RGB-values resulted in a mask of 0xFFFFFF00 instead
  102.      of 0xFFFFFFFF (although there's not really a mask used)
  103.      (V39 only)
  104.  
  105.  
  106.   V1.7 (07.05.1994) :
  107.  
  108.    - use of SAS/C V6.51
  109.    - use of new "superviewsupport.library" V1
  110.      This saves some space again (here : ca. 400 Bytes).
  111.  
  112.  
  113.   V1.6 (30.04.1994) :
  114.  
  115.    - fixed small bug in memory delocation (when multiply called)
  116.  
  117.  
  118.   V1.5 (02.04.1994) :
  119.  
  120.    - improved internal "regular case" BitMap-to-BitMap routine
  121.  
  122.  
  123.   V1.4 (25.03.1994) :
  124.  
  125.    - slightly improved internal BitMap-to-BitMap routine
  126.    - We now use a higher alignment for TmpRas-BitPlanes,
  127.      to ensure higher compatibility (and speed increase) under
  128.      V39 with the AGA chipset.
  129.      Alignment now is done for longword-boundaries as follows :
  130.      ((width + 31) >> 5) << 5
  131.  
  132.  
  133.   V1.2 / V1.3 (14.03.1994) :
  134.  
  135.    - there are no significant differences between V1.2 and V1.3
  136.      (at least I don't remember them ...)
  137.    - fixed "large memory usage" bug in ChunkyPixel routine
  138.    - this version has been released as bug-fix to V1.1
  139.      (superview.library V3.1 release)
  140.  
  141.  
  142.   V1.1 (09.03.1994) :
  143.  
  144.    - first version
  145.  
  146.  
  147.   Copyrights
  148.   ~~~~~~~~~~
  149.   Some of the mentioned names or products above may be copyrighted by
  150.   companies or trademarks of companies.
  151.  
  152.