home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / gfx / show / superview-lib / docs / svobject-docs / targa.doc < prev    next >
Text File  |  1994-07-04  |  4KB  |  124 lines
  1.  
  2.   Targa.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.  
  8.   Version      : 2.4
  9.   Release Date : 26.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.   Targa.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 Bitplane-/ChunkyPixel-Support.
  24.  
  25.   It supports reading of TGA (Truevision Targa) Files.
  26.   In detail these are :
  27.  
  28.   Reading :
  29.  
  30.    - monochrome Targa-Files (1 Bit, planar)
  31.    - Targa with 256 Colors (8 Bit)
  32.      (files without ColorMap are displayed in grey-scales)
  33.    - Targa 24 Bit-Files
  34.  
  35.   Writing :
  36.  
  37.    Depending on the Colordepth of the source the following is written :
  38.  
  39.    Source Colors    Type                           Destination Colors
  40.  
  41.     2 .. 256        Uncompressed chunky pixel         256
  42.     (24 Bit)        Uncompressed BGR                 (24 Bit)
  43.  
  44.  
  45.   Remarks
  46.   ~~~~~~~
  47.    - Currently files with Colorbits other than 1, 8 or 24 (16, 32)
  48.      are not supported yet.
  49.    - ColorMaps have to be of type "3-Byte RGB".
  50.    - RLE-encoded files are rejected yet.
  51.    - The flags for "mirroring" Images vertically and/or horizontally
  52.      are nut fully interpreted yet, nevertheless they are checked and
  53.      reported via SVL_FileInfoRequest().
  54.      If the VERTINV flag is not set, the picture will be assumed to
  55.      be written as "from bottom to top", otherwise as "from top to
  56.      bottom". Some programs do not set these flags right, when writing,
  57.      so that you might get just the opposite result as expected.
  58.      The HORIZINV flag is currently ignored : when reading such a picture
  59.      as usual, you'd get a mirrored image. But this flags is also set
  60.      wrong sometimes ...
  61.  
  62.  
  63.   Author
  64.   ~~~~~~
  65.   Andreas R. Kleinert
  66.   Grube Hohe Grethe 23
  67.   D-57074 Siegen
  68.   Germany
  69.  
  70.  
  71.   History
  72.   ~~~~~~~
  73.   V2.4 (26.06.1994) :
  74.  
  75.    - fixed small bug, which might have caused this one crashing/rejecting,
  76.      when writing from a Screen (instead of a GfxBuffer).
  77.  
  78.  
  79.   V2.3 (12.06.1994) :
  80.  
  81.    - now also writes Targa files (all input converted to either 8 or 24 Bit)
  82.    - now also reads monochrome pictures with pixelbits value of 1 (planar)
  83.    - files with no VERTINV set are now converted (top becomes bottom)
  84.    - changed way of file-recognition : files with unknown flags are now
  85.      read as if theses flags would not have been set. This may cause
  86.      problems with files, which depend on correct interpretation of those
  87.      flags, but often they are written wrong, so that this might have
  88.      caused files to be rejected. Now we check an other Byte-combination
  89.      for plausibility reasons.
  90.  
  91.  
  92.   V2.2 (22.05.1994) :
  93.  
  94.    - removed some unused debugging code : this was accidentally called
  95.      always, when a picture has been loaded.
  96.      This did not crash the program, but always caused a requester, which
  97.      had to be confirmed by the User.
  98.  
  99.  
  100.   V2.1 (22.05.1994) :
  101.  
  102.    - first version
  103.  
  104.  
  105.   Literature
  106.   ~~~~~~~~~~
  107.   [1] "Bitmapped Graphics", 2nd Edition, Steve Rimmer, Windcrest/McGraw-Hill,
  108.        © 1993 by Windcrest Books (registered Trademark of TAB Books).
  109.        ISBN 0-8306-4209-9
  110.   [2] "Supercharged Bitmapped Graphics", Steve Rimmer, Windcrest/McGraw-Hill,
  111.        © 1992 by Windcrest Books (registered Trademark of TAB Books).
  112.        ISBN 0-8306-3788-5
  113.   [3] "Das Handbuch der Grafikformate", Klaus Holtorf, © 1994 Franzis-Verlag
  114.        GmbH, München
  115.        ISBN 3-7723-6392-X
  116.   [4] (there was more literature, but I didn't actually need it ;-)
  117.  
  118.  
  119.   Copyrights
  120.   ~~~~~~~~~~
  121.   Some of the mentioned names or products above may be copyrighted by
  122.   companies or trademarks of companies.
  123.  
  124.