=============
 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.

cpc2ilbm is platform independent.

==============
 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 320 x 200 x
16)
    - MODE1 medium resolution: 320 x 200 -  4 colours (rendered as 320 x 200 x 
4)
    - MODE2 high resolution:   640 x 200 -  2 colours (rendered as 640 x 200 x 
2)

* Supported Amstrad CPC file formats:
    - uncompressed linear screen (.scr) file, 16128 bytes (128 bytes header +
16000 bytes data) and its palette (.pal) file, 367 bytes (128 bytes header + 239
bytes data);       tested with files saved with ConvImgCpc Version 0.14
    - uncompressed non linear screen (.scr) file, 16512 bytes (128 bytes header
+ 16384 bytes data) and its palette (.pal) file, 367 bytes (128 bytes header +
239 bytes data);       tested with files saved with ConvImgCpc Version 0.79f    
- standard format uncompressed non linear screen (.scr) file, 16384 bytes (0
bytes header + 16384 bytes data) and its palette (.pal) file, 239 bytes (0 bytes
header + 239 bytes data);       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: mscaranolibero.it
Web site: http://it.dada.net/freeweb/massimilianoscarano/