man-pages/man1/pnmpaste.1.html
2021-03-31 01:06:50 +01:00

131 lines
3.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of pnmpaste</TITLE>
</HEAD><BODY>
<H1>pnmpaste</H1>
Section: User Commands (1)<BR>Updated: 21 February 1991<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pnmpaste - paste a rectangle into a portable anymap
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pnmpaste</B>
[<B>-replace</B>|<B>-or</B>|<B>-and</B>
|<B>-xor</B>]
<I>frompnmfile x y</I>
[<I>intopnmfile</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads two portable anymaps as input.
Inserts the first anymap into the second at the specified location,
and produces a portable anymap the same size as the second as output.
<A NAME="ixAAC"></A>
If the second anymap is not specified, it is read from stdin.
The
<I>x</I>
and
<I>y</I>
can be negative, in which case they are interpreted
relative to the right and bottom of the anymap, respectively.
<P>
This tool is most useful in combination with
<I>pnmcut</I>.
<A NAME="ixAAD"></A>
For instance, if you want to edit a small segment of a large
image, and your image editor cannot edit the
large image, you can cut out the segment you are interested in,
edit it, and then paste it back in.
<P>
Another useful companion tool is
<I>pbmmask</I>.
<A NAME="ixAAE"></A>
<P>
<B>pnmcomp</B>
is, a more general tool, except that it lacks the &quot;or,&quot; &quot;and,&quot; and &quot;xor&quot;
functions.
<B>pnmcomp</B>
allows you to specify an alpha mask in order to have only part of the
inserted image get inserted. So the inserted pixels need not be a
rectangle. You can also have the inserted image be translucent, so the
resulting image is a mixture of the inserted image and the base image.
<P>
[ <B>TIONS</B> ]
<P>
The optional flag specifies the operation to use when doing the paste.
The default is
<B>-replace</B>.
The other, logical operations are only allowed if both input images
are bitmaps.
<A NAME="ixAAF"></A>
These operations act as if white is TRUE and black is FALSE.
<P>
All flags can be abbreviated to their shortest unique prefix.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+pnmcomp">pnmcomp</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+pnmcut">pnmcut</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+pnminvert">pnminvert</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+pnmarith">pnmarith</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+pbmmask">pbmmask</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A></B>(5)
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Copyright (C) 1989, 1991 by Jef Poskanzer.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">SEE ALSO</A><DD>
<DT id="5"><A HREF="#lbAF">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>