Atari Graphics File Formats: Micro-Painter, Koala, Raw Screens and Interlace Pictures
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:
15becomes14, and79(mode F with the LMS bit) becomes78. 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 useGRAPHICS 15+16and 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
GETloop 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
- Picture: A 7,684-byte Micro-Painter-format test picture loaded by the BASIC program in this guide. — Program authors; screenshot by the site
- Antic v3n5 (Sept 1984) — Easy Graphic Converter, Charles Jackson (Micro-Painter 7684 bytes, colour bytes; Micro Illustrator INSERT/CLEAR raw save; formats) — AtariMagazines.com (Kevin Savetz), 1984
- Antic Nov 1985 — Rapid Graphics Converter listing (CONVERT.BAS): ten formats; Fun With Art, Visualizer, Micro Illustrator compressed-write code; required extensions — AtariMagazines.com (Kevin Savetz), 1985
- Antic v2n5 (Aug 1983) — Picture Utility (PICUTE), William Hough (paint pots = SETCOLOR 4,0,1,2 / 712,708,709,710) — AtariMagazines.com (Kevin Savetz), 1983
- Antic v2n4 (July 1983) — Microscreens column (Micropainter, Datasoft) — AtariMagazines.com (Kevin Savetz), 1983
- Antic v3n5 (Sept 1984) — Fader, Joseph P. Grande (.MIC extender) — AtariMagazines.com (Kevin Savetz), 1984
- Antic v3n5 (Sept 1984) — Unlocking the 56 graphic modes, Paul Chabot (mode table, GR.15(XL) 7680 bytes) — Paul Chabot, 1984
- Antic v5n10 (Feb 1987) — 130XE Slide Show, Bill Marquardt (7680+4 bytes, 4K boundary offset of 16) — AtariMagazines.com (Kevin Savetz), 1987
- Antic v7n7 (Nov 1988) — Product Reviews: RAMbrandt (Bard Ermentrout, modes 7, 7+, 9, 10, 11; loads Computereyes, MI, MP, Movie Maker) — AtariMagazines.com (Kevin Savetz), 1988
- Antic v8n2 (June 1989) — I/O Board (RAMbrandt can save Micro Illustrator format) — AtariMagazines.com (Kevin Savetz), 1989
- Antic v8n1 (May 1989) — New 8-Bit Power Tools (Atari View 8 saves Micropainter; .MIC; Rapid Graphics Converter) — AtariMagazines.com (Kevin Savetz), 1989
- AtariAge — Atari BASIC picture loading routine wanted (CIO block load, AtariArtist/Koala compressed .PIC, 30-36 vs 62 sectors) — AtariAge forum members
- AtariAge — WUDSN IDE thread: FAIL 1.0.1 list of 23 Atari image formats — AtariAge forum members
- AtariAge — GTIA mode 10 (and 11) (HIP/RIP use GTIA shifting; RIP: Gr.10 colour, Gr.9 luminance; HIP: both luminance) — AtariAge forum members
- AtariAge — Modern graphics modes guide? (APAC, HIP, RIP, TIP are software techniques) — AtariAge forum members
- AtariAge — A8 Sprite Multiplexer in 2022? (MIC = screen dump + colours 712,708,709,710; Graph2Font converts PNG to MIC) — AtariAge forum members, 2022
