Image guides

Read an ASCII image as a fixed grid of characters

·

ASCII image art replaces image regions with fixed-width characters. Compare the spacing in the downloaded file before pasting it into a document or terminal.

Image to ASCII Art

Read the exact four-column sample

Select Load example and Generate ASCII art. The source is 4 × 2 pixels. The example uses four columns, a character width-to-height ratio of 1, the Classic ramp and a white matte.

Download image-ascii-art.txt. The first row has #, hyphen, %, and a trailing space. The next has @, equals, one space and #. The export ends each row with LF.

Byte-exact text with a space after the percent sign
#-% 
@= #

IETF RFC 20, ASCII format for network interchangeW3C relative luminance formula for sRGB

Compare clear and translucent pixels

The converter averages source luminance within each region. Before averaging, it combines each pixel’s linear-light luminance with the selected white or black matte using alpha.

Change Transparent areas to Black matte and generate again. A fully clear pixel in the second row now maps to @. Turn on Invert brightness to reverse the ramp’s direction.

W3C relative luminance formula for sRGBW3C Portable Network Graphics Third Edition

Match the output to your font’s proportions

Set the character width-to-height ratio near 0.5 if the display cells are about twice as tall as they are wide. At four columns this sample then produces one row. A larger value produces more rows.

Read the result in a monospace display with wrapping disabled. The converter preserves all spaces, including spaces at the right edge of a row.

IETF RFC 20, ASCII format for network interchange

Common questions

Can my character ramp include a space?

Yes. Space is a printable ASCII character. Keep a trailing space in the ramp if you want the lightest regions to look empty.

Can I use emoji or Unicode blocks in a custom ramp?

This tool outputs printable ASCII characters. Choose a ramp with two or more distinct ASCII characters.

Sources

Put it into practice.

Related guides