PGMTOIMGV(1)

💖 PGMTOIMGV 💖

okay bestie, welcome to the pgmtoimgv(1) page — it lives in the General Commands Manual section, and it's here to turn your Portable Graymaps into grayscale Pilot Image Viewer files. she's little, she's mighty, she's version 2.1, let's go 🦋

---

✨ NAME ✨

pgmtoimgv — Portable Graymap to Pilot Image Viewer converter, version 2.1.

---

🌸 SYNOPSIS 🌸

pgmtoimgv [-h] [-v] [-4] [-t title] [-n notefile] [-{c|m|u}] [in [out]]

---

👑 DESCRIPTION 👑

so basically, pgmtoimgv is a simple filter that converts Portable Graymaps into grayscale Pilot Image Viewer pdb files. no cap, that's the whole job 💅

Heads up tho: the input pgm file has to use this exact palette unless you pass the -4 switch:

P3
4 1
255
  0   0   0
 85  85  85
170 170 170
255 255 255

and if you do specify -4, then your grayscale image must use this palette instead:

P3
16 1
255
  0   0   0
 17  17  17
 34  34  34
 51  51  51
 68  68  68
 85  85  85
102 102 102
119 119 119
136 136 136
153 153 153
170 170 170
187 187 187
204 204 204
221 221 221
238 238 238
255 255 255

if your PGM file isn't on one of these palettes, bestie, just use ppmquant(1) to convert your palette. easy fix, no stress 🫶

---

🎀 the padding situation 🎀

if an image's width is not a multiple of 16 pixels, enough extra white pixels will be added at the right side to ensure alignment. and images will be padded, with white pixels, to a width and height of 160 if needed. she just wants everything to line up, okay?? iconic behaviour honestly 💅

---

💅 OPTIONS 💅

• -h — Display a short summary of the command line options and exit. (your lil cheat sheet 📝)
• -v — Display the version and exit. (who dis? it's version 2.1 ✨)
• -4 — Use 4 bit grayscale (16 shades of gray). more shades, more slay 🌈
• -t title — Specify the title of the image (up to 31 characters). keep it cute and keep it short, she has a limit 💀
• -n notefile — Specify the note file. No note is attached to the image by default. (so by default there's literally no note, none, nada 🍓)
• -c — Produce a compressed image.
• -m — Produce a compressed image if it is smaller than the uncompressed version. This is the default compression mode. 👑
• -u — Produce an uncompressed image.
• in — The input file. The default is the standard input.
• out — The output file. The default is the standard output.

---

🦋 SEE ALSO 🦋

imgvinfo(1), imgvtopnm(1), imgvview(1), pbmtoimgv(1), ppmimgvquant(1), pbm(5), pgm(5).

go read those too, they're the rest of the friend group 💜

---

💀 BUGS 💀

Bug reports should be sent to Eric A. Howe (mu@trends.net).

fr fr, if something's cursed, tell him, not me 🙈

---

📜 LICENSE 📜

Copyright (C) 1997,1998 Eric A. Howe <http://www.trends.net/~mu>.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

---

and that's the whole page bestie 💖 stay gray, stay gorgeous, stay aligned to a multiple of 16 ✨

that's a wrap on pgmtoimgv — General Commands Manual energy, version 2.1, dated Sept 1997, and honestly? she ate. periodt 👑