File Formats

What ANSI Paint opens and exports, in plain words. Files made in PabloDraw, Moebius, TheDraw and ACiDDraw open.

FormatAlso calledOpensExports
.ansANSIYesYes
.binBinaryTextYesYes
.xbXBINYesYes
.pngPNG imageConvertsYes
.gifGIF imageConverts, as a stillMovies

Open a file with Ctrl+O or the file picker. Dropping it onto the canvas works too.

.ans

The format every board shows. An .ans file is text: the characters come from CP437, the character set of the IBM PC, and the colors are set by ANSI escape sequences, short codes that start with the Escape character.

ANSI Paint exports .ans with minimal escape sequences and a full SAUCE record. Download .ans in the top bar makes the file.

.png

A picture of the piece, up to 16384 pixels a side, for places that show images and not .ans files.

A PNG is all pixels. The characters and colors are gone, so keep the .ans as well if you want to edit the piece again.

Image to ANSI goes the other way. Drop a PNG or JPG and it becomes half-blocks or shade blocks, or characters matched to the picture.

.bin

BinaryText. The screen and nothing else: two bytes for each cell, one for the character and one for its colors. There are no escape sequences and there is no header, so the file does not say how wide it is. The width travels in the SAUCE record.

.xb

XBIN. The same idea as BinaryText, with a header in front. The header records the width and the height, so the file describes itself.

A movie's .ans

An .ans that moves. A piece with more than one frame saves as an ANSI movie: the file clears the screen once, and every frame after that is cursor moves and the cells that changed. It has no clock. A board sends it at the caller's speed, so a pause is padding: bytes that draw nothing, counted for the speed the movie was made for, 9600 baud unless you pick another.

The SAUCE record says FileType 2 (ANSiMation), and a comment line in it carries the speed. The last cell of a full screen is never written, since some terminals scroll the moment it is.

.gif

An animated GIF of the movie that loops, for places that show images and not .ans files. It's made from the movie's own file, so it shows what the file plays, at the movie's speed.

Only a movie has it, and a movie's other exports hold one frame: .bin and .xb give the frame in front, and .png a picture of it.

SAUCE

SAUCE is a small record at the end of a file that says who made the piece and how to show it. Viewers and boards read it. ANSI Paint has a SAUCE editor, and writes each field the way the SAUCE specification says.

Title and author
The name of the piece and who drew it.
Group
The group it was released under.
Comments
Free lines of text that travel with the file.
iCE colors flag
Tells a viewer to show 16 background colors instead of blink.
Letter-spacing flag
Says whether the piece is meant for 8-pixel or 9-pixel character cells.
Aspect-ratio flag
Says whether the piece is meant for square pixels or for the taller pixels of a CRT.
Font name
Names the font the piece was drawn for.