Atari Graphics File Formats: Micro-Painter, Koala, Raw Screens and Interlace Pictures

A 160 by 192 four-colour Atari picture: green diagonal stripes on black, a purple ring around a gold disc, and a gold frame

Atari 8-bit pictures are mostly screen memory saved to disk, but in the 1980s every paint program had its own idea of colours, compression and headers, so magazines printed converter programs to move pictures between them. Today the same files turn up in disk images, and the modern scene has added a family of interlace formats that mix GTIA modes. This guide explains the common formats, shows how to tell them apart, and gives a tested BASIC program for loading the most common raw format.

What you'll learn: how a 7,680-byte screen is laid out, the Micro-Painter (.MIC) format and its colour bytes, raw .GR8/.GR9 dumps, the compressed Micro Illustrator/Koala .PIC format and its uncompressed variant, other 1980s formats such as Fun With Art and Visualizer, what APAC, HIP, RIP and TIP pictures are, and which tools convert between them.

What you need: Atari BASIC and an emulator for the loader. The H: device lets a program read files straight from a PC folder (atari800 -H1 <folder>, or Altirra's host device). Display Lists Explained and GTIA Graphics Modes 9, 10 and 11 cover the screen modes these formats store.

1. The 7,680-byte screen

Most full-screen Atari bitmaps are 40 bytes wide and 192 lines tall, so 7,680 bytes. The same block of memory means different things in different modes:

BASIC mode ANTIC mode Pixels Colours Bytes
GRAPHICS 8 F 320 × 192 1 hue, 2 luminances 7,680
GRAPHICS 15 (XL/XE OS) E 160 × 192 4 7,680
GRAPHICS 9, 10, 11 F + GTIA 80 × 192 16 shades / 9 colours / 16 hues 7,680

GRAPHICS 7 (ANTIC D) has the same 160-pixel, four-colour format but only 96 lines, so 3,840 bytes. A raw file of exactly 7,680 bytes tells you the size, but not the mode, and colours aren't included. That's why naming conventions grew up: .GR8 for a raw GRAPHICS 8 screen (320 × 192 mono) and .GR9 for a raw GRAPHICS 9 screen (80 × 192 greyscale) are standard extensions in modern viewers. On disk, a raw 8K picture takes about 62 sectors in DOS 2 format, a useful clue when you're looking at an unknown directory.

2. Micro-Painter: .MIC, 7,684 bytes

Datasoft's Micro-Painter produced the format that became the common currency of 1980s Atari art. Antic called these pictures "microscreens" and ran a reader-art column of that name from July 1983. A Micro-Painter file is:

  • bytes 0–7,679: the ANTIC mode E screen (160 × 192, four colours, two bits per pixel, 40 bytes per line, top line first), followed by
  • bytes 7,680–7,683: four colour bytes, in the order of the registers at 712, 708, 709, 710. That is, the background (pixel value 00) first, then the three playfield colours for pixel values 01, 10 and 11.

That order matches Micro-Painter's four "paint pots", which map to SETCOLOR 4, 0, 1 and 2. The .MIC extension became the convention: Antic's FADER slide show (September 1984) expected it, and so did later utilities. Because the format is just screen plus colours, it's also the easiest to produce from modern tools. Graph2Font converts PNG images to MIC, for example.

3. Loading a .MIC file from Atari BASIC

This program loads a Micro-Painter file straight into screen memory using a single CIO "get characters" call, then sets the colours from the last four bytes. It was tested on the XL OS with a 7,684-byte file read through H:. Change F$ to "D:NAME.MIC" for a disk.

10 REM MICRO-PAINTER .MIC LOADER
20 DIM F$(20):F$="H:TEST.MIC"
30 GRAPHICS 8+16:POKE 559,0
40 DL=PEEK(560)+256*PEEK(561)
50 FOR I=DL TO DL+199
60 A=PEEK(I):IF A=65 THEN 100
70 IF A=79 THEN POKE I,78:I=I+2:GOTO 90
80 IF A=15 THEN POKE I,14
90 NEXT I
100 FOR I=0 TO 7:READ A:POKE 1536+I,A:NEXT I
110 OPEN #1,4,0,F$
120 POKE 850,7:POKE 852,PEEK(88):POKE 853,PEEK(89)
130 POKE 856,0:POKE 857,30
140 X=USR(1536,16)
150 GET #1,A:POKE 712,A
160 FOR I=0 TO 2:GET #1,A:POKE 708+I,A:NEXT I
170 CLOSE #1:POKE 559,34
180 GOTO 180
190 DATA 104,104,104,170,32,86,228,96

How it works:

  • Lines 30–90 get an ANTIC mode E screen on any Atari. GRAPHICS 8+16 sets up a full-screen, 192-line, 7,680-byte display. The loop then changes every mode F instruction in its display list to mode E: 15 becomes 14, and 79 (mode F with the LMS bit) becomes 78. It skips the two address bytes after each LMS and stops at the jump instruction (65). Antic's 1983 "Microloader" used the same trick, starting from GRAPHICS 10. On an XL/XE you could use GRAPHICS 15+16 and drop lines 40–90. The patched version also works with the 400/800 OS, which has no GRAPHICS 15.
  • POKE 559,0 blanks the screen while it's being rebuilt, and POKE 559,34 turns it back on.
  • Lines 100 and 190 put an 8-byte routine in page 6: PLA, PLA, PLA, TAX, JSR $E456 (CIOV), RTS. USR(1536,16) passes 16, the offset of IOCB #1, in X.
  • Lines 120–130 fill in IOCB #1 at 848: command 7 (get characters) at 850, buffer address at 852/853 from SAVMSC (88/89), and length 7,680 (0 + 30 × 256) at 856/857. One call reads the whole screen at disk speed. A BASIC GET loop would take minutes.
  • Lines 150–160 read the colour bytes in file order into 712, 708, 709 and 710.

The OS lays out the GRAPHICS 8 screen so that its second LMS, at the 4K boundary, continues at the very next byte. The 7,680 bytes can therefore be read as one contiguous block, as the test confirmed. If you put a screen somewhere else yourself, remember that ANTIC can't cross a 4K boundary without a second LMS. Antic's 130XE Slide Show (February 1987) offset its pictures by 16 bytes for exactly this reason.

4. Micro Illustrator and Koala: .PIC

Micro Illustrator came in several versions for different input devices, from Tech-Sketch, Chalkboard and Koala, and Atari's AtariArtist cartridge for the Touch Tablet uses the same format. These programs save pictures compressed, with a header that includes the colours. That's why a "PIC" file is often only 30–40 sectors and loads as garbage with a raw loader.

The details that are documented:

  • Micro Illustrator had a second, hidden save. With the picture on screen, [INSERT] stores it uncompressed to a file called PICTURE, and [CLEAR] loads it back. That file is a raw 7,680-byte mode E screen with no colour bytes. Antic's 1984 Graphics Converter supplied default colours (red, green, blue and black) when converting one.
  • Compressed files are a stream of control bytes and data after the header. Antic's Rapid Graphics Converter (November 1985) wrote them using only literal blocks: a control byte of 128 plus a count (up to 127), followed by that many picture bytes, 60 blocks of 127 bytes and a final block of 60. Files saved by the paint programs themselves are much smaller than 7,680 bytes, because runs of repeated bytes are packed as well. Decoding them in BASIC is slow, so viewers use machine code.
  • The modern FAIL image library describes the format as "Koala MicroIllustrator, 160x192, 4 colors, compressed".

If you can't read a .PIC, convert it on a PC or with a period converter.

5. Other 1980s formats

Antic's Rapid Graphics Converter handled ten formats: Micro-Painter, Micro Illustrator/Koala, Fun With Art, Paint (Atari), Paint (Reston), Visualizer, Movie Maker, Graphics Master, AtariGraphics and Graphics Machine. Its listing shows how some of them differ from a plain .MIC:

Format File layout (from the converter's code)
Micro-Painter 7,680 screen bytes + 4 colours (712, 708, 709, 710)
Fun With Art (Epyx) 7,960 bytes: a 262-byte header with the four colours at offsets 2–5, the first 102 screen lines (4,080 bytes), 16 unused bytes, the last 90 lines (3,600 bytes), 2 trailing bytes
Visualizer 3,326 bytes: a 6-byte header (three colours, a zero, the background colour, one more byte), then 83 lines of 40 bytes taken from every other screen line
Movie Maker (Reston) background files need a .BKG extension
Paint (Atari, Reston) .PIC extension required
Graphics Machine .SCR extension required

Later paint programs often loaded several of these. RAMbrandt (Antic Catalog AP157, by Bard Ermentrout), "The Atari Design Studio", worked in GRAPHICS 7, 7+, 9, 10 and 11, loaded Computereyes, Micro Illustrator, Micro-Painter and Movie Maker pictures, and could save in Micro Illustrator format for colour printing. Atari View 8, a shareware utility reviewed in Antic in 1989, displayed GIF files and saved them as Micro-Painter files.

6. Modern formats: interlace pictures

In later years, especially in the demoscene, artists turned to software display modes. A kernel switches GTIA modes, colours or display data line by line, or alternates two frames, to show more colours or resolution than any single hardware mode. These are techniques, not hardware modes, and each needs its own viewer code, so each has its own file format. The FAIL (First Atari Image Library) project, whose 23 Atari formats were built into the WUDSN IDE's graphics editor, gives a good overview:

Extension Format
GR8 / GR9 Standard 320 × 192 mono / 80 × 192 greyscale
MIC Micro-Painter, 160 × 192, 4 colours
PIC Koala MicroIllustrator, 160 × 192, 4 colours, compressed
ILC APAC, 80 × 192, 256 colours, interlaced
AP3 80 × 192, 256 colours, interlaced
APC Any Point, Any Color, 80 × 96, 256 colours, interlaced
HIP Hard Interlace Picture, 160 × 200, greyscale
RIP Rocky Interlace Picture, up to 160 × 239
TIP Taquart Interlace Picture, up to 160 × 119
INP Interlace Picture, 160 × 200, 7 colours, interlaced
CIN / CCI Champions Interlace, 160 × 192 (CCI compressed)
MCP McPainter, 160 × 200, 16 colours, interlaced
INT INT95a, up to 160 × 239, 16 colours, interlaced
HR / HR2 Hires 256 × 239, 3 colours / 320 × 200, 5 colours, interlaced
PLM Plama 256, 80 × 96, 256 colours
CPR Trzmiel, 320 × 192 mono, compressed
CHR / FNT / SXS Character sets (8 × 8, 16 × 16)

APAC alternates GRAPHICS 9 (luminance) and GRAPHICS 11 (hue) lines to give 256 colours at 80-pixel resolution. HIP and RIP combine GRAPHICS 9 and GRAPHICS 10 data and exploit a pixel shift that GTIA produces in GRAPHICS 10, reaching 160 pixels across instead of 80. In HIP both modes carry luminance. In RIP, GRAPHICS 10 supplies the colour and GRAPHICS 9 the luminance. Graph2Font can build pictures that mix GTIA modes line by line, and RastaConverter produces near-photographic static pictures that need a lot of memory and CPU time to display.

Troubleshooting

  • The picture loads as random stripes. It's compressed (Koala/Micro Illustrator) or has a header (Fun With Art). Raw files are 7,680 or 7,684 bytes.
  • The shapes are right but the colours are wrong. You read a 7,680-byte file without colour bytes, or poked the four bytes in the wrong order. Micro-Painter's order is 712, 708, 709, 710.
  • The bottom part of the picture is garbled. Your own screen buffer crosses a 4K boundary without a second LMS.
  • Pixels look twice as wide and the picture is squashed. You displayed a mode E picture in GRAPHICS 8 (mode F). Patch the display list or use GRAPHICS 15.

Further reading

  • Antic, September 1984: "Easy Graphic Converter" by Charles Jackson (Micro-Painter, Micro Illustrator, Movie Maker, Fun With Art) and "Fader" by Joseph P. Grande.
  • Antic, November 1985: "Rapid Graphics Converter" by Charles Jackson, ten formats with full BASIC source.
  • Antic, August 1983: "Picture Utility" (PICUTE) by William Hough, for moving and annotating Micro-Painter pictures.
  • Antic, February 1987: "130XE Slide Show" by Bill Marquardt, for page-flipping Micro-Painter pictures in banked memory.
  • De Re Atari (Atari, Inc., 1982), chapters on ANTIC modes and GTIA, and Mapping the Atari (Ian Chadwick) for SAVMSC, the IOCBs and the colour registers.

Credits