Debian Codegraph @

upstream/debian-unstable/man1/sgitopnm.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 "Sgitopnm User Manual" 1 "25 April 2014" "netpbm documentation"
7
8 .SH NAME
9 sgitopnm - convert a SGI image file to PNM
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBsgitopnm\fP
15
16 [\fB-verbose\fP]
17
18 [\fB-channel\fP \fIc\fP]
19
20 [\fISgiFileName\fP]
21
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBsgitopnm\fP reads an SGI image file as input and produces a PGM
31 image for a 2-dimensional (1- or 2-channel) input file, and a PPM image for
32 a 3-dimensional (3 or more channels) input file.
33 .PP
34 Alternatively, the program produces a PGM image of any one of the
35 channels in the input file.
36 .PP
37 Before Netpbm 10.67 (June 2014), \fBsgitopnm\fP does not work on 2-channel
38 SGI images. It fails if you try.
39 .PP
40 If you don't specify the \fISgiFileName\fP argument, input is from
41 Standard Input.
42 .PP
43 Before Netpbm 10.67 (June 2014), \fBsgitopnm\fP requires its input to
44 be a seekable file, so for example you can't feed it from a pipe.
45
46
47 .UN options
48 .SH OPTIONS
49 .PP
50 In addition to the options common to all programs based on libnetpbm
51 (most notably \fB-quiet\fP, see
52 .UR index.html#commonoptions
53 Common Options
54 .UE
55 \&), \fBsgitopnm\fP recognizes the following
56 command line options:
57
58
59 .TP
60 \fB-verbose\fP
61 Give some information about the SGI image file.
62
63 .TP
64 \fB-channel\fP \fIn\fP
65 Extract channel \fIn\fP of the image as a PGM image.
66 .sp
67 Without this option, \fBsgitopnm\fP extracts the first 3 channels as a PPM
68 image or, if the input has 1 or 2 channels, extracts the first channel as a
69 PGM image.
70 .sp
71 A 2-channel image is grayscale plus transparency, so you can get
72 the transparency information with \fB-channel=2\fP. You could then
73 combine them into a PAM image of tuple type GRAYSCALE_ALPHA with
74 \fBpamstack\fP.
75
76
77
78 .UN references
79 .SH REFERENCES
80 .PP
81 The SGI image format specification version 1.0 is at
82 ftp://ftp.sgi.com/graphics/grafica/sgiimage.html .
83 .PP
84 There is an example SGI file at
85 https://github.com/ZaaLabs/ZaaIL-TestImages/tree/master/SGI .
86
87
88 .UN seealso
89 .SH SEE ALSO
90 .BR "pnm" (1)\c
91 \&,
92 .BR "pam" (1)\c
93 \&,
94 .BR "pnmtosgi" (1)\c
95 \&,
96 .BR "pamstack" (1)\c
97 \&
98
99
100 .UN author
101 .SH AUTHOR
102 .PP
103 Copyright (C) 1994 by Ingo Wilken
104 (\fI
105 [email protected]\fP)
106 .SH DOCUMENT SOURCE
107 This manual page was generated by the Netpbm tool 'makeman' from HTML
108 source. The master documentation is at
109 .IP
110 .B http://netpbm.sourceforge.net/doc/sgitopnm.html
111 .PP