\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Spottopgm User Manual" 1 "22 July 2004" "netpbm documentation"

.SH NAME

spottopgm - convert SPOT satellite images to a PGM image

.UN synopsis
.SH SYNOPSIS

\fBspottopgm\fP 
[\fB-1\fP|\fB-2\fP|\fB-3\fP] 
[\fIFirstcol\fP \fIFirstline\fP \fILastcol\fP \fILastline\fP] 
\fIinputfile\fP

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.

\fBspottopgm\fP converts the named \fBinputfile\fP to PGM format,
defaulting to the first color and the whole SPOT image unless
you specify otherwise with the options.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBspottopgm\fP recognizes the following
command line options:


.TP
\fB-1\fP
.TP
\fB-2\fP
.TP
\fB-3\fP
Extract the given color from the SPOT image.  The colors are
infrared, visible light, and ultraviolet, although I don't know which
corresponds to which number.  If the image is in color,
\fBspottopgm\fP announces this on Standard Error.  The default color
is 1.



.UN parameters
.SH PARAMETERS


.TP
\fIFirstcol Firstline Lastcol Lastline\fP
Extract the specified rectangle from the SPOT image.  Most SPOT
images are 3000 lines long and 3000 or more columns
wide. Unfortunately, the SPOT format only gives the width and not the
length.  The width is printed on standard error.  The default
rectangle is the width of the input image by 3000 lines.



.UN limitations
.SH LIMITATIONS
.PP
\fBspottopgm\fP doesn't determine the length of the input file;
this would involve two passes over the input file.  It defaults to
3000 lines instead.
.PP
\fBspottopgm\fP could extract a three-color image (as a PPM), but
I didn't feel like making the program more complicated than it is now.
Besides, there is no one-to-one correspondence between red, green,
blue and infrared, visible and ultraviolet.
.PP
I've had only a limited number of SPOT images to play with, and
therefore wouldn't guarantee that this will work on any other images.

.UN author
.SH AUTHOR

Warren Toomey \fIwkt@csadfa.cs.adfa.oz.au\fP

.UN seealso
.SH SEE ALSO
.PP
.BR "pgm" (1)\c
\&
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/spottopgm.html
.PP