Blame userguide/ppmtoterm.html

Packit 78deda
Packit 78deda
<HTML><HEAD><TITLE>Ppmtoterm User Manual</TITLE></HEAD>
Packit 78deda
<BODY>
Packit 78deda

ppmtoterm

Packit 78deda
Updated: 17 June 2017
Packit 78deda

Packit 78deda
Table Of Contents
Packit 78deda
Packit 78deda

NAME

Packit 78deda
Packit 78deda
ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image
Packit 78deda
Packit 78deda

SYNOPSIS

Packit 78deda
Packit 78deda
ppmtoterm
Packit 78deda
Packit 78deda
[ppmfile]
Packit 78deda
Packit 78deda

All options can be abbreviated to their shortest unique prefix.

Packit 78deda
You may use two hyphens instead of one.  You may separate an option
Packit 78deda
name and its value with white space instead of an equals sign.
Packit 78deda
Packit 78deda

DESCRIPTION

Packit 78deda
Packit 78deda

This program is part of Netpbm.

Packit 78deda
Packit 78deda

This program tries to produce an accurate representation of a PPM

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

You can usually get good results with cartoons or images with

Packit 78deda
plain colors (no gradients).  With photos, results can vary, but are
Packit 78deda
usually not very accurate.
Packit 78deda
Packit 78deda

The output image has one line for each row and one character for each

Packit 78deda
column of the input image.  E.g. an 80 pixel by 25 pixel PPM image would
Packit 78deda
fill up an 80x25 terminal screen.  Use pamscale or pamcut
Packit 78deda
to make your image fit properly on your screen.
Packit 78deda
Packit 78deda

Furthermore, use pamscale to recover the proper aspect ratio,

Packit 78deda
because a character on a terminal screen is rarely square.  Typically, a
Packit 78deda
character is twice has high as it is wide, so in order for a 20x20 image to
Packit 78deda
appear square on your terminal, as it should, you'll want to squash it
Packit 78deda
vertically or stretch it horizontally by a factor of two (resulting int 10x20
Packit 78deda
characters are 20x40 characters).
Packit 78deda
Packit 78deda

The image starts at the current cursor position on the terminal

Packit 78deda
screen.  Each successive row starts at Column 0 on the screen.  If you want
Packit 78deda
to shift the image up or down, for example to center it, use
Packit 78deda
pnmpad on the input.
Packit 78deda
Packit 78deda

This program was born with the objective of displaying nice color

Packit 78deda
images on the Linux console, e.g. a proper logo at Linux boot.
Packit 78deda
Packit 78deda

ppmtoascii does a similar things, but combines 2 or 8 pixels into

Packit 78deda
one character, where the character roughly represents those particular pixels,
Packit 78deda
whereas ppmtoterm displays each character of the image as a single
Packit 78deda
pixel.
Packit 78deda
Packit 78deda

pbmto4425 does a similar thing for black and white images, using

Packit 78deda
line drawing characters, on some terminals.
Packit 78deda
Packit 78deda

OPTIONS

Packit 78deda
Packit 78deda

Packit 78deda
None.
Packit 78deda
Packit 78deda
Packit 78deda

SEE ALSO

Packit 78deda
Packit 78deda
pamscale,
Packit 78deda
pamcut,
Packit 78deda
ppmtoascii,
Packit 78deda
pbmtoascii,
Packit 78deda
pbmto4425,
Packit 78deda
ppm
Packit 78deda
Packit 78deda
Packit 78deda

AUTHOR

Packit 78deda
Packit 78deda
Copyright (C) 2002 by Ero Carrera.
Packit 78deda
Packit 78deda
Packit 78deda

HISTORY

Packit 78deda
Packit 78deda

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

Packit 78deda
Packit 78deda
Packit 78deda

Packit 78deda

Table Of Contents

Packit 78deda
    Packit 78deda
  • SYNOPSIS
  • Packit 78deda
  • DESCRIPTION
  • Packit 78deda
  • OPTIONS
  • Packit 78deda
  • SEE ALSO
  • Packit 78deda
  • AUTHOR
  • Packit 78deda
    Packit 78deda
    </BODY>
    Packit 78deda
    </HTML>
    Packit 78deda