pnmmargin man page

pnmmargin — add borders to a PNM image


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


This program is part of Netpbm(1).

pnmmargin adds a border around a PNM image.


pnmfile is the name of the input file.  If you don't specify this argument, pnmmargin reads the input image from its Standard Input.


You can specify the border color with the -white, -black, and -color options.  If you don't specify a color, the program makes a guess.

The value of -color is like the argument of the ppm_parsecolor() library routine .

To remove a border of a specified size from an image, use pamcut.  pnmcrop also removes borders, but determines by itself what is border and what is subject.

For lower level control, including to add different size borders to different sides of the image, look at pnmcat.

If all you're trying to do is get the image up to a certain required size, pamcut may be what you want.

pnmpad does essentially the same thing, but gives you more control over the individual margins and does only black and white margins.

See Also

pamcut(1) pnmcrop(1) pnmcat(1) pnmpad(1) pnm(1)


Copyright (C) 1991 by Jef Poskanzer.

Document Source

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

Referenced By

pnmpad(1), ppmshadow(1).

12 November 2014 netpbm documentation