Introduction

Welcome to the ANSI Art Gallery.

In 1983, if someone had told you that your home computer could display photographic images, you would have laughed. Computers showed text—green letters on black screens, maybe amber if you were fancy. Graphics required expensive specialized hardware: Apple IIe High-Resolution mode gave you six colors at 280×192 pixels, and that was considered impressive.

Yet here we are. The ANSI Art Gallery converts modern photographs and artwork into authentic ANSI graphics that display on any terminal—even a 1978 VT100—in full color. What once seemed impossible is now routine, and it works using nothing but the colored text characters that bulletin board operators first experimented with in the early 1980s.

The technology is deceptively simple. In 1979, the American National Standards Institute published X3.64, a standard for terminal control codes. Escape sequences—strings of characters beginning with ESC—could now change text color, position the cursor, and control display attributes. These tools were designed for things like highlighting menu selections or coloring error messages. But creative programmers realized they could do something the standards committee never imagined: paint pictures with text.

The ANSI Art Gallery represents the culmination of this technique. Each image is converted in real-time using Floyd-Steinberg dithering—a 1976 algorithm that spreads quantization errors to neighboring pixels, creating smooth gradients from a limited palette. Half-block characters (▀) let us pack two vertical pixels into each character cell, effectively doubling resolution. And the 256-color extended palette gives us 216 distinct colors to work with—more than enough to reproduce photographs with startling fidelity.

The result is imagery that would have seemed like science fiction to early BBS users, displayed with the authentic progressive line-by-line reveal that made downloading graphics over a 300 baud modem such an exercise in anticipation. At 30 characters per second, a 48-line image takes almost a minute to appear—plenty of time to wonder what you're about to see.

Features of the ANSI Art Gallery:

• Native .ANS file support for authentic BBS-era ANSI artwork
• Real-time PNG to ANSI conversion with Floyd-Steinberg dithering
• Progressive line-by-line display simulating modem speeds
• Half-block character rendering for enhanced vertical resolution
• Full 256-color palette support (6×6×6 color cube plus grayscale)
• Simple menu-driven interface
• VT100/ANSI terminal compatibility

Quick Start

To view your first ANSI artwork:

1. Dial in: ATDT555-0200
2. View the gallery: The main screen shows numbered artwork
3. Select an image: Type a number (1-9) and press ENTER
4. Watch the reveal: The image renders line-by-line, just like on early modems
5. Return to gallery: Press M when viewing is complete
6. Exit: Press Q to disconnect

GETTING CONNECTED

To access the ANSI Art Gallery, configure your modem and dial:

ATDT555-0200

Upon successful connection, you will see the gallery welcome screen:

Terminal Requirements

For optimal ANSI art viewing, configure your terminal as follows:

BROWSING THE GALLERY

The gallery presents a numbered list of available artwork. Each entry shows:

• Number — Selection key for viewing the image
• Title — Name of the artwork
• Description — Brief description of the image content

Available Artwork

Image Types

The gallery supports two types of artwork:

ANS — Native ANSI Art Files

The gallery can display .ANS files directly. These are authentic ANSI art files from the BBS scene, created by hand or with dedicated ANSI editors like TheDraw and PabloDraw. The files contain raw ANSI escape sequences and CP437 characters that the terminal interprets directly—no conversion step is required. The gallery automatically strips any trailing SAUCE metadata records before display.

Items 1 through 5 in the current gallery are native .ANS files sourced from the ANSI art community.

PNG — Algorithmically Converted Images

PNG photographs and digital artwork are converted in real-time to ANSI art using Floyd-Steinberg dithering and half-block character rendering. This produces a faithful approximation of the original image within the constraints of a text-mode terminal.

Items 6 through 9 are PNG images that undergo this conversion process.

VIEWING ARTWORK

To view an image, type its number at the prompt and press ENTER:

Progressive Display

Images are displayed line-by-line to simulate the authentic experience of viewing graphics over a 300 baud modem connection. At 300 baud with 80-character lines, approximately 4 lines per second are revealed—just as it was in the golden age of BBS computing.

The display process depends on the image type:

For PNG images (algorithmically converted):

1. Image Loading — The source PNG is fetched from the server
2. Scaling — Image is resized to 80×96 pixels (48 character rows)
3. Dithering — Floyd-Steinberg dithering is applied for smooth gradients
4. Color Mapping — RGB values are mapped to the 216-color ANSI cube
5. Character Rendering — Half-block characters (▀) encode two pixels per cell

For .ANS files (native ANSI art):

1. File Loading — The raw .ANS file is fetched from the server
2. SAUCE Stripping — Any trailing SAUCE metadata record is removed
3. Direct Display — The ANSI escape sequences are sent to the terminal as-is

After Viewing

Once the image has fully displayed, you will see a prompt with available commands:

Commands:
  M - Return to menu
  Q - Quit

> _

NAVIGATION COMMANDS

Main Menu Commands

Viewing Mode Commands

ABOUT ANSI ART HISTORY

The Dawn of Digital Art

ANSI art emerged from the constraints of early computer terminals. Before graphical user interfaces, creative minds found ways to produce images using only text characters and color codes. The ANSI X3.64 standard (1979) defined escape sequences that allowed terminals to display colors and cursor positioning—the building blocks of ANSI art.

The BBS Art Scene

During the 1980s and early 1990s, Bulletin Board Systems became the canvas for a thriving underground art movement. Groups formed to create and distribute ANSI artwork:

• ACiD Productions — Founded in 1990, one of the most influential art groups
• iCE (Insane Creators Enterprise) — Known for innovative techniques
• FUEL — Pioneered new color blending methods
• TRiBE — Early innovators in ANSI design

Technical Foundations

Classic ANSI art relied on several techniques:

The 256-Color Revolution

The introduction of 256-color support (colors 16-231 forming a 6×6×6 color cube) dramatically expanded artistic possibilities. This gallery uses the full 256-color palette to render photographic images with unprecedented detail for text-mode displays.

 ┌─────────────────────────────────────────┐
 │   THE 6×6×6 ANSI COLOR CUBE            │
 │                                         │
 │   Colors 16-231 form a cube where:      │
 │   • R = 0-5 (×36 for color index)       │
 │   • G = 0-5 (×6 for color index)        │
 │   • B = 0-5 (×1 for color index)        │
 │                                         │
 │   Color = 16 + (36 × R) + (6 × G) + B   │
 │                                         │
 │   Total: 216 colors in the cube         │
 │   Plus: 24 grayscale (232-255)          │
 └─────────────────────────────────────────┘

TERMINAL REQUIREMENTS

Required Capabilities

To view ANSI artwork correctly, your terminal must support:

• ANSI Escape Codes — SGR (Select Graphic Rendition) sequences
• 256-Color Mode — Extended color palette (ESC[38;5;Nm)
• UTF-8 Encoding — For half-block characters (▀)
• 80-Column Display — Standard terminal width

Compatible Terminals

Testing Your Terminal

To verify 256-color support, look for smooth gradients in the displayed artwork. If you see banding or incorrect colors, your terminal may be limited to 16 colors.

COMMAND REFERENCE

Quick Reference Card

Session Workflow

┌─────────────────────────────────────────────────────────┐
│  DIAL 555-0200                                          │
│       │                                                 │
│       ▼                                                 │
│  ╔═════════════╗                                        │
│  ║  MAIN MENU  ║◄─────────────────────┐                │
│  ╚═════════════╝                      │                │
│       │                               │                │
│       │ (1-9)                    (M)  │                │
│       ▼                               │                │
│  ╔═════════════╗    ╔═════════════╗   │                │
│  ║ CONVERTING  ║───►║   VIEWING   ║───┘                │
│  ╚═════════════╝    ╚═════════════╝                    │
│                           │                             │
│                      (Q)  │                             │
│                           ▼                             │
│                     DISCONNECT                          │
└─────────────────────────────────────────────────────────┘

Error Messages

TECHNICAL DETAILS

Image Conversion Process

The ANSI Art Gallery uses advanced image processing techniques to convert modern graphics into authentic ANSI art:

1. Floyd-Steinberg Dithering

Quantization errors are distributed to neighboring pixels using the classic Floyd-Steinberg kernel, producing smooth color gradients within the limited palette:

       [ curr  7/16 ]
       [ 3/16 5/16 1/16 ]

2. Half-Block Rendering

Each character cell represents two vertical pixels using the upper half-block character (▀). The foreground color represents the top pixel, and the background color represents the bottom pixel, effectively doubling vertical resolution.

3. Color Quantization

RGB values are mapped to the 6×6×6 color cube (indices 16-231) using the formula:

ANSI_COLOR = 16 + (36 × R_INDEX) + (6 × G_INDEX) + B_INDEX

where R_INDEX, G_INDEX, B_INDEX ∈ {0, 1, 2, 3, 4, 5}
      mapped from 0-255 → 0-5 (divided by 51)

Display Specifications

Appendix A: Quick Reference Card

╔════════════════════════════════════════════════════════════════════════════╗
║                    ANSI ART GALLERY QUICK REFERENCE                        ║
╠════════════════════════════════════════════════════════════════════════════╣
║  MAIN MENU                         VIEWING MODE                            ║
║  ─────────────────────────────     ────────────────────────────────────    ║
║  1-9    Select and view image      M, MENU    Return to gallery menu       ║
║  Q      Quit and disconnect        Q, QUIT    Quit and disconnect          ║
╠════════════════════════════════════════════════════════════════════════════╣
║  SESSION FLOW                                                              ║
║  ─────────────────────────────────────────────────────────────────────     ║
║  DIAL 555-0200 → SELECT IMAGE (1-9) → WATCH RENDER → MENU (M) or QUIT (Q) ║
╠════════════════════════════════════════════════════════════════════════════╣
║  TERMINAL SETTINGS                                                         ║
║  ─────────────────────────────────────────────────────────────────────     ║
║  Terminal Type:  VT100/ANSI or EC-TTY                                      ║
║  Columns:        80 (required)                                             ║
║  Rows:           24 minimum, 48+ recommended                               ║
║  Colors:         256 (for best results)                                    ║
║  Baud Rate:      Up to 14400 (V.32bis, 8N1)                                ║
║  Local Echo:     OFF                                                       ║
╚════════════════════════════════════════════════════════════════════════════╝

Tips for the Best Experience

Choosing Your Baud Rate

The gallery simulates different modem speeds to recreate the authentic BBS experience:

• 300 baud: Maximum nostalgia. Each image takes about a minute to render. You'll watch individual lines appear, one by one, with plenty of time to appreciate the technique. This is how images felt in the early 1980s.

• 1200 baud: A reasonable compromise. Images render in about 15-20 seconds—fast enough to not feel tedious, slow enough to appreciate the progressive reveal.

• 2400 baud: The "power user" experience of the late 1980s. Images appear in under 10 seconds, close to instant by period standards.

There's no "right" choice. Some prefer the slow reveal; others want to browse quickly. Experiment and find what feels best to you.

Getting the Most from Each Image

When viewing an image, let it render completely before judging it. ANSI art often looks strange mid-render—colors and patterns only make sense once the full image is visible.

After viewing, press M to return to the menu, then re-select the same image. Watching it render a second time, now that you know what to expect, often reveals details and techniques you missed.

Understanding What You're Seeing

If an image looks grainy or pixelated, that's not a bug—it's the dithering algorithm creating smooth gradients from discrete colors. Step back from your monitor (or squint slightly) and the image often snaps into clarity. This is the same technique used in newspaper photographs and early video games.

If colors look wrong, check your terminal's color settings. The gallery requires 256-color support. Some terminals default to 16 colors, which dramatically reduces image quality.

Appendix B: Troubleshooting

Colors Display Incorrectly

Problem: Image appears in wrong colors or with strange patterns.

Solutions:

• Verify your terminal supports 256-color ANSI mode
• Check that your terminal is set to VT100/ANSI or xterm-256color
• Monochrome terminals cannot display ANSI art correctly

Image Appears Garbled

Problem: Characters appear scrambled or misaligned.

Solutions:

• Ensure terminal width is exactly 80 columns
• Check that UTF-8 character encoding is enabled
• Verify no line-wrap or autowrap settings are interfering

Display Is Too Slow

Problem: Image takes very long to appear.

Solutions:

• This is intentional—the progressive reveal simulates modem speeds
• If desired, increase your connection baud rate
• Wait for the complete image to render before navigating

Cannot Connect

Problem: Dialing 555-0200 does not connect.

Solutions:

• Verify your modem is properly configured (8N1, no parity)
• Check that local echo is disabled
• Ensure you are dialing from a compatible terminal

Appendix C: Glossary

ANSI (American National Standards Institute) : The organization that published standard X3.64 for terminal control codes. "ANSI art" refers to graphics created using these escape sequences.

Baud : A unit of data transmission speed. 300 baud transmits approximately 30 characters per second.

Color Cube : The 6×6×6 arrangement of 216 colors (indices 16-231) available in 256-colour terminals, organised by red, green, and blue intensity levels.

Dithering : A technique for simulating colors outside the available palette by mixing nearby colors in patterns.

Escape Code / Escape Sequence : A series of characters beginning with ESC (ASCII 27) that instructs the terminal to perform special functions rather than display text.

Floyd-Steinberg Dithering : An error-diffusion dithering algorithm that spreads quantization errors to neighboring pixels, producing smooth color gradients.

Half-Block Character : The Unicode character ▀ (U+2580), which fills the upper half of a character cell. Used with foreground and background colors to represent two vertical pixels per cell.

Progressive Reveal : The line-by-line display of an image, characteristic of viewing graphics over slow modem connections.

Quantization : The process of reducing continuous color values to a limited palette, such as mapping 16 million RGB colors to 216 ANSI colors.

SAUCE (Standard Architecture for Universal Comment Extensions) : A 128-byte metadata record appended to the end of ANSI art files, storing information such as the author name, group, date, and display dimensions. The gallery strips SAUCE records before display.

SGR (Select Graphic Rendition) : The ANSI escape sequence category (CSI n m) that controls text colors and attributes.

VT100 : A video terminal manufactured by Digital Equipment Corporation in 1978, whose ANSI-compatible escape codes became an industry standard.

Understanding the Magic

How does a photograph become ANSI art? The process involves several clever techniques working together:

The Half-Block Trick

A standard terminal character cell is taller than it is wide—roughly 2:1 in aspect ratio. If we used whole characters for pixels, our images would be stretched vertically and look distorted. The solution: the upper half-block character (▀, Unicode U+2580).

This character fills only the top half of the cell. By setting the foreground color to represent the top pixel and the background color to represent the bottom pixel, we encode two vertical pixels per character cell. An 80-column terminal with 48 character rows can display an effective resolution of 80×96 pixels—enough for recognizable images.

Floyd-Steinberg Dithering

With only 216 colors available, we can't represent every possible RGB value. When a pixel's true color isn't available in our palette, we pick the closest match—but this creates a quantization error. The Floyd-Steinberg algorithm distributes this error to neighboring pixels that haven't been processed yet:

       current pixel → 7/16 (right neighbor)
3/16 ←  5/16 ↓   1/16 ↘
(below-left) (below) (below-right)

The result: smooth gradients emerge from what would otherwise be harsh color bands. Blues blend into purples; skin tones look natural; sunsets glow.

The 6×6×6 Color Cube

Colors 16-231 in the extended ANSI palette form a systematic cube: 6 levels each of red, green, and blue (0, 51, 102, 153, 204, 255), yielding 6×6×6 = 216 colors. To convert any RGB color to this palette:

1. Divide each component by 51 (rounding to nearest integer)
2. Calculate: index = 16 + (36 × R) + (6 × G) + B

This systematic arrangement makes real-time color conversion fast—essential when we're processing thousands of pixels as you watch.

See Also

ANSI Animation Viewer (555-0735) — Animated ANSI art with playback controls, featuring classic demoscene works

BBS Manual Index — Complete documentation index