The 2image conversion utility "2image.exe" converts an 8- or 24-bit color PCX picture into an AGAST image resource. Image resources are used for backgound images for scenes, or single frame sprites. When used as a sprite, any pure black will be transparent.

The picture must be of the following file formats:

• 8-bit per pixel (256-color) PCX file
• 24-bit per pixel (16.7-million-color) PCX file
• A single uncompressed RGBA layer from a Photoshop PSD file

Note: Some programs produce variations of PCX files which cannot be understood by 2image, and some programs give the user little control over palette indexing, making it difficult to create and save images with pure black pixels.

Since the compiler calls 2image, there is no need to directly run the program, although it is possible.

Command-Line

The command-line is used to pass the name of the input file. An input filename must have the pattern "*.image.pcx", and the output file will then be called "*.image".