Debian Codegraph @

upstream/debian-unstable/man1/pampick.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pampick User Manual" 1 "25 October 2005" "netpbm documentation"
7
8 .SH NAME
9
10 pampick - pick images out of a multi-image Netpbm image stream
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpampick\fP
16
17 \fIimage_sequence_number\fP ...
18 .PP
19 Minimum unique abbreviation of option is acceptable. You may use double
20 hyphens instead of single hyphen to denote options. You may use white
21 space in place of the equals sign to separate an option name from its value.
22
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 \fBpampick\fP reads a PNM or PAM image stream as input. It
32 picks certain images from the stream and copies them to a new image
33 stream on Standard Output.
34 .PP
35 You identify the images to pick by sequence number within the stream.
36 Each \fIimage_sequence_number\fP is a decimal sequence number, with zero
37 meaning the first image.
38 .PP
39 The arguments must be in increasing order, without duplicates. The
40 results are undefined if they are not. (There are a number of
41 enhancements that might be made in future releases that would make
42 whatever \fBpampick\fP does today when you break this rule change).
43 \fBpampick\fP outputs the images in the same order as they appear in
44 the input. If you specify no sequence numbers, \fBpampick\fP outputs
45 nothing. If you specify a sequence number that is beyond what is in
46 the input, \fBpampick\fP fails with an error message to that effect.
47 .PP
48 \fBpampick\fP always reads the entire input stream. (This is helpful
49 when the input stream is a pipe and whatever is feeding the pipe would be
50 upset if it filled up or broke).
51 .PP
52 To see how many images, and what kind, are in a stream, use
53 \fBpamfile\fP.
54 .PP
55 To extract all the images in a stream into separate named files,
56 use \fBpamsplit\fP.
57
58
59 .UN options
60 .SH OPTIONS
61 .PP
62 There are no command line options defined specifically
63 for \fBpampick\fP, but it recognizes the options common to all
64 programs based on libnetpbm (See
65 .UR index.html#commonoptions
66 Common Options
67 .UE
68 \&.)
69
70 .UN seealso
71 .SH SEE ALSO
72 .BR "pamfile" (1)\c
73 \&,
74 .BR "pamsplit" (1)\c
75 \&,
76 .BR "pnm" (1)\c
77 \&,
78 .BR "pam" (1)\c
79 \&,
80 \fBcat\fP man page
81
82 .UN history
83 .SH HISTORY
84 .PP
85 \fBpampick\fP was new in Netpbm 10.31 (December 2005);
86 .SH DOCUMENT SOURCE
87 This manual page was generated by the Netpbm tool 'makeman' from HTML
88 source. The master documentation is at
89 .IP
90 .B http://netpbm.sourceforge.net/doc/pampick.html
91 .PP