Debian Codegraph @

upstream/debian-unstable/man1/pnmmargin.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 "Pnmmargin User Manual" 1 "26 December 2025" "netpbm documentation"
7
8 .SH NAME
9
10 pnmmargin - add borders to a PNM image
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpnmmargin\fP
16 [\fB-white\fP|\fB-black\fP|\fB-color\fP \fIcolorspec\fP] \fIsize\fP
17 [\fIpnmfile\fP]
18
19 .UN description
20 .SH DESCRIPTION
21 .PP
22 This program is part of
23 .BR "Netpbm" (1)\c
24 \&.
25 .PP
26 \fBpnmmargin\fP adds a border around a PNM image.
27
28
29 .UN arguments
30 .SH ARGUMENTS
31 .PP
32 \fIpnmfile\fP is the name of the input file. If you don't specify this
33 argument, \fBpnmmargin\fP reads the input image from its Standard Input.
34
35
36 .UN options
37 .SH OPTIONS
38 .PP
39 In addition to the options common to all programs based on libnetpbm
40 (most notably \fB-plain\fP, see
41 .UR index.html#commonoptions
42 Common Options
43 .UE
44 \&), \fBpnmmargin\fP recognizes the following
45 command line options:
46 .PP
47 You can specify the border color with the \fB-white\fP,
48 \fB-black\fP, and \fB-color\fP options. If you don't specify a color, the
49 program makes a guess.
50
51 \fB-white\fP and \fB-black\fP are the same as \fB-color=white\fP
52 and \fB-color=black\fP respectively (except that the latter fail if you
53 don't have a color dictionary set up in your environment, so they are
54 really more like \fB-color=rgbi:0/0/0\fP and
55 \fB-color=rgbi:1/1/1\fP.
56 .PP
57 The value of \fB-color\fP is like the
58 .UR libnetpbm_image.html#colorname
59 argument of the \fBpnm_parsecolor()\fP library routine
60 .UE
61 \&.
62 .PP
63 The \fB-plain\fP common option was implemented beginning with Netpbm
64 version 10.40 (September 2007).
65 .PP
66 The \fB-quiet\fP common option is not implemented.
67
68 .UN notes
69 .SH NOTES
70 .PP
71 \fBpnmpad\fP does essentially the same thing, but gives you more control
72 over the individual margins and does only black and white margins.
73 .PP
74 To remove a border of a specified size from an image, use\fBpamcut\fP.
75 \fBpnmcrop\fP also removes borders, but determines by itself what is border
76 and what is subject.
77 .PP
78 If you want to make the image a certain required size, adding borders
79 or cropping as necessary, \fBpamcut\fP may be what you want.
80
81
82 .UN seealso
83 .SH SEE ALSO
84
85
86 .IP \(bu
87 .BR "pamcut" (1)\c
88 \&
89 .IP \(bu
90 .BR "pnmcrop" (1)\c
91 \&
92 .IP \(bu
93 .BR "pamcat" (1)\c
94 \&
95 .IP \(bu
96 .BR "pnmpad" (1)\c
97 \&
98 .IP \(bu
99 .BR "pnm" (1)\c
100 \&
101
102
103 .UN author
104 .SH AUTHOR
105
106 Copyright (C) 1991 by Jef Poskanzer.
107 .SH DOCUMENT SOURCE
108 This manual page was generated by the Netpbm tool 'makeman' from HTML
109 source. The master documentation is at
110 .IP
111 .B http://netpbm.sourceforge.net/doc/pnmmargin.html
112 .PP