Manual: ppmtoterm

Ppmtoterm User Manual(1)			   General Commands Manual			    Ppmtoterm User Manual(1)

NAME
       ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image

SYNOPSIS
       ppmtoterm

       [ppmfile]

       All  options  can  be  abbreviated to their shortest unique prefix.  You may use two hyphens instead of one.  You may
       separate an option name and its value with white space instead of an equals sign.

DESCRIPTION
       This program is part of Netpbm(1).

       This program tries to produce an accurate representation of a PPM image on an terminal that implements the  ANSI	 ISO
       6429  standard.	It approximates colors, finding the minimum Cartesian distance between the input RGB vectors and the
       ones in the generated palette.  As the available color palette is somewhat restricted, you get the best results	when
       the colors in the original image are few and the RGB intensities are close to zero, half of maximum, and maximum.

       You  can usually get good results with cartoons or images with plain colors (no gradients).  With photos, results can
       vary, but are usually not very accurate.

       The output image has one line for each row and one character for each column of the input image.	 E.g. an 80 pixel by
       25 pixel PPM image would fill up an 80x25 terminal screen.  Use pamscale or pamcut to make your image fit properly on
       your screen.

       Furthermore, use pamscale to recover the proper aspect ratio, because a character on  a	terminal  screen  is  rarely
       square.	 Typically,  a	character is twice has high as it is wide, so in order for a 20x20 image to appear square on
       your terminal, as it should, you'll want to squash it vertically or stretch it horizontally by a factor of  two	(re‐
       sulting int 10x20 characters are 20x40 characters).

       The  image  starts  at the current cursor position on the terminal screen.  Each successive row starts at Column 0 on
       the screen.  If you want to shift the image up or down, for example to center it, use pnmpad on the input.

       This program was born with the objective of displaying nice color images on the Linux console, e.g. a proper logo  at
       Linux boot.

       ppmtoascii  does	 a similar things, but combines 2 or 8 pixels into one character, where the character roughly repre‐
       sents those particular pixels, whereas ppmtoterm displays each character of the image as a single pixel.

       pbmto4425 does a similar thing for black and white images, using line drawing characters, on some terminals.

OPTIONS
       There are no command line options defined specifically for ppmtoterm, but it recognizes the  options  common  to	 all
       programs based on libnetpbm (See	 Common Options .)

SEE ALSO
       pamscale(1), pamcut(1), ppmtoascii(1), pbmtoascii(1), pbmto4425(1), ppm(1)

AUTHOR
       Copyright (C) 2002 by Ero Carrera.

HISTORY
       This program was new in Netpbm 10.9 (August 2002).

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

netpbm documentation					17 June 2017				    Ppmtoterm User Manual(1)