home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d945 / iffconvert.lha / IFFConvert / iffconvert.doc < prev    next >
Text File  |  1993-12-20  |  4KB  |  110 lines
  1.  
  2.  
  3.  
  4.  
  5.                           IFF-Convert User's Guide
  6.  
  7.                           Version 1.12 - April 1993
  8.  
  9.  
  10.                         Written by Matthias Meixner
  11.  
  12.                    Copyright (c) 1992 by Matthias Meixner
  13.                            All rights reserved
  14.                           Not for commercial use
  15.  
  16.  
  17.  
  18.  
  19.    1- Disclaimer
  20.    ~~~~~~~~~~~~~
  21.    The author cannot be held liable for the suitability or accuracy of this
  22.    manual and/or the program(s) it describes.  Any damage directly or
  23.    indirectly caused by the use or misuse of this manual and/or the program
  24.    it describes is the sole responsibility of the user her/him self.
  25.  
  26.  
  27.    2 - Copyright/Distribution
  28.    ~~~~~~~~~~~~~~~~~~~~~~~~~~
  29.    IFF-Convert, (c) Copyright 1993 Matthias Meixner. All rights reserved.
  30.    This Program is FREEWARE, so no financial donations are required (but
  31.    welcome). This program may be freely distributed as long as all
  32.    documentation and executable(s) remain unchanged and are included with
  33.    the distribution. Also no profit is to be made by selling this program.
  34.    Iff-Convert must not be added to other PD-libraries than AmigaLibDisks
  35.    from Fred Fish without my written permission. The price must not exceed
  36.    the costs of disk, package and mailing.
  37.  
  38.  
  39.    3 - Introduction
  40.    ~~~~~~~~~~~~~~~~
  41.    IFF-Convert is used to convert the different compression methods of
  42.    IFF-ILBM files. It supports the normal compression (like D'Paint),
  43.    a new compression method (see documentation) and uncompressed files.
  44.    The new compression method has a better compression ratio than the
  45.    old format, and even a 2nd compress with (for example) archivers is
  46.    improved, because the data is sorted in a new way.
  47.  
  48.  
  49.    4 - System requirements
  50.    ~~~~~~~~~~~~~~~~~~~~~~~
  51.    IFF-Convert will run on any Amiga system with at least 512KB RAM an one
  52.    diskdrive. It requires reqtools.library that is Copyright (c) Nico
  53.    François. It has been tested with OS3.0, but it should run on OS1.2 as
  54.    well.
  55.  
  56.  
  57.    5 - Usage
  58.    ~~~~~~~~~
  59.    Pictures are loaded width the "Load" menu. Then you can save the pictures
  60.    using the different methods just by selecting the corresponding
  61.    submenu of "Save".
  62.  
  63.  
  64.    6 - New compression format
  65.    ~~~~~~~~~~~~~~~~~~~~~~~~~~
  66.    The new compression method does not compress row by row but column by
  67.    column. Each column has a width of 1 byte (8 pixel). First the 1st
  68.    column of the 1st bitplane is compressed, then the 1st column of the
  69.    2nd bitplane and so on.
  70.    The new compression format is marked with 2 in the compression field
  71.    of BMHD. The new format is very similar to the old compression format.
  72.    It is as follows:
  73.       The first byte v is a control byte. The values have the following
  74.       meaning:
  75.          v>=0:   v+1 uncompressed bytes are following
  76.          v<0:    the next byte is repeated -v+1 times
  77.          v=-128: The next unsigned (!) byte is the number of bytes that
  78.                  has to be copied from the column left of this column of
  79.                  the same bitplane.
  80.  
  81.       NOTE: never compress across the borders of the columns, like it was
  82.             not allowed in the old format to compress across the rows.
  83.  
  84.  
  85.    7 - History
  86.    ~~~~~~~~~~~
  87.    V 1.0: First beta release
  88.  
  89.    V 1.1: Bugs according to other systemfonts than topaz 8 fixed.
  90.           IFF-Convert now uses the reqtools.library for the
  91.           filerequester.
  92.  
  93.    V1.11: Minor bugfixes
  94.    V1.12: New support for 256-Color / Ham8 Pictures
  95.  
  96.  
  97.    8 - Notes
  98.    ~~~~~~~~~~
  99.    Bug reports, suggestions, postcards, flames, criticism, contributions,
  100.    ideas, gifts, etc., etc., etc........... to:
  101.  
  102.  
  103.                      Matthias Meixner
  104.                      Sandberg 13
  105.                      W-6417 Hofbieber 2
  106.                      Germany
  107.  
  108.    EMail:            meixner@rbg.informatik.th-darmstadt.de
  109.  
  110.