home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / svdriver-docs / egs.doc < prev    next >
Text File  |  1994-07-04  |  5KB  |  171 lines
  1.  
  2.   EGS.svdriver
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 1.6
  9.   Release Date : 22.05.1994
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V2.04+ (V37)+ and its libraries
  15.   - superviewsupport.library V3+
  16.   - egs.library      V1+
  17.   - egsintui.library V1+
  18.   - egsgfx.library   V1+
  19.  
  20.  
  21.   Description
  22.   ~~~~~~~~~~~
  23.   EGS.svdriver is an external Library-Module for the superview.library V3+.
  24.  
  25.   It supplies functions for V2+ SVObjects to allow object-orientated
  26.   displaying of graphics on EGS Screens (Enhanced-Graphic-System Screens).
  27.   All corresponding EGS-Libraries are needed.
  28.  
  29.   The internal graphics interchange format is the same as supported by
  30.   superview.library V3+ in connection with V2+ SVObjects, which can be
  31.   used by external custom programs.
  32.  
  33.   This Driver supports the following :
  34.  
  35.   Emulation   Dimensions      max. Depth    Type
  36.  
  37.   EGS-Card    [EGS-Card]      8/24        ONEPLANE
  38.                   8         BITPLANE
  39.   ECS/AGA     [ECS/AGA]       8         ONEPLANE
  40.                   8         BITPLANE
  41.  
  42.   Currently BITPLANE with more than 8 Bit Colordepth and ONEPLANE with other
  43.   pixelbits than 8 or 24 (e.g. 16 Bit R5:G5:B5:1) are not supported.
  44.  
  45.  
  46.   EGS-Cards
  47.   ---------
  48.   When using an EGS Card, all supported ColorDepths should be displayed
  49.   correctly in TrueColor.
  50.  
  51.   Amiga ECS/AGA emulation
  52.   -----------------------
  53.   When using the ECS/AGA emulation, you should set the max. possible
  54.   ColorDepth in the ScreenMode preferences program.
  55.  
  56.   AGA :
  57.   With AGA any Graphics with less than 256 Colors should be displayed
  58.   100% correctly. Only 256 Color-graphics will usually have some Colors
  59.   wrong, because those are obtained by the EGS-System for the Display itself
  60.   (Window-Borders, etc.), so that they usually can't be used for the graphics.
  61.   24 Bit graphics will be dithered to 256 Colors under AGA (usually
  62.   GreyScaled).
  63.  
  64.   ECS:
  65.   Using the ECS emulation will perhaps nearly always result in very
  66.   ugly Colors, if you're displaying more than, let's say, 8 Colors.
  67.   This results out of the maximum ColorDepth of 16 Colors in Hires,
  68.   of which some - see AGA notes - are already reserved.
  69.   Of course 24 Bit graphics may also be dithered to 16 Colors/GreyScales,
  70.   but better don't try it out ...
  71.  
  72.   Closing of the current EGS Display is possible by freeing the handle's
  73.   resources or delocating the handle, but no screen or window addresses
  74.   (for IDCMP checking) are returned by the related library functions,
  75.   because EGS is (as far as I know) binary incompatible to Intuition.
  76.   To fix this a little bit, every time when displaying a graphic on the EGS-
  77.   Screen a Workbench Window is opened which allows usual IDCMP access.
  78.   Window IDCMP and Window Flags (except backdrop/borderless) are recognized
  79.   and used.
  80.  
  81.  
  82.   Author
  83.   ~~~~~~
  84.   Andreas R. Kleinert
  85.   Grube Hohe Grethe 23
  86.   D-57074 Siegen
  87.   Germany
  88.  
  89.  
  90.   History
  91.   ~~~~~~~
  92.   V1.6 (22.05.1994) :
  93.  
  94.    - replaced internal BitPlaneToOnePlane routine with its pendant from
  95.      superviewsupport.library V3+
  96.  
  97.  
  98.   V1.5 (07.05.1994) :
  99.  
  100.    - 15.05.94 : modified Doc-File slightly
  101.    - use of SAS/C V6.51
  102.    - use of new "superviewsupport.library" V1
  103.      This saves some space again (here : ca. 400 Bytes).
  104.  
  105.  
  106.   V1.4 (29.04.1994) :
  107.  
  108.    - MAJOR REVISION
  109.    - added support for BITPLANE formats upto 8 Bit (256 Colors),
  110.      which works for V37+ and V39+ (different routines)
  111.    - fixed old bug in memory delocation routines (for temporary buffers),
  112.      which had not been used between V1.2 - V1.3, thus this bug might
  113.      obviously have been the reason, why V1.1 crashed with some
  114.      mysterious Exec-Gurus sometimes.
  115.  
  116.  
  117.   V1.3 (18.04.1994) :
  118.  
  119.    - MAJOR REVISION
  120.    - changed way of setting/handling Colors : now using ObtainColor()
  121.      and ReleaseColor().
  122.      Colors are released immediately after writing the graphics into
  123.      the BitMap, to allow any later displayed graphics to obtain their
  124.      own colors : otherwise no more colors would be free and they would
  125.      be displayed with the wrong colors.
  126.    - improved handling of 8 Bit graphics :
  127.  
  128.       - ECS/AGA emulation :
  129.     256 Color graphics usually will be displayed with some wrong colors,
  130.     which are actually obtained for the EGS-Display itself (Window
  131.     Borders, etc.) and cannot be changed by the application.
  132.     ChunkyPixel-Graphics with less than 256 Colors will be displayed
  133.     100% perfect as long as only unused Color-Registers are already
  134.     obtained by any applications.
  135.       - EGS Cards :
  136.     Due to the fact, that we are working with 24 Bit, all graphics
  137.     should be displayed with their 100% correct Colors.
  138.  
  139.    - added support for 24 Bit graphics :
  140.  
  141.       - ECS/AGA emulation :
  142.     24 Bit graphics are dithered to 256 Colors and should be displayed
  143.     in GreyScales usually (see notes concerning 256 Color graphics)
  144.       - EGS Cards :
  145.     24 Bit graphics are displayed in TrueColor
  146.  
  147.  
  148.   V1.2 (29.03.1994) :
  149.  
  150.    - small improvements :
  151.  
  152.       - now using SMART_REFRESH Window
  153.       - no longer Backdrop-Window
  154.       - fixed handling of Control-Window
  155.  
  156.    - with newer versions of the EGS-Libraries it should no longer crash
  157.      (tested with Version 15-Mar-1993, found on AmigaMagazin PD 4/93-4a/b)
  158.  
  159.  
  160.   V1.1 (17.03.1994) :
  161.  
  162.    - first version with the beginnings of rudimentary EGS-Support
  163.  
  164.  
  165.   Copyrights
  166.   ~~~~~~~~~~
  167.   Some of the mentioned names or products above may be copyrighted by
  168.   companies or trademarks of companies.
  169.  
  170.  
  171.