about summary refs log tree commit diff
path: root/sgitopnm.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2014-04-25 02:48:09 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2014-04-25 02:48:09 +0000
commit1fad62acf077788aa5266935b76831e2350c9099 (patch)
tree97d5970ca272c701cfb5597998e1d0ecb6346902 /sgitopnm.html
parent9a966f0a29c37d1980e33f6970b65bbcbb5c146b (diff)
downloadnetpbm-mirror-1fad62acf077788aa5266935b76831e2350c9099.tar.gz
netpbm-mirror-1fad62acf077788aa5266935b76831e2350c9099.tar.xz
netpbm-mirror-1fad62acf077788aa5266935b76831e2350c9099.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@2195 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'sgitopnm.html')
-rw-r--r--sgitopnm.html80
1 files changed, 46 insertions, 34 deletions
diff --git a/sgitopnm.html b/sgitopnm.html
index c0f23f01..76671f6c 100644
--- a/sgitopnm.html
+++ b/sgitopnm.html
@@ -2,16 +2,15 @@
 <HTML><HEAD><TITLE>Sgitopnm User Manual</TITLE></HEAD>
 <BODY>
 <H1>sgitopnm</H1>
-Updated: 29 Jul 2000
+Updated: 25 April 2014
 <BR>
 <A HREF="#index">Table Of Contents</A>
-<A NAME="lbAB">&nbsp;</A>
+
 <H2>NAME</H2>
 
 sgitopnm - convert a SGI image file to PNM
 
-<A NAME="lbAC">&nbsp;</A>
-<H2>SYNOPSIS</H2>
+<H2 id="synopsis">SYNOPSIS</H2>
 
 <B>sgitopnm</B>
 
@@ -19,68 +18,81 @@ sgitopnm - convert a SGI image file to PNM
 
 [<B>-channel</B> <I>c</I>]
 
-[<I>SGIfile</I>]
+[<I>SgiFileName</I>]
+
 
-<A NAME="lbAD">&nbsp;</A>
-<H2>DESCRIPTION</H2>
+<H2 id="description">DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
 <p><b>sgitopnm</b> reads an SGI image file as input and produces a PGM
-image for a 2-dimensional (1 channel) input file, and a PPM image for
+image for a 2-dimensional (1- or 2-channel) input file, and a PPM image for
 a 3-dimensional (3 or more channels) input file.
 
 <P>Alternatively, the program produces a PGM image of any one of the
 channels in the input file.
 
-<A NAME="lbAE">&nbsp;</A>
-<H2>OPTIONS</H2>
+<p>Before Netpbm 10.67 (June 2014), <b>sgitopnm</b> does not work on 2-channel
+SGI images.  It fails if you try.
+
+<p>If you don't specify the <i>SgiFileName</i> argument, input is from
+Standard Input.
+
+<p>Before Netpbm 10.67 (June 2014), <b>sgitopnm</b> requires its input to
+be a seekable file, so for example you can't feed it from a pipe.
+
+
+<H2 id="options">OPTIONS</H2>
 
 <DL COMPACT>
 <DT><B>-verbose</B>
 
 <DD>Give some information about the SGI image file.
 
-<DT><B>-channel</B> <I>c</I>
+<DT><B>-channel</B> <I>n</I>
+
+<DD>Extract channel <I>n</I> of the image as a PGM image.
+
+<p>Without this option, <B>sgitopnm</B> extracts the first 3 channels as a PPM
+image or, if the input has 1 or 2 channels, extracts the first channel as a
+PGM image.
 
-<DD>Extract channel <I>c</I> of the image as a PGM image.  Without
-this option, <B>sgitopnm</B> extracts the first 3 channels as a PPM
-image or, if the input has only 1 channel, extracts that as a PGM
-image, and if the input has 2 channels, fails.
+<p>A 2-channel image is grayscale plus alpha (transparency), so you can get
+the transparency information with <b>-channel=2</b>.  You could then
+combine them into a PAM image of tuple type GRAYSCALE_ALPHA with
+<b>pamstack</b>.
 
 </DL>
 
-<A NAME="lbAF">&nbsp;</A>
-<H2>REFERENCES</H2>
+<H2 id="references">REFERENCES</H2>
 
 SGI Image File Format documentation (draft v0.95) by Paul Haeberli (<A
-HREF="mailto:paul@sgi.com">paul@sgi.com</A>).  Available via ftp at
+HREF="mailto:paul@sgi.com">paul@sgi.com</A>).  Available via FTP at
 sgi.com:graphics/SGIIMAGESPEC.
 
-<A NAME="lbAG">&nbsp;</A>
-<H2>SEE ALSO</H2>
+<H2 id="seealso">SEE ALSO</H2>
 
 <B><A HREF="pnm.html">pnm</A></B>,
+<B><A HREF="pam.html">pam</A></B>,
+<B><A HREF="pnmtosgi.html">pnmtosgi</A></B>,
+<B><A HREF="pamstack.html">pamstack</A></B>
 
-<B><A HREF="pnmtosgi.html">pnmtosgi</A></B>
 
-<A NAME="lbAH">&nbsp;</A>
-<H2>AUTHOR</H2>
+<H2 id="author">AUTHOR</H2>
 
-<p>Copyright (C) 1994 by Ingo Wilken (<A
-HREF="mailto:Ingo.Wilken@informatik.uni-oldenburg.de">Ingo.Wilken@informatik.uni-oldenburg.de</A>)
+<p>Copyright (C) 1994 by Ingo Wilken
+(<A HREF="mailto:Ingo.Wilken@informatik.uni-oldenburg.de">
+Ingo.Wilken@informatik.uni-oldenburg.de</A>)
 
 <HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
+<H2 id="index">Table Of Contents</H2>
 <UL>
-<LI><A HREF="#lbAB">NAME</A>
-<LI><A HREF="#lbAC">SYNOPSIS</A>
-<LI><A HREF="#lbAD">DESCRIPTION</A>
-<LI><A HREF="#lbAE">OPTIONS</A>
-<LI><A HREF="#lbAF">REFERENCES</A>
-<LI><A HREF="#lbAG">SEE ALSO</A>
-<LI><A HREF="#lbAH">AUTHOR</A>
+<LI><A HREF="#synopsis">SYNOPSIS</A>
+<LI><A HREF="#description">DESCRIPTION</A>
+<LI><A HREF="#options">OPTIONS</A>
+<LI><A HREF="#references">REFERENCES</A>
+<LI><A HREF="#seealso">SEE ALSO</A>
+<LI><A HREF="#author">AUTHOR</A>
 </UL>
 </BODY>
 </HTML>