Pbmtoascii User Manual(0)

NAME
pbmtoascii - convert a PBM image to ASCII graphics

SYNOPSIS
pbmtoascii [-1x2|-2x4] [pbmfile]

DESCRIPTION

This program is part of Netpbm(1) .

pbmtoascii reads a PBM image as input and produces a somewhat crude ASCII graphic image as output.

To convert back, use asciitopgm(1) .

ppmtoterm does a similar thing for color images to be displayed on color text terminals.

OPTIONS

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see
 Common Options index.html#commonoptions ), pbmtoascii 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. With the 1x2 mode you can see the individual pixels, so it's useful for previewing small images on a non-graphics terminal. The 2x4 mode lets you display larger images on a small display, but it obscures pixel-level details. 2x4 mode is also good for displaying PGM images:
pamscale -width 158 | pnmnorm | pamditherbw -threshold | pbmtoascii -2x4
should give good results.

SEE ALSO
asciitopgm(1) , ppmtoascii(1) , ppmtoterm(1) , pbm(1)

AUTHOR
Copyright (C) 1988, 1992 by Jef Poskanzer.

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/pbmtoascii.html