BMP.svobject

  © 1994 by Andreas R. Kleinert.

  FREEWARE. All rights reserved.

  Version      : 2.8
  Release Date : 11.06.1994


  Requirements
  ~~~~~~~~~~~~
  - OS V2.04+ (V37)+ and its libraries
  - superviewsupport.library V3+


  Description
  ~~~~~~~~~~~
  BMP.svobject is an external Library-Module for the superview.library V2+.

  It contains SVDriver-Support for the superview.library V3+, and
  needs any SVDriver with ChunkyPixel-Support.

  It supports reading and writing of Windows V3.00 BMP Files.
  In detail these are :

  Reading :

   - unencoded   BMP "wallpapers" in 1, 4, 8 or 24 Bit ColorDepth.
   - RLE-encoded BMP "wallpapers" in       8       Bit ColorDepth.


  Writing :

   Depending on the Colordepth of the source the following is written :

   Source Colors    Version      Type              Destination Colors

           2        BMP V3.00    packed chk. pix.      2
    4 ..  16        BMP V3.00    packed chk. pix.     16
   32 .. 256        BMP V3.00    chunky pixel        256
   (24 Bit)         BMP V3.00    RGB pixel         (24 Bit)


  Author
  ~~~~~~
  Andreas R. Kleinert
  Grube Hohe Grethe 23
  D-57074 Siegen
  Germany


  History
  ~~~~~~~
  V2.8 (11.06.1994) :

   - added code for reading and writing of (unpacked) 24 Bit Files
   - added code for reading RLE-encoded 8 Bit files (RLE8).
     (29 of 30 pictures caused no problems, and the last one might not have
      been written correctly ?!)
   - all BMP files are now written line-padded (longword-boundaries),
     if necessary and all line-padded files should now be read correctly
     (even more correctly than before :-)
   - (hey : V2.7 was written on 05.06.94, not 06.05.94 ... )


  V2.7 (05.06.1994) :

   - SVObject flags now reflect, that GfxBuffers can be written


  V2.6 (27.05.1994) :

   - now saving of GfxBuffers is possible : internal write routines have
     been completely rewritten, so that supplied Screens are transferred
     to GfxBuffers before saving. BitPlane AND OnePlane Buffers upto
     8 Bit are supported : they are converted to each other by using the
     appropriate functions of superviewsupport.library V3+.


  V2.5 (07.05.1994) :

   - use of SAS/C V6.51
   - use of new "superviewsupport.library" V1
     This saves some space again (here : ca. 1600 Bytes).
   - removed some unused variables in write-routine


  V2.4 (27.03.1994) :

   - removed internal SVDriver-Replacement, so that we now are really
     dependent on external SVDrivers in libs:svdrivers.
     This saves about 1600 Bytes diskspace and reduces redundancy.
   - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
     This saves again about 1800 Bytes.
   - now using Utility-Library for integer operations (activated
     SAS/C's UTILLIB option) : this increases 68000-codesize a little
     bit, but increases speed on 68020+ systems
     (should also decrease codesize, but does not ...)


  V2.3 (25.03.1994) :

   - slightly improved internal BitMap-to-BitMap routine
   - there occured some bugs with graphics, which had a width, that did not
     automatically implied longword-alignment :
     Now the inserted pad-bytes are read correctly for those files.


  V2.2 (17.03.1994) :

   - fixed "large memory usage" bug in internal ECS-ChunkyPixel routine
   - added several security checks (zero-pointers)
   - fixed bug in reading and writing of "Black & White" (2 Colors)
     BMP-Files, also changed docs (and revision notes) as far as affected
     by the bug-fix
   - note, that 4 Color BMP Files - following to the spefifications they
     do not exist - will neither be read nor be written (8; 2:2:2:2)
   - cleaned up some garbage in this doc-file ;)


  V2.1 (09.03.1994) :

   - now with SVDriver-Support. Not yet necessarily needed.
   - improved internal "Chunky Pixel to BitMap" (8 Bit) Routine
   - fixed some small bugs in reading : handling ColorMaps handled
     correctly now
   - writing routine(s) :
      - added code for writing 2 .. 256 Color graphics
      -   2 Colors are written as packed chunky pixel  (8; 1:1:1:1:1:1:1:1)
      -  16 Colors are written as packed chunky pixel  (8; 4:4)
      - 256 Colors are written as chunky pixel         (8; 8)
      - 4, 8, 32, 64 or 128 Colors are expanded to either
        16 or 256 Colors before writing
   - internal routines : AUTOSCROLL now really works with big-sized Screens
   - fixed small bug in memory management routines
   - fixed several little bugs


  V1.2 (26.01.1994) :

   - fixed code for recognition of "not supported" (future or 24-Bit) Files


  V1.1 (24.01.1994) :

   - first version


  Literature
  ~~~~~~~~~~
  [1] "Supercharged Bitmapped Graphics", Steve Rimmer, Windcrest/McGraw-Hill,
       © 1992 by Windcrest Books (registered Trademark of TAB Books).
       ISBN 0-8306-3788-5
  [2] "DOS Extra", Issue 4/1993, DMV-Verlag
  [3] "Das Handbuch der Grafikformate", Klaus Holtorf, © 1994 Franzis-Verlag
       GmbH, München
       ISBN 3-7723-6392-X


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