Introduction

 This is yet another datatype for IFF ILBM pictures. My primary
 motivatior for this datatype is that I ran into some issues 
 loading a number of IFF pictures by my favorite datatypes 
 based viewer and decided to find a solution for these pictures.

 This ILBM datatype supports 1-8 bitplanes including EHB and HAM
 in V42 (non RTG) mode. In presence of RTG and/or picture.datatype 
 V43 or later, 24 Bit images are supported as well. In addition,
 planar color mapped data and HAM images are loaded into FastRAM 
 and internally promoted to chunky representation with active RTG 
 in order to conserve ChipRAM. Some routines are implemented in 
 Assembler to provide a good loading speed.

 This datatype also handles some of the known issues with ILBM
 images generated by certain software like Adobe Photoshop.

 In addition to regular ILBM images, this datatype also provides
 support for dynamic palettes which are generated by tools like
 HAMLab or HAM_convert into PCHG or SHAM chunks.


 Installation

 At most two files need to be copied for installation: the
 datatypes descriptor (ILBM) and the datatype class 
 (ilbm.datatype). You might want move the existing files to
 a safekeeping place (e.g. SYS:Storage/Datatypes/). A reboot
 is usually required to enable the new datatype.

 From CLI:
 Copy Classes/Datatypes/ilbm.datatype Sys:Classes/Datatypes/
 Copy Devs/Datatypes/ILBM Devs:Datatypes/

 From WB:
 Drag the ILBM icon from Devs/Datatypes of this distribution
 to SYS:Devs/Datatypes and drag Classes/Datatypes/ilbm.datatype
 to SYS:Classes/Datatypes.


 Troubleshooting

  Malformed IFF ILBM files

   Some slightly malformed IFF ILBM files are known that they 
   can be loaded in popular imaging programs but sometimes fail 
   to be recognised by datatypes. In such cases, stringent checks
   in Datatypes.library and IFFParse.library alongside the 
   requirement to actually rely on these two libraries prevent 
   the invocation of ilbm.datatype. 

   This package contains a commandline tool called "fixiff"
   which is able to fix some commonly encountered problems with
   IFF ILBM files. It takes two arguments. The first argument
   is the input file and the second argument is the resulting
   copy.

   Example: fixiff Workbench:broken_iff.iff ram:fixed_iff.iff

   The fixiff tool will correct incorrect IFF FORM header sizes,
   convert out-of-spec run-length encoding to valid encoding,
   trim extra data and fill up incomplete BODY data with zeros. 

   The latest fixiff got two additional switches: 
   NOMASK will omit the mask in the output 
   ADDGRAB converts a masked picture into a brush.


 CPU compatibility

 The datatype is an all-in-one binary for any 68k Amiga. Some
 68020+ optimizations are enabled at runtime, if applicable.



 History
 47.6 - dynamic HiRes and dynamic HAM support (PCHG,SHAM) by
        promoting such images to 24 bit (V43 picture.datatype)

 47.5 - Mask support in 24 Bit mode
      - Transparency masks will only be handed to picture.datatype
        for brush type IFFs (i.e. some pictures contain a mask plane
	that is actually a drawing stencil)

 47.4 - Replaced Datatypes descriptor (DEVS:Datatypes/ILBM) by
        a different variant that relies on pattern matching 
	instead of detection code. This fixes issues with
	clipboard operations. Datatypes.library 45.4 now likes
	the new descriptor, too.

 47.3 - first Aminet release

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  261     516  50.6% -lh5- 551a Jul 31 10:22 ILBMdt/Classes/Datatypes.info
[unknown]                 7834   15560  50.3% -lh5- 5b74 Dec 22 08:11 ILBMdt/Classes/Datatypes/ilbm.datatype
[unknown]                  261     516  50.6% -lh5- 551a Jul 31 10:22 ILBMdt/Devs/Datatypes.info
[unknown]                  141     168  83.9% -lh5- ddf3 Dec 22 08:09 ILBMdt/Devs/Datatypes/ILBM
[unknown]                  281     467  60.2% -lh5- c6c4 Jul 31 10:22 ILBMdt/Devs/Datatypes/ILBM.info
[unknown]                 1769    7488  23.6% -lh5- 2eac Dec 20 15:38 ILBMdt/Source/pchg.c
[unknown]                  921    2373  38.8% -lh5- 8cad Dec 21 10:49 ILBMdt/Source/pchg.h
[unknown]                  659    1230  53.6% -lh5- 9c67 Dec 22 08:03 ILBMdt/Source/releasenotes
[unknown]                  506     939  53.9% -lh5- dc96 Jul 31 10:22 ILBMdt/Source/rtgtest.c
[unknown]                  182     276  65.9% -lh5- 982f Jul 31 10:22 ILBMdt/Source/rtgtest.h
[unknown]                  266     459  58.0% -lh5- bfbb Jul 31 10:22 ILBMdt/Source/unpackrow_asm.h
[unknown]                 1343    4322  31.1% -lh5- ca27 Jul 31 10:22 ILBMdt/Source/unpackrow_asm.s
[unknown]                  836    1810  46.2% -lh5- c73b Jul 31 10:22 ILBMdt/Source/unpackrow_c.c
[unknown]                  207     385  53.8% -lh5- 0925 Jul 31 10:22 ILBMdt/Source/unpackrow_c.h
[unknown]                 1049    2059  50.9% -lh5- 2cde Jul 31 10:22 ILBMdt/Source/dthook.asm
[unknown]                 7234   21235  34.1% -lh5- 788f Dec 22 08:05 ILBMdt/Source/fixiff.c
[unknown]                 1391    3867  36.0% -lh5- 86ef Sep  7 13:11 ILBMdt/Source/fixiff.h
[unknown]                  613    1759  34.8% -lh5- ca1b Dec 19 20:09 ILBMdt/Source/ham2rgb24.c
[unknown]                  213     369  57.7% -lh5- 3273 Dec 19 20:05 ILBMdt/Source/ham2rgb24.h
[unknown]                  122     215  56.7% -lh5- 49a4 Dec 22 08:09 ILBMdt/Source/ilbm.datatype_rev.h
[unknown]                  135     261  51.7% -lh5- 22fa Dec 22 08:09 ILBMdt/Source/ilbm.datatype_rev.i
[unknown]                    2       2 100.0% -lh0- a797 Dec 22 08:09 ILBMdt/Source/ilbm.datatype_rev.rev
[unknown]                10871   44453  24.5% -lh5- c622 Dec 22 08:07 ILBMdt/Source/loadimage.c
[unknown]                  528    1067  49.5% -lh5- 8916 Dec 20 09:20 ILBMdt/Source/loadimage.h
[unknown]                  294     653  45.0% -lh5- 1756 Jul 31 10:22 ILBMdt/Source/p2c_asm.h
[unknown]                 4531   25828  17.5% -lh5- 23fe Jul 31 10:22 ILBMdt/Source/p2c_asm.s
[unknown]                  748    3729  20.1% -lh5- a174 Jul 31 10:22 ILBMdt/Source/p2c_c.c
[unknown]                  187     308  60.7% -lh5- 3a6c Jul 31 10:22 ILBMdt/Source/p2c_c.h
[unknown]                 3664    6476  56.6% -lh5- 8155 Dec 22 08:11 ILBMdt/C/fixiff
[unknown]                 1784    3658  48.8% -lh5- f9d2 Dec 22 08:30 ILBMdt/ILBMdt.readme
[unknown]                 1644    5100  32.2% -lh5- 2698 Jul 31 10:22 ILBMdt/Source/classbase.c
[unknown]                  689    2528  27.3% -lh5- ab56 Jul 31 10:22 ILBMdt/Source/classbase.h
[unknown]                  724    1368  52.9% -lh5- 5e6b Jul 31 10:22 ILBMdt/Source/classheader.c
[unknown]                  796    1843  43.2% -lh5- eee3 Jul 31 10:22 ILBMdt/Source/classinit.c
[unknown]                  667    1551  43.0% -lh5- 4c04 Jul 31 10:22 ILBMdt/Source/compiler.h
[unknown]                  246     428  57.5% -lh5- caaf Aug 29 12:45 ILBMdt/Source/debug.h
[unknown]                  789    1786  44.2% -lh5- 7acf Jul 31 10:22 ILBMdt/Source/dispatch.c
[unknown]                  119     174  68.4% -lh5- 3a64 Jul 31 10:22 ILBMdt/Source/dispatch.h
[unknown]                  623    1337  46.6% -lh5- 4fbe Nov 28 15:32 ILBMdt/Source/dtdesc.asm
[unknown]                  486    1022  47.6% -lh5- 7fc2 Jul 31 10:22 ILBMdt/Source/dtdesc_binary.asm
[unknown]                  247     402  61.4% -lh5- 51ae Dec 21 10:44 ILBMdt/Source/FastDecomp.h
[unknown]                  930    2426  38.3% -lh5- 8b1b Dec 22 07:59 ILBMdt/Source/FastDecomp.s
[unknown]                  775    1552  49.9% -lh5- 93fc Dec 22 08:11 ILBMdt/Source/Makefile
[unknown]                  259     516  50.2% -lh5- 2f1b Jul 31 10:22 ILBMdt.info
[unknown]                  256     516  49.6% -lh5- 05b0 Jul 31 10:22 ILBMdt/Classes.info
[unknown]                  259     516  50.2% -lh5- 85c7 Jul 31 10:22 ILBMdt/Devs.info
[unknown]                  272     514  52.9% -lh5- 84ea Jul 31 10:22 ILBMdt/ILBMdt.readme.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        47 files   58614  176027  33.3%            Dec 23 04:00