Introduction

 This is yet another datatype for IFF ILBM pictures. I recently
 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 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.



 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.

 Copy Classes/Datatypes/ilbm.datatype Sys:Classes/Datatypes/
 Copy Devs/Datatypes/ILBM Devs: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. 
 

  Datatypes.library 45.4

   That version of datatypes.library doesn't like the ILBM
   descriptor from this package. In this case, use the ILBM
   descriptor (in DEVS:Datatypes) that comes with the OS.
   Other versions of datatypes.library tested so far 
   (V40,V46,V47) are not affected.



 CPU compatibility

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

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 3399    5900  57.6% -lh5- 8f2d Mar 20 19:22 ILBMdt/C/fixiff
[unknown]                 5949   11852  50.2% -lh5- 2c25 Mar 20 19:20 ILBMdt/Classes/Datatypes/ilbm.datatype
[unknown]                  268     306  87.6% -lh5- 5f85 Mar 20 19:20 ILBMdt/Devs/Datatypes/ILBM
[unknown]                  281     467  60.2% -lh5- c6c4 Feb 12 00:03 ILBMdt/Devs/Datatypes/ILBM.info
[unknown]                 3199   18630  17.2% -lh5- 98cf Feb 14 23:40 ILBMdt/Source/p2c_asm.s
[unknown]                  748    3729  20.1% -lh5- a174 Feb  5 09:05 ILBMdt/Source/p2c_c.c
[unknown]                  187     308  60.7% -lh5- 3a6c Feb  5 08:52 ILBMdt/Source/p2c_c.h
[unknown]                  336     561  59.9% -lh5- f9db Mar 30 20:05 ILBMdt/Source/releasenotes
[unknown]                  506     939  53.9% -lh5- dc96 Feb  1 16:35 ILBMdt/Source/rtgtest.c
[unknown]                  182     276  65.9% -lh5- 982f Jan 27 23:49 ILBMdt/Source/rtgtest.h
[unknown]                  266     459  58.0% -lh5- bfbb Feb  9 18:14 ILBMdt/Source/unpackrow_asm.h
[unknown]                 1343    4322  31.1% -lh5- ca27 Feb 11 23:41 ILBMdt/Source/unpackrow_asm.s
[unknown]                  836    1810  46.2% -lh5- c73b Feb 22 11:43 ILBMdt/Source/unpackrow_c.c
[unknown]                  207     385  53.8% -lh5- 0925 Feb  7 23:29 ILBMdt/Source/unpackrow_c.h
[unknown]                  789    1786  44.2% -lh5- 7acf Feb 11 19:31 ILBMdt/Source/dispatch.c
[unknown]                  119     174  68.4% -lh5- 3a64 Jun 20  2020 ILBMdt/Source/dispatch.h
[unknown]                  486    1022  47.6% -lh5- 7fc2 Feb 21 23:39 ILBMdt/Source/dtdesc.asm
[unknown]                 1049    2059  50.9% -lh5- 2cde Feb 22 19:46 ILBMdt/Source/dthook.asm
[unknown]                 6706   19547  34.3% -lh5- c676 Feb 22 10:52 ILBMdt/Source/fixiff.c
[unknown]                 1208    3394  35.6% -lh5- 6b84 Feb 20 23:14 ILBMdt/Source/fixiff.h
[unknown]                  532    1472  36.1% -lh5- abdd Feb  2 22:24 ILBMdt/Source/ham2rgb24.c
[unknown]                  200     289  69.2% -lh5- b472 Feb  1 13:33 ILBMdt/Source/ham2rgb24.h
[unknown]                  120     209  57.4% -lh5- a3e1 Mar  3 20:58 ILBMdt/Source/ilbm.datatype_rev.h
[unknown]                  134     255  52.5% -lh5- fafc Mar  3 20:58 ILBMdt/Source/ilbm.datatype_rev.i
[unknown]                    2       2 100.0% -lh0- f794 Mar  3 20:58 ILBMdt/Source/ilbm.datatype_rev.rev
[unknown]                 9051   34133  26.5% -lh5- 0103 Mar 30 20:07 ILBMdt/Source/loadimage.c
[unknown]                  444     892  49.8% -lh5- 692b Feb  4 18:09 ILBMdt/Source/loadimage.h
[unknown]                  252     585  43.1% -lh5- e845 Feb  9 18:08 ILBMdt/Source/p2c_asm.h
[unknown]                 1402    2783  50.4% -lh5- 1a28 Mar 30 20:04 ILBMdt/ILBMdt.readme
[unknown]                 1644    5100  32.2% -lh5- 2698 Feb 11 19:41 ILBMdt/Source/classbase.c
[unknown]                  689    2528  27.3% -lh5- ab56 Feb 11 19:29 ILBMdt/Source/classbase.h
[unknown]                  724    1368  52.9% -lh5- 5e6b Jun 20  2020 ILBMdt/Source/classheader.c
[unknown]                  796    1843  43.2% -lh5- eee3 Feb  8 14:18 ILBMdt/Source/classinit.c
[unknown]                  667    1551  43.0% -lh5- 4c04 Jun 19  2020 ILBMdt/Source/compiler.h
[unknown]                  230     361  63.7% -lh5- 5e20 Jun 19  2020 ILBMdt/Source/debug.h
[unknown]                  707    1401  50.5% -lh5- aefc Mar  2 20:20 ILBMdt/Source/Makefile
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        36 files   45658  132698  34.4%            Mar 30 20:49