ppmtoascii - Man Page

convert a PPM image to ASCII graphics with ANSI terminal color

Examples (TL;DR)

Synopsis

ppmtoascii

[-1x2|-2x4]

[ppmfile]

Description

This program is part of Netpbm(1).

ppmtoascii reads a PPM image as input and produces a somewhat crude ASCII graphic image as output, with ANSI terminal control characters so it has crude color when sent to a color text terminal.

There is no converter for the other direction.

ppmtoterm does a similar thing, but displays each character of the image as a single pixel (using the same dense character for every pixel), whereas ppmtoascii combines 2 or 8 pixels into one character, where the character roughly represents those particular pixels.

Note that ANSI provides for only eight colors (including black and white).

Note that an ANSI terminal can't display a single character in multiple colors, so where a character represents 8 pixels of differing colors, the color of the character is one that is the average of the colors of those pixels.

pbmtoascii does the same thing for PBM images, with no terminal control characters (because none are needed for a strictly black and white image).

Options

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), ppmtoascii recognizes the following command line options:

The -1x2 and -2x4 options give you two alternate ways for the pixels to get mapped to characters.  With 1x2, the default, each character represents a group of 1 pixel across by 2 pixels down.  With -2x4, each character represents 2 pixels across by 4 pixels down.

See Also

pbmtoascii(1) ppmtoterm(1) ppm(1)

History

ppmtoascii was new in Netpbm 10.51 (June 2010).  Frank Ch. Eigler derived it from pbmtoascii.

Author

Copyright (C) 2010 by Frank Ch. Eigler.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

http://netpbm.sourceforge.net/doc/ppmtoascii.html

Referenced By

pbmtoascii(1), ppmtoterm(1).

09 April 2010 netpbm documentation