home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Assembler / dse-src3.dms / in.adf / Utilities / IffConverters / IFFConvert.lha / IFFConvert / iffconvert.doc < prev    next >
Encoding:
Text File  |  1992-07-24  |  3.6 KB  |  107 lines
  1.  
  2.  
  3.  
  4.  
  5.                           IFF-Convert User's Guide
  6.  
  7.                           Version 1.11 - June 1992
  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 1992 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.
  54.  
  55.  
  56.    5 - Usage
  57.    ~~~~~~~~~
  58.    Pictures are loaded width the "Load" menu. Then you can save the pictures
  59.    using the different methods just by selecting the corresponding
  60.    submenu of "Save".
  61.  
  62.  
  63.    6 - New compression format
  64.    ~~~~~~~~~~~~~~~~~~~~~~~~~~
  65.    The new compression method does not compress row by row but column by
  66.    column. Each column has a width of 1 byte (8 pixel). First the 1st
  67.    column of the 1st bitplane is compressed, then the 1st column of the
  68.    2nd bitplane and so on.
  69.    The new compression format is marked with 2 in the compression field
  70.    of BMHD. The new format is very similar to the old compression format.
  71.    It is as follows:
  72.       The first byte v is a control byte. The values have the following
  73.       meaning:
  74.          v>=0:   v+1 uncompressed bytes are following
  75.          v<0:    the next byte is repeated -v+1 times
  76.          v=-128: The next unsigned (!) byte is the number of bytes that
  77.                  has to be copied from the column left of this column of
  78.                  the same bitplane.
  79.  
  80.       NOTE: never compress across the borders of the columns, like it was
  81.             not allowed in the old format to compress across the rows.
  82.  
  83.  
  84.    7 - History
  85.    ~~~~~~~~~~~
  86.    V 1.0: First beta release
  87.  
  88.    V 1.1: Bugs according to other systemfonts than topaz 8 fixed.
  89.           IFF-Convert now uses the reqtools.library for the
  90.           filerequester.
  91.  
  92.    V1.11: Minor bugfixes
  93.  
  94.  
  95.    8 - Notes
  96.    ~~~~~~~~~~
  97.    Bug reports, suggestions, postcards, flames, criticism, contributions,
  98.    ideas, gifts, etc., etc., etc........... to:
  99.  
  100.  
  101.                      Matthias Meixner
  102.                      Sandberg 13
  103.                      W-6417 Hofbieber 2
  104.                      Germany
  105.  
  106.  
  107.