Debian Codegraph @

upstream/debian-unstable/man1/spottopgm.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 "Spottopgm User Manual" 1 "22 July 2004" "netpbm documentation"
7
8 .SH NAME
9
10 spottopgm - convert SPOT satellite images to a PGM image
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBspottopgm\fP
16 [\fB-1\fP|\fB-2\fP|\fB-3\fP]
17 [\fIFirstcol\fP \fIFirstline\fP \fILastcol\fP \fILastline\fP]
18 \fIinputfile\fP
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26
27 \fBspottopgm\fP converts the named \fBinputfile\fP to PGM format,
28 defaulting to the first color and the whole SPOT image unless
29 you specify otherwise with the options.
30
31 .UN options
32 .SH OPTIONS
33 .PP
34 In addition to the options common to all programs based on libnetpbm
35 (most notably \fB-quiet\fP, see
36 .UR index.html#commonoptions
37 Common Options
38 .UE
39 \&), \fBspottopgm\fP recognizes the following
40 command line options:
41
42
43 .TP
44 \fB-1\fP
45 .TP
46 \fB-2\fP
47 .TP
48 \fB-3\fP
49 Extract the given color from the SPOT image. The colors are
50 infrared, visible light, and ultraviolet, although I don't know which
51 corresponds to which number. If the image is in color,
52 \fBspottopgm\fP announces this on Standard Error. The default color
53 is 1.
54
55
56
57 .UN parameters
58 .SH PARAMETERS
59
60
61 .TP
62 \fIFirstcol Firstline Lastcol Lastline\fP
63 Extract the specified rectangle from the SPOT image. Most SPOT
64 images are 3000 lines long and 3000 or more columns
65 wide. Unfortunately, the SPOT format only gives the width and not the
66 length. The width is printed on standard error. The default
67 rectangle is the width of the input image by 3000 lines.
68
69
70
71 .UN limitations
72 .SH LIMITATIONS
73 .PP
74 \fBspottopgm\fP doesn't determine the length of the input file;
75 this would involve two passes over the input file. It defaults to
76 3000 lines instead.
77 .PP
78 \fBspottopgm\fP could extract a three-color image (as a PPM), but
79 I didn't feel like making the program more complicated than it is now.
80 Besides, there is no one-to-one correspondence between red, green,
81 blue and infrared, visible and ultraviolet.
82 .PP
83 I've had only a limited number of SPOT images to play with, and
84 therefore wouldn't guarantee that this will work on any other images.
85
86 .UN author
87 .SH AUTHOR
88
89 Warren Toomey \[email protected]\fP
90
91 .UN seealso
92 .SH SEE ALSO
93 .PP
94 .BR "pgm" (1)\c
95 \&
96 .SH DOCUMENT SOURCE
97 This manual page was generated by the Netpbm tool 'makeman' from HTML
98 source. The master documentation is at
99 .IP
100 .B http://netpbm.sourceforge.net/doc/spottopgm.html
101 .PP