superviewsupport.library

  © 1994-95 by Andreas R. Kleinert.

  FREEWARE. All rights reserved.

  Version      : 6.9
  Release Date : 29.07.1995


  Description
  ~~~~~~~~~~~
  superviewsupport.library contains functions, which are heavily used
  by the superview.library and its SVObjects, SVDrivers and SVOperators.

  superviewsupport.library helps saving diskspace by just holding this
  functions for usage by the other libraries.


  There are also functions, which just might be useful for testing
  and debugging new modules or programs using superview.library.


  superviewsupport.library is mostly independent of the other Libraries yet.
  Nevertheless some of the functions also depend on other Libraries,
  like e.g. SVSUP_DisplayGfxBuffer(), which does SVDriver calls.


  Author
  ~~~~~~
  Andreas R. Kleinert
  Grube Hohe Grethe 23
  D-57074 Siegen
  Germany                   Andreas_Kleinert@superview.ftn.sub.org


  ControlPad-Switches
  ~~~~~~~~~~~~~~~~~~~
  ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  ControlPad-Commands : - C2P=<OS|SV>
                          ; determines, whether chunky to planar conversion
                          ; is managed via the appropriate OS functions
                          ; or via internal ones.
                          ; Due to various problems with the OS functions
                          ; "SV" is now default.
                          ; Be careful when using "OS" with GfxCards,
                          ; which carelessly patched graphics.library.

  History
  ~~~~~~~
  V6.9 (29.7.1995) :

   - as long as either PAL or NTSC is available, SVSUP_GetBestModeID()
     will no longer produce IDs using DEFAULT_MONITOR (mask 0x0000FFFF).
     Should help promoting PAL/NTSC to >31KHz.

  V6.8 (5.6.1995) :

   - using "C2P=OS" should again be saver now (no guarantee)
   - source buffer (copy) for c2p conversion now better aligned
     (was not aligned, 16 was required, now is 32 Bit aligned ;-)
   - removed old "cut off last upto 7 pixels" restriction.
     Seems to work now properly.
   - V39: aligned width of temporary BitMap to 32, although should
          be done by AllocBitMap(). Safer this way, if routines are patched.

  V6.7 (18.5.1995) :

   - new C2P routines had been buggy for "less than 256 color graphics"

  V6.6 (14.5.1995) :

   - wrote replacement for OS-dependent "chunky to planar" routines,
     which is now default due to the bugs/problems of the former ones
   - some functions did not handle A1 safely

  V6.5 (6.5.1995) :

   - slightly revised memory routines

  V6.4 (30.4.1995) :

   - fully recompiled with SAS/C V6.55
   - now saves A1 when opened/closed
   - prepared to safely handle conversion of GfxBuffers > V2
     (same problem, which would have caused several obsolete versions
      to produce garbage on copying V2 buffers).
     Will cut the version down to the lowest supported now.

  V6.3 (4.2.1995) :

   - fixed behaviour on library open errors when initializing

  V6.2 (25.1.1995) :

   - there was a bug in the ControlPad functions for modifying and
     adding: if an entry already existed it might have been allocated
     less memory than needed for the new entry (1 Byte).
     This caused an Enforcer-Hit claiming that 16 Bytes had been trashed.
     Usually would have crashed the system.

  V6.1 (13.11.1994) :

   - added seven new functions for VIRTUAL MEMORY handling

  V5.1 (29.10.1994) :

   - added three new functions for ControlPad support,
     as e.g. SVSUP_ModifyControlPad()  (-> Steve Quartly)

  V4.3 (28.09.1994) :

   - WritePixelLine8() sometimes seems to destroy the source buffer.
     Fixed now by using a copy of the corresponding line content.

  V4.2 (05.09.1994) :

   - created a workaround for the same "chunky pixel" bug as this has been
     done with the SVDriver-Release of superview.library 8.2
     (sooner or later guru'ed, if width had not been on byte boundary)

  V4.1 (26.06.1994) :

   - added two new functions for temporary displaying of GfxBuffers
     (e.g. for test-purposes) and one function for free'ing "stand-alone"
     GfxBuffers, which are not related to a SVObject-Handle.
   - fixed some bugs in the documentation, concerning the return values
     of the OnePlane/BitPlane-functions (not boolean, but SVERR_)
     and of SVSUP_AllocMemEntry()

  V3.1 (27.05.1994) :

   - added two new functions for converting ONEPLANE SV_GfxBuffers into
     BITPLANE SV_GfxBuffers and vice versa. Works with upto 8 Bit.
     (see SVSupport_Reference.doc)
   - added two new functions for converting Screens into ONEPLANE or
     BITPLANE SV_GfxBuffers. Works with upto 8 Bit.
     (see SVSupport_Reference.doc)

  V2.1 (22.05.1994) :

   - added four new functions for handling new, standardized "ControlPads"
     (see SVSupport_Reference.doc and ControlPad.doc)

  V1.1 (07.05.1994) :

   - first version with 13 functions yet (see SVSupport_Reference.doc)


  Copyrights
  ~~~~~~~~~~
  Some of the mentioned names or products above may be copyrighted by
  companies or trademarks of companies.