264 lines
4.9 KiB
HTML
264 lines
4.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pnmpad</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pnmpad</H1>
|
|
Section: User Commands (1)<BR>Updated: 26 January 2002<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pnmpad - add borders to portable anymap
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pnmpad </B>
|
|
|
|
[<B>-verbose</B>]
|
|
|
|
[<B>-white</B>|<B>-black</B>]
|
|
|
|
<BR>
|
|
|
|
[[[<B>-width=</B><I>width</I>
|
|
|
|
[<B>-halign=</B><I>ratio</I>]]
|
|
|
|
|
|
|
<BR>
|
|
|
|
[<B>-left=</B><I>leftpad</I>]
|
|
|
|
[<B>-right=</B><I>rightpad</I>]]]
|
|
|
|
<BR>
|
|
|
|
[[[<B>-height=</B><I>height</I>
|
|
|
|
[<B>-valign=</B><I>ratio</I>]]
|
|
|
|
|
|
|
<BR>
|
|
|
|
[<B>-top=</B><I>toppad</I>]
|
|
|
|
[<B>-bottom=</B><I>botpad</I>]]]
|
|
|
|
<BR>
|
|
|
|
[<I>pnmfile</I>]
|
|
|
|
<P>
|
|
All options can be abbreviated to their shortest unique prefix. You
|
|
may use two hyphens instead of one to designate an option. You may
|
|
use either white space or an equals sign between an option name and
|
|
its value.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
Reads a PNM image as input. Outputs a PNM image that is the input
|
|
image plus black or white borders of the sizes specified.
|
|
<P>
|
|
If you just need to convert an image to a certain size regardless of
|
|
the original dimensions,
|
|
<B>pnmcut</B>
|
|
|
|
with the
|
|
<B>-pad</B>
|
|
|
|
option may be a better choice.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
<B>-verbose</B>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
Verbose output.
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-white</B>
|
|
|
|
<BR>
|
|
|
|
<B>-black</B> (default)
|
|
|
|
<DL COMPACT><DT id="2"><DD>
|
|
Set pad color.
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-left </B><I>leftpad</I>
|
|
|
|
<BR>
|
|
|
|
<B>-right </B><I>rightpad</I>
|
|
|
|
<BR>
|
|
|
|
<B>-top </B><I>toppad</I>
|
|
|
|
<BR>
|
|
|
|
<B>-bottom </B><I>bottompad</I>
|
|
|
|
<DL COMPACT><DT id="3"><DD>
|
|
Specify amount of padding in pixels.
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-width </B><I>width</I>
|
|
|
|
<DL COMPACT><DT id="4"><DD>
|
|
Set desired width of image. Overrides
|
|
<B>-left</B> and <B>-right</B> if specified. If
|
|
|
|
<I>width</I>
|
|
|
|
is less than the actual image width, it is ignored. Use
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmcut">pnmcut</A></B>(1)
|
|
|
|
to cut off parts of images.
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-height </B><I>height</I>
|
|
|
|
<DL COMPACT><DT id="5"><DD>
|
|
Set desired height of image. Overrides
|
|
<B>-top</B> and <B>-bottom</B> if specified. If
|
|
|
|
<I>height</I>
|
|
|
|
is less than the actual image height, it is ignored. Use
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmcut">pnmcut</A></B>(1)
|
|
|
|
to cut off parts of images.
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-halign </B><I>ratio</I>
|
|
|
|
<DL COMPACT><DT id="6"><DD>
|
|
A real number between 0 and 1. Used in conjunction with
|
|
<B>-width</B>, sets the alignment ratio between left
|
|
|
|
padding and right padding.
|
|
<P>
|
|
Useful values:
|
|
<DL COMPACT>
|
|
<DT id="7"><B>0.0</B>
|
|
|
|
<DD>
|
|
- left aligned;
|
|
<DT id="8"><B>0.5</B>
|
|
|
|
<DD>
|
|
- center aligned (default);
|
|
<DT id="9"><B>1.0</B>
|
|
|
|
<DD>
|
|
- right aligned.
|
|
</DL>
|
|
</DL>
|
|
|
|
<P>
|
|
<B>-valign </B><I>ratio</I>
|
|
|
|
<DL COMPACT><DT id="10"><DD>
|
|
A real number between 0 and 1. Used in conjunction with
|
|
<B>-height</B>, sets the alignment ratio between bottom
|
|
|
|
padding and top padding.
|
|
<P>
|
|
Useful values:
|
|
<DL COMPACT>
|
|
<DT id="11"><B>0.0</B>
|
|
|
|
<DD>
|
|
- bottom aligned;
|
|
<DT id="12"><B>0.5</B>
|
|
|
|
<DD>
|
|
- center aligned (default);
|
|
<DT id="13"><B>1.0</B>
|
|
|
|
<DD>
|
|
- top aligned.
|
|
</DL>
|
|
</DL>
|
|
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>HISTORY</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14">Before February 2002, <DD>
|
|
<B>pnmpad</B>
|
|
|
|
had a different option syntax which was less expressive and not like
|
|
conventional Netpbm programs. That syntax is still understood by
|
|
<B>pnmpad</B>
|
|
|
|
for backward compatibility,
|
|
but not documented or supported for future use.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pbmmake">pbmmake</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmpaste">pnmpaste</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmcut">pnmcut</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmcrop">pnmcrop</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A></B>(5)
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Copyright (C) 2002 by Martin van Beilen
|
|
<BR>
|
|
|
|
Copyright (C) 1990 by Angus Duggan
|
|
<BR>
|
|
|
|
Copyright (C) 1989 by Jef Poskanzer.
|
|
<P>
|
|
Permission to use, copy, modify, and distribute this software and its
|
|
documentation for any purpose and without fee is hereby granted, provided
|
|
that the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation. This software is provided "as is" without express or
|
|
implied warranty.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="19"><A HREF="#lbAF">HISTORY</A><DD>
|
|
<DT id="20"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="21"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:24 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|