=============
 Description
=============

cpc2ilbm is a command-line ANSI C program to convert Amstrad CPC "Advanced OCP Art Studio" image files to IFF-ILBM format.

Advanced OCP Art Studio is a very popular Amstrad CPC graphics image format.
Each image consists of 2 files: a screen ".scr" file and a palette ".pal" file.
For example the screen file "raytrace.scr" will have a palette file named "raytrace.pal".

Output file format is uncompressed IFF-ILBM.

==============
 Requirements
==============

AmigaOS 3.0 or higher running on Motorola 680x0 based computers.
Alternatively an Amiga emulation package is required (Cloanto Amiga Forever recommended).

No particular installation is needed, you should be able to run the utility anywhere in your system.

Binary executable is provided in the "Bin" directory.

I have included few Amstrad CPC images in the "Images" directory.

==========
 Features
==========

* Supported Amstrad CPC screen modes:
    - MODE0 low resolution:    160 x 200 - 16 colours (rendered as 320x200x16)
    - MODE1 medium resolution: 320 x 200 -  4 colours (rendered as 320x200x4)
    - MODE2 high resolution:   640 x 200 -  2 colours (rendered as 640x200x2)

* Supported Amstrad CPC file formats:
    1) uncompressed linear screen (.scr) file, 16128 bytes and its palette (.pal) file, 367 bytes;
    2) uncompressed non linear screen (.scr) file, 16512 bytes and its palette (.pal) file, 367 bytes;
    3) standard format uncompressed non linear screen (.scr) file, 16384 bytes and its palette (.pal) file, 239 bytes;

    1) tested with files saved with ConvImgCpc Version 0.14
    2) tested with files saved with ConvImgCpc Version 0.79f
    3) not tested, at the moment I have no files to test it with, I am sorry I have never had Amstrad CPC

    ConvImgCPC V0.14 for Window$ is a GIF-JPG-BMP-WMF-SCR to Amstrad CPC graphics converter.
    ConvImgCPC V0.79f for Window$ is a GIF-JPG-BMP-WMF to Amstrad CPC graphics converter.
    These sometimes seem to create a buggy MODE0 16 colours .pal file.

* AmigaGuide documentation including a lot of related and interesting web links

* Source code supplied

* Few Amstrad CPC images supplied

* HTML Amstrad CPC documentation supplied ("CPC-Docs" directory)

==================
 Releases history
==================

* Version 1.0 released 30-Sep-2007, first public release.

========
 Author
========

Massimiliano Scarano
E-mail: mscarano@libero.it
Web site: http://it.dada.net/freeweb/massimilianoscarano/

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1720    2787  61.7% -lh5- fe12 Sep 30 10:09 cpc2ilbm.info
[generic]                 1086    2490  43.6% -lh5- 85fe Oct  2 09:00 cpc2ilbm/aminet_readme.txt
[generic]                10254   19452  52.7% -lh5- b196 Oct  2 09:02 cpc2ilbm/Bin/cpc2ilbm
[generic]                 4035   17430  23.1% -lh5- 227e Aug 30 11:24 cpc2ilbm/CPC-docs/Advanced OCP Art Studio File Formats.htm
[generic]                  206     568  36.3% -lh5- 1273 Aug 30 11:24 cpc2ilbm/CPC-docs/Advanced OCP Art Studio File Formats_file/arnold.css
[generic]                 5153   24495  21.0% -lh5- 5288 Aug 30 11:27 cpc2ilbm/CPC-docs/Amstrad CPC Gate-Array.htm
[generic]                  206     568  36.3% -lh5- 1273 Aug 30 11:27 cpc2ilbm/CPC-docs/Amstrad CPC Gate-Array_file/arnold.css
[generic]                 1537    8277  18.6% -lh5- 8d74 Aug 30 11:26 cpc2ilbm/CPC-docs/Display pixel data format.htm
[generic]                  206     568  36.3% -lh5- 1273 Aug 30 11:26 cpc2ilbm/CPC-docs/Display pixel data format_file/arnold.css
[generic]                 2441    6543  37.3% -lh5- 8dfb Oct  2 09:00 cpc2ilbm/cpc2ilbm.guide
[generic]                  226     468  48.3% -lh5- c639 Sep 30 10:09 cpc2ilbm/cpc2ilbm.guide.info
[generic]                   80     367  21.8% -lh5- 6ff1 Sep  2 09:35 cpc2ilbm/Images/clown0.pal
[generic]                11212   16512  67.9% -lh5- f54f Sep  2 09:35 cpc2ilbm/Images/clown0.scr
[generic]                   67     367  18.3% -lh5- b87a Sep  2 09:35 cpc2ilbm/Images/clown1.pal
[generic]                12387   16512  75.0% -lh5- 8c93 Sep  2 09:35 cpc2ilbm/Images/clown1.scr
[generic]                   61     367  16.6% -lh5- c400 Sep  2 09:56 cpc2ilbm/Images/sexygirl2.pal
[generic]                 7963   16128  49.4% -lh5- f065 Sep  2 09:56 cpc2ilbm/Images/sexygirl2.scr
[generic]                 5650   28440  19.9% -lh5- 3590 Oct  2 09:01 cpc2ilbm/Source/cpc2ilbm.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        18 files   64490  162339  39.7%            Oct  2 06:54