summary refs log tree commit diff
path: root/pnmpad.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2015-07-01 02:51:00 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2015-07-01 02:51:00 +0000
commit191b44bf125a1bffcecbb84928848adbb35c84cd (patch)
tree28536fe6b0b30e5ec27c49f3263575959403a8e6 /pnmpad.html
parent676ee319f5dbab5210d073df72f98f2bddc3b570 (diff)
downloadnetpbm-mirror-191b44bf125a1bffcecbb84928848adbb35c84cd.tar.gz
netpbm-mirror-191b44bf125a1bffcecbb84928848adbb35c84cd.tar.xz
netpbm-mirror-191b44bf125a1bffcecbb84928848adbb35c84cd.zip
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@2594 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pnmpad.html')
-rw-r--r--pnmpad.html18
1 files changed, 17 insertions, 1 deletions
diff --git a/pnmpad.html b/pnmpad.html
index 32575fcc..d7251e05 100644
--- a/pnmpad.html
+++ b/pnmpad.html
@@ -2,7 +2,7 @@
 <HTML><HEAD><TITLE>Pnmpad User Manual</TITLE></HEAD>
 <BODY>
 <H1>pnmpad</H1>
-Updated: 20 March 2009
+Updated: 1 July 2015
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
@@ -18,12 +18,14 @@ pnmpad - add borders to a PNM image
 <BR>
 [<B>-width=</B><I>pixels</I>]
 [<B>-halign=</B><I>ratio</I>]
+[<B>-mwidth=</B><I>pixels</I>]
 <BR>
 [<B>-left=</B><I>pixels</I>]
 [<B>-right=</B><I>pixels</I>]
 <BR>
 [<B>-height=</B><I>pixels</I>]
 [<B>-valign=</B><I>ratio</I>]
+[<B>-mheight=</B><I>pixels</I>]
 <BR>
 [<B>-top=</B><I>pixels</I>]
 [<B>-bottom=</B><I>pixels</I>]
@@ -71,6 +73,7 @@ Verbose output.
 <dt><B>-right=</B><I>pixels</I>
 <dt><B>-width=</B><I>width</I>
 <dt><B>-halign=</B><I>ratio</I>
+<dt><B>-mheight=</B><I>pixels</I>
 
 <dd>Specify amount of left and right padding in pixels.
 
@@ -105,13 +108,26 @@ adds no padding.
 <DT><B>1.0</B> <DD>right aligned
 </DL>
 
+<p><b>-mwidth=</b><i>pixels</i> says to pad to a multiple of
+<i>pixels</i> pixels.  E.g. if <i>pixels</i> is 10, the output image width
+will be a multiple of 10 pixels.  <b>pnmpad</b> adds to whatever padding the
+other options say to do to get to this multiple.  It divides that padding
+between the left and right sides of the image to maintain the ratio the other
+options produce.  E.g. if you say <b>-left=10 -right=10 -mwidth=50</b> with a
+100-pixel image, you end up with a 150-pixel image with the extra padding
+split evenly between left and right for a total of 25 pixels of padding
+on the left and 25 on the right.
+
 <p>Before Netpbm 10.23 (July 2004), <b>pnmpad</b> did not allow the
 <b>-left</b> or <b>-right</b> option together with <b>-width</b>.
 
+<p>Before Netpbm 10.72 (September 2015), there is no <b>-mwidth</b>.
+
 <dt><B>-top=</B><I>pixels</I>
 <dt><B>-bottom=</B><I>pixels</I>
 <dt><B>-height=</B><I>height</I>
 <dt><B>-valign=</B><I>ratio</I>
+<dt><B>-mheight=</B><I>pixels</I>
 
 <dd>
 These options determine the vertical padding.  They are analogous