Debian Codegraph @

upstream/debian-trixie/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 "10 August 2024" "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 .PP
51 The value of \fB-color\fP is like the
52 .UR libnetpbm_image.html#colorname
53 argument of the \fBpnm_parsecolor()\fP library routine
54 .UE
55 \&.
56 .PP
57 The \fB-plain\fP common option was implemented beginning with Netpbm
58 version 10.40 (September 2007).
59 .PP
60 The \fB-quiet\fP common option is not implemented.
61
62 .UN notes
63 .SH NOTES
64 .PP
65 \fBpnmpad\fP does essentially the same thing, but gives you more control
66 over the individual margins and does only black and white margins.
67 .PP
68 To remove a border of a specified size from an image, use\fBpamcut\fP.
69 \fBpnmcrop\fP also removes borders, but determines by itself what is border
70 and what is subject.
71 .PP
72 If you want to make the image a certain required size, adding borders
73 or cropping as necessary, \fBpamcut\fP may be what you want.
74
75
76 .UN seealso
77 .SH SEE ALSO
78
79
80 .IP \(bu
81 .BR "pamcut" (1)\c
82 \&
83 .IP \(bu
84 .BR "pnmcrop" (1)\c
85 \&
86 .IP \(bu
87 .BR "pamcat" (1)\c
88 \&
89 .IP \(bu
90 .BR "pnmpad" (1)\c
91 \&
92 .IP \(bu
93 .BR "pnm" (1)\c
94 \&
95
96
97 .UN author
98 .SH AUTHOR
99
100 Copyright (C) 1991 by Jef Poskanzer.
101 .SH DOCUMENT SOURCE
102 This manual page was generated by the Netpbm tool 'makeman' from HTML
103 source. The master documentation is at
104 .IP
105 .B http://netpbm.sourceforge.net/doc/pnmmargin.html
106 .PP