pnmtorle(1)

1Pnmtorle User Manual(0)                                Pnmtorle User Manual(0)
2
3
4

NAME

6       pnmtorle - convert a Netpbm image file into an RLE image file.
7
8

SYNOPSIS

10       pnmtorle
11
12       [-h] [-v] [-a] [-o outfile] [pnmfile]
13
14

DESCRIPTION

16       This program is part of Netpbm(1).
17
18       This  program  converts  Netpbm  image files into Utah RLE image files.
19       You can include a transparency mask.  If the input is a multiple  image
20       file, the output consists of several concatenated RLE images.
21
22       The  RLE file will contain either a three channel color image (24 bits)
23       or a single channel grayscale image (8 bits)  depending  upon  the  pnm
24       file  depth.   If a converted ppm is displayed on an 8 bit display, the
25       image must be dithered.  In order to produce a better looking image (on
26       8  bit  displays), it is recommended that the image be quantizing (to 8
27       bit mapped color) prior to its display.  This may be done by piping the
28       output  of  this  program into the Utah mcut or rlequant utilities.  We
29       show an example of this later.
30
31

OPTIONS

33       In addition to the options common to all programs  based  on  libnetpbm
34       (most notably -quiet, see
35        Common  Options  ⟨index.html#commonoptions⟩ ), pnmtorle recognizes the
36       following command line options:
37
38
39
40       -v     This option will cause pnmtorle to operate in verbose mode.  The
41              header  information  is written to "stderr".  Actually, there is
42              not much header information stored in a  Netpbm  file,  so  this
43              information is minimal.
44
45       -h     This  option  allows the header of the Netpbm image to be dumped
46              to "stderr" without converting the file.  It  is  equivalent  to
47              using the -v option except that no file conversion takes place.
48
49       -a     This  option  causes pnmtorle to include an transparency channel
50              in the output image.  The transparency channel is based  on  the
51              image:  Wherever a pixel is black, the corresponding trasparency
52              value is transparent.  Everywhere else, the  transparency  value
53              is fully opaque.
54
55
56       -o outfile
57              If  you  specify this option, pnmtorle writes the output to this
58              file.  If outfile is - or you don't specify -o, pnmtorle  writes
59              the output to Standard Output.
60
61
62       pnmfile
63              The  name of the Netpbm image data file to be converted.  If not
64              specified, standard input is assumed.
65
66
67

EXAMPLES

69          pnmtorle -v file.ppm -o file.rle
70
71       While running in verbose mode, convert file.ppm to RLE format and store
72       resulting data in file.rle.
73
74          pnmtorle -h file.pgm
75
76       Dump the header information of the Netpbm file called file.pgm.
77
78

AUTHOR

84       Wes Barris,
85       Army High Performance Computing Research Center (AHPCRC)
86       Minnesota Supercomputer Center, Inc.
87

DOCUMENT SOURCE

89       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
90       source.  The master documentation is at
91
92              http://netpbm.sourceforge.net/doc/pnmtorle.html
93
94netpbm documentation             31 March 1994         Pnmtorle User Manual(0)