SGITOPNM(1)

💖 SGITOPNM 💖

okay bestie, welcome to the sgitopnm page from the Netpbm manual (that's the "Sgitopnm User Manual", section 1, General Commands Manual, iykyk) — she converts SGI image files to PNM and honestly? she ate. 🍓

---

✨ NAME ✨

sgitopnm — convert a SGI image file to PNM

---

🌸 SYNOPSIS 🌸

sgitopnm

[-verbose]

[-channel c]

[SgiFileName]

---

🦋 DESCRIPTION 🦋

so this program is part of Netpbm(1), periodt.

sgitopnm reads an SGI image file as input and produces a PGM 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. it's giving "one tool, two outcomes, main character energy." 👑

alternatively, the program produces a PGM image of any one of the channels in the input file. pick your fave fr fr 💅

⚠️ before Netpbm 10.67 (June 2014), sgitopnm does not work on 2-channel SGI images. it fails if you try. not "oopsie" fails — like, fails fails. 💀

if you don't specify the SgiFileName argument, input is from Standard Input. no filename, no problem, she'll read from stdin. 🫶

😭 before Netpbm 10.67 (June 2014), sgitopnm requires its input to be a seekable file, so for example you can't feed it from a pipe. rude, I know. (fixed since tho, slay.)

---

💅 OPTIONS 💅

in addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), sgitopnm recognizes the following command line options:

• -verbose — give some information about the SGI image file. she's spilling the tea about your file's anatomy. 🍵
• -channel n — extract channel n of the image as a PGM image.

without this option, sgitopnm 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.

a 2-channel image is grayscale plus transparency, so you can get the transparency information with -channel=2. you could then combine them into a PAM image of tuple type GRAYSCALE_ALPHA with pamstack. grayscale AND the transparency? iconic combo meal. 🎀✨

---

🌈 REFERENCES 🌈

the SGI image format specification version 1.0 is at ftp://ftp.sgi.com/graphics/grafica/sgiimage.html .

there is an example SGI file at https://github.com/ZaaLabs/ZaaIL-TestImages/tree/master/SGI .

---

👑 SEE ALSO 👑

pnm(1), pam(1), pnmtosgi(1), pamstack(1)

---

🫶 AUTHOR 🫶

Copyright (C) 1994 by Ingo Wilken ( Ingo.Wilken@informatik.uni-oldenburg.de )

---

📚 DOCUMENT SOURCE 📚

this manual page was generated by the Netpbm tool 'makeman' from HTML source. the master documentation is at

http://netpbm.sourceforge.net/doc/sgitopnm.html

---

and that's the whole vibe check bestie 💜 this page came straight from the netpbm documentation, dated 25 April 2014 — go forth and convert those SGI files, you absolute legend 🧚✨👑