summary refs log tree commit diff
path: root/pampick.html
blob: 72e8c8bbd18a7d58f7819fbb2e609bcc107d1e08 (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pampick User Manual</title></head>
<body>
<h1>pampick</h1>
Updated: 25 October 2005
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

pampick - pick images out of a multi-image Netpbm image stream

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

<b>pampick</b>

<i>image_sequence_number</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><b>pampick</b> reads a PNM or PAM image stream as input.  It
picks certain images from the stream and copies them to a new image
stream on Standard Output.

<p>You identify the images to pick by sequence number within the stream.
Each <i>image_sequence_number</i> is a decimal sequence number, with zero
meaning the first image.

<p>The arguments must be in increasing order, without duplicates.  The
results are undefined if they are not.  (There are a number of
enhancements that might be made in future releases that would make
whatever <b>pampick</b> does today when you break this rule change).
<b>pampick</b> outputs the images in the same order as they appear in
the input.  If you specify no sequence numbers, <b>pampick</b> outputs
nothing.  If you specify a sequence number that is beyond what is in
the input, <b>pampick</b> fails with an error message to that effect.

<p><b>pampick</b> always reads the entire input stream.  (This is helpful
when the input stream is a pipe and whatever is feeding the pipe would be
upset if it filled up or broke).

<p>To see how many images, and what kind, are in a stream, use
<b>pamfile</b>.

<p>To extract all the images in a stream into separate named files,
use <b>pamsplit</b>.


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

<p>There are no command line options defined specifically
for <b>pampick</b>, but it recognizes the options common to all
programs based on libnetpbm (See <a href="index.html#commonoptions">
Common Options</a>.)

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

<b><a href="pamfile.html">pamfile</a></b>,
<b><a href="pamsplit.html">pamsplit</a></b>,
<b><a href="pnm.html">pnm</a></b>,
<b><a href="pam.html">pam</a></b>,
<b>cat</b> man page

<h2 id="history">HISTORY</h2>

<p><b>pampick</b> was new in Netpbm 10.31 (December 2005);

<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="#seealso">SEE ALSO</a>
<li><a href="#history">HISTORY</a>
</ul>
</body>
</html>