pbmtoascii - Man Page

• Read a PBM file as input and produce an ASCII output: pbmtoascii path/to/input_file.pbm
• Read a PBM file as input and save an ASCII output into a file: pbmtoascii path/to/input_file.pbm > path/to/output_file
• Read a PBM file as input while setting the pixel mapping (defaults to 1x2): pbmtoascii -1x2|2x4 path/to/input_file.pbm
• Display version: pbmtoascii -version

tldr.sh

pbmtoascii

[-1x2|-2x4]

[pbmfile]

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.

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), 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.

asciitopgm(1) ppmtoascii(1) ppmtoterm(1) pbm(1)

Copyright (C) 1988, 1992 by Jef Poskanzer.

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

asciitopgm(1), pbmto4425(1), ppmtoascii(1), ppmtoterm(1).