summary refs log tree commit diff
path: root/pnmtorle.html
blob: 82491eb6c0006967b0ae2143f6ebee7e685bc206 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pnmtorle User Manual</title></head>
<body>

<h1>pnmtorle</h1>
Updated: 07 March 2022
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

pnmtorle - convert a Netpbm image file into an RLE image file.

<h2 id="synopsis">SYNOPSIS</h2>

<b>pnmtorle</b>

[<b>-header</b>]
[<b>-verbose</b>]
[<b>-alpha</b>]
[<b>-outfile=</b><i>outfile</i>]
[<i>pnmfile</i>]

<p>Minimum unique abbreviation of option is acceptable.  You may use
double hyphens instead of single hyphen to denote options.  You may use
white space in place of the equals sign to separate an option name
from its value.


<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p>This program converts Netpbm image files into Utah RLE image files.
You can include a transparency mask.  If the input is a multiple image file,
the output consists of several concatenated RLE images.

<p><i>pnmfile</i> is the name of the Netpbm image input file.  If you don't
specify this argument, input is from Standard Input.

<p>The RLE file will contain either a three channel color image (24 bits) or a
single channel grayscale image (8 bits) depending upon the type of Netpbm
input.  If the Netpbm input is color, the RLE output is 3 channel 24 bit
color.  If the Netpbm input is grayscale or black and white, the RLE output is
single channel grayscale.


<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm (most
notably <b>-quiet</b>, see <a href="index.html#commonoptions"> Common
Options</a>), <b>pnmtorle</b> recognizes the following command line options:

<dl compact>
<dt><b>-verbose</b>
<dd>
  This option will cause <b>pnmtorle</b> to operate in verbose mode.  The
  program writes header information to Standard Error.  Actually, there is not
  much header information stored in a Netpbm file, so this information is
  minimal.

  <p>Before Netpbm 10.98 (March 2022), this option is just <b>-v</b>.

<dt><b>-header</b>

<dd>
This option causes the program to dump the header of the Netpbm image to be
Standard Error without converting the file.  It is equivalent to using
the <b>-verbose</b> option except that no file conversion takes place.

  <p>Before Netpbm 10.98 (March 2022), this option is just <b>-h</b>.

<dt><b>-alpha</b>

<dd>
This option causes <b>pnmtorle</b> to include a transparency channel in the
output image.  The transparency channel is based on the image: Wherever a
pixel is black, the corresponding trasparency value is transparent.
Everywhere else, the transparency value is fully opaque.

<dt><b>-outfile</b> <i>outfile</i>

<dd>If you specify this option, <b>pnmtorle</b> writes the output to
this file.  If <i>outfile</i> is <b>-</b> or you don't specify
<b>-outfile</b>, <b>pnmtorle</b> writes the output to Standard Output.

  <p>Before Netpbm 10.98 (March 2022), this option is just <b>-o</b>.and
    must be separated from its value by a space, not an equal sign.

</dl>

<h2 id="examples">EXAMPLES</h2>

<pre>
   pnmtorle -verbose file.ppm -outfile=file.rle
</pre>

<p>While running in verbose mode, convert file.ppm to RLE format and store
resulting data in file.rle.

<pre>
   pnmtorle -header file.pgm
</pre>

<p>Dump the header information of the Netpbm file called file.pgm.

<h2 id="seealso">SEE ALSO</h2>

<b><a href="rletopnm.html">rletopnm</a></b>

<h2 id="author">AUTHOR</h2>

<pre>
Wes Barris,
Army High Performance Computing Research Center (AHPCRC)
Minnesota Supercomputer Center, Inc.
</pre>

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#examples">EXAMPLES</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>