PNMMARGIN(1)

📦
version 11.13.03 · 10 versions
, in ubuntu stonking

💖 PNMMARGIN(1) — the Pnmmargin User Manual, bestie edition 💖

okay so. welcome to pnmmargin, a certified Netpbm(1) girlie. she does ONE thing and she does it adorably: she puts a border around your PNM image. that's it. that's the whole personality. ✨

🌸 NAME 🌸

pnmmargin — add borders to a PNM image

🎀 SYNOPSIS 🎀

pnmmargin [-white|-black|-color colorspec] size [pnmfile]

🦋 DESCRIPTION 🦋

no cap, this program is part of Netpbm(1) — like, the whole fam. and what she does is genuinely so simple it's iconic:

pnmmargin adds a border around a PNM image. periodt. 💅

🍓 ARGUMENTS 🍓

  • pnmfile — this is the name of the input file, bestie. and if you don't specify it? she's not gonna be dramatic about it, she just reads the input image from her Standard Input instead. lowkey flexible of her. 🫶

✨ OPTIONS ✨

so besides the options that are common to every single program based on libnetpbm (most notably -plain, pls go see Common Options), pnmmargin recognizes these:

setting the border color is YOUR call, and you've got -white, -black, and -color for that. if you don't specify a color at all, the program just... makes a guess. 🙈 (she's guessing. let her guess.)

  • -white and -black — okay so these are the same as -color=white and -color=black respectively, EXCEPT that the -color= versions fail if you don't have a color dictionary set up in your environment. so fr fr, -white and -black are really more like -color=rgbi:0/0/0 and -color=rgbi:1/1/1. iykyk. 💀
  • -color — the value you pass here is like the argument of the pnm_parsecolor() library routine.
  • -plain — this common option was implemented beginning with Netpbm version 10.40 (September 2007). vintage-ish. nostalgic. 🎀
  • -quiet — the -quiet common option is not implemented. she simply does not do that one. no notes. 💅

📝 NOTES 📝

okay so let's get into the lore, because there are cousins here:

  • pnmpad does essentially the same thing, but she gives you more control over the individual margins — and she only does black and white margins. so like, trade-offs, babe. 🌈
  • wanna remove a border of a specified size from an image? use pamcut. pnmcrop also removes borders, but she determines by herself what is border and what is subject. main character energy tbh. 👑
  • and if you want to make the image a certain required size, adding borders or cropping as necessary — pamcut may be what you want. she's the one for that job. 🧚

👀 SEE ALSO 👀

💜 AUTHOR 💜

Copyright (C) 1991 by Jef Poskanzer. we stan a legend. 🙌

📚 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/pnmmargin.html
🫶 ok that's the whole page, bestie. go add a border. go be cute. go slay. 🦋

netpbm documentation · 26 December 2025 · Pnmmargin User Manual(1) — mwah, thanks for reading, ily, bye!! 💖✨🎀

📦 where this page comes from