home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / svobject-docs / bmp.doc < prev    next >
Encoding:
Text File  |  1994-07-04  |  5.0 KB  |  168 lines
  1.  
  2.   BMP.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.8
  9.   Release Date : 11.06.1994
  10.  
  11.  
  12.   Requirements
  13.   ~~~~~~~~~~~~
  14.   - OS V2.04+ (V37)+ and its libraries
  15.   - superviewsupport.library V3+
  16.  
  17.  
  18.   Description
  19.   ~~~~~~~~~~~
  20.   BMP.svobject is an external Library-Module for the superview.library V2+.
  21.  
  22.   It contains SVDriver-Support for the superview.library V3+, and
  23.   needs any SVDriver with ChunkyPixel-Support.
  24.  
  25.   It supports reading and writing of Windows V3.00 BMP Files.
  26.   In detail these are :
  27.  
  28.   Reading :
  29.  
  30.    - unencoded   BMP "wallpapers" in 1, 4, 8 or 24 Bit ColorDepth.
  31.    - RLE-encoded BMP "wallpapers" in       8       Bit ColorDepth.
  32.  
  33.  
  34.   Writing :
  35.  
  36.    Depending on the Colordepth of the source the following is written :
  37.  
  38.    Source Colors    Version      Type              Destination Colors
  39.  
  40.            2        BMP V3.00    packed chk. pix.      2
  41.     4 ..  16        BMP V3.00    packed chk. pix.     16
  42.    32 .. 256        BMP V3.00    chunky pixel        256
  43.    (24 Bit)         BMP V3.00    RGB pixel         (24 Bit)
  44.  
  45.  
  46.   Author
  47.   ~~~~~~
  48.   Andreas R. Kleinert
  49.   Grube Hohe Grethe 23
  50.   D-57074 Siegen
  51.   Germany
  52.  
  53.  
  54.   History
  55.   ~~~~~~~
  56.   V2.8 (11.06.1994) :
  57.  
  58.    - added code for reading and writing of (unpacked) 24 Bit Files
  59.    - added code for reading RLE-encoded 8 Bit files (RLE8).
  60.      (29 of 30 pictures caused no problems, and the last one might not have
  61.       been written correctly ?!)
  62.    - all BMP files are now written line-padded (longword-boundaries),
  63.      if necessary and all line-padded files should now be read correctly
  64.      (even more correctly than before :-)
  65.    - (hey : V2.7 was written on 05.06.94, not 06.05.94 ... )
  66.  
  67.  
  68.   V2.7 (05.06.1994) :
  69.  
  70.    - SVObject flags now reflect, that GfxBuffers can be written
  71.  
  72.  
  73.   V2.6 (27.05.1994) :
  74.  
  75.    - now saving of GfxBuffers is possible : internal write routines have
  76.      been completely rewritten, so that supplied Screens are transferred
  77.      to GfxBuffers before saving. BitPlane AND OnePlane Buffers upto
  78.      8 Bit are supported : they are converted to each other by using the
  79.      appropriate functions of superviewsupport.library V3+.
  80.  
  81.  
  82.   V2.5 (07.05.1994) :
  83.  
  84.    - use of SAS/C V6.51
  85.    - use of new "superviewsupport.library" V1
  86.      This saves some space again (here : ca. 1600 Bytes).
  87.    - removed some unused variables in write-routine
  88.  
  89.  
  90.   V2.4 (27.03.1994) :
  91.  
  92.    - removed internal SVDriver-Replacement, so that we now are really
  93.      dependent on external SVDrivers in libs:svdrivers.
  94.      This saves about 1600 Bytes diskspace and reduces redundancy.
  95.    - replaced SAS/C's sprintf()-routine with own, RawDoFmt()-based one.
  96.      This saves again about 1800 Bytes.
  97.    - now using Utility-Library for integer operations (activated
  98.      SAS/C's UTILLIB option) : this increases 68000-codesize a little
  99.      bit, but increases speed on 68020+ systems
  100.      (should also decrease codesize, but does not ...)
  101.  
  102.  
  103.   V2.3 (25.03.1994) :
  104.  
  105.    - slightly improved internal BitMap-to-BitMap routine
  106.    - there occured some bugs with graphics, which had a width, that did not
  107.      automatically implied longword-alignment :
  108.      Now the inserted pad-bytes are read correctly for those files.
  109.  
  110.  
  111.   V2.2 (17.03.1994) :
  112.  
  113.    - fixed "large memory usage" bug in internal ECS-ChunkyPixel routine
  114.    - added several security checks (zero-pointers)
  115.    - fixed bug in reading and writing of "Black & White" (2 Colors)
  116.      BMP-Files, also changed docs (and revision notes) as far as affected
  117.      by the bug-fix
  118.    - note, that 4 Color BMP Files - following to the spefifications they
  119.      do not exist - will neither be read nor be written (8; 2:2:2:2)
  120.    - cleaned up some garbage in this doc-file ;)
  121.  
  122.  
  123.   V2.1 (09.03.1994) :
  124.  
  125.    - now with SVDriver-Support. Not yet necessarily needed.
  126.    - improved internal "Chunky Pixel to BitMap" (8 Bit) Routine
  127.    - fixed some small bugs in reading : handling ColorMaps handled
  128.      correctly now
  129.    - writing routine(s) :
  130.       - added code for writing 2 .. 256 Color graphics
  131.       -   2 Colors are written as packed chunky pixel  (8; 1:1:1:1:1:1:1:1)
  132.       -  16 Colors are written as packed chunky pixel  (8; 4:4)
  133.       - 256 Colors are written as chunky pixel         (8; 8)
  134.       - 4, 8, 32, 64 or 128 Colors are expanded to either
  135.         16 or 256 Colors before writing
  136.    - internal routines : AUTOSCROLL now really works with big-sized Screens
  137.    - fixed small bug in memory management routines
  138.    - fixed several little bugs
  139.  
  140.  
  141.   V1.2 (26.01.1994) :
  142.  
  143.    - fixed code for recognition of "not supported" (future or 24-Bit) Files
  144.  
  145.  
  146.   V1.1 (24.01.1994) :
  147.  
  148.    - first version
  149.  
  150.  
  151.   Literature
  152.   ~~~~~~~~~~
  153.   [1] "Supercharged Bitmapped Graphics", Steve Rimmer, Windcrest/McGraw-Hill,
  154.        © 1992 by Windcrest Books (registered Trademark of TAB Books).
  155.        ISBN 0-8306-3788-5
  156.   [2] "DOS Extra", Issue 4/1993, DMV-Verlag
  157.   [3] "Das Handbuch der Grafikformate", Klaus Holtorf, © 1994 Franzis-Verlag
  158.        GmbH, München
  159.        ISBN 3-7723-6392-X
  160.  
  161.  
  162.   Copyrights
  163.   ~~~~~~~~~~
  164.   Some of the mentioned names or products above may be copyrighted by
  165.   companies or trademarks of companies.
  166.  
  167.  
  168.