1Pnmpaste User Manual(0)                                Pnmpaste User Manual(0)
2
3
4

NAME

6       pnmpaste - paste a rectangle into a PNM image
7
8

SYNOPSIS

10       pnmpaste
11
12       [-replace|-or|-and|-xor]
13
14       frompnmfile x y [intopnmfile]
15
16       You can abbreviate all options to their shortest unique prefix.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       pnmpaste reads two PNM images as input and inserts the first image (the
23       "pasted image") into the second (the "base  image")  at  the  specified
24       location,  and  produces a PNM image the same size and type as the base
25       image as output.
26
27       Either file name argument (but not both) may be '-' to  indicate  Stan‐
28       dard  Input.   If  you  don't  specify the second file argument at all,
29       that's the same as '-'.
30
31       x and y specify the location in the base image at which to put the  top
32       left corner of the pasted image, x giving the horizontal position and x
33       giving the vertical position.  A nonnegative value indicates the number
34       of  pixels  right  of  the right edge or below the top edge of the base
35       image, while a negative value indicates the number of pixels  right  of
36       the  right edge or below the bottom edge (so x = -5 means 5 pixels left
37       of the right edge).
38
39       If any part of the pasted image does not fit  within  the  base  image,
40       pnmpaste fails.
41
42       This  tool is most useful in combination with pamcut.  For instance, if
43       you want to edit a small segment of a large image, and your image  edi‐
44       tor  cannot  edit  the large image, you can cut out the segment you are
45       interested in, edit it, and then paste it back in.
46
47       Another useful companion tool is pbmmask.
48
49       pamcomp is a more general tool, except that it lacks the  "or,"  "and,"
50       and "xor" functions.  pamcomp allows you to specify a transparency mask
51       in order to have only part of the inserted image get inserted.  So  the
52       inserted  pixels  need  not  be  a  rectangle.   You  can also have the
53       inserted image be translucent, so the resulting image is a  mixture  of
54       the inserted image and the base image.
55
56

OPTIONS

58       The  option  specifies  the operation to use when doing the paste.  The
59       default is -replace, which means to do the obvious paste: replace  pix‐
60       els of the "into" image with those of the "from" image.
61
62       -and,  -nand,  -or, -nor, -xor, and nxor are allowed only if both input
63       images are PBM images.  They say  to  combine  the  "from"  and  "into"
64       images by performing boolean operations: Each pixel of the output image
65       is the result of the boolean operation on the corresponding  pixels  of
66       the two input image, where white is TRUE and black is FALSE.
67
68       Note  that  this  is  different  from what you would get by doing a bit
69       arithmetic on the bits in the PBM images, because in PBM, white is rep‐
70       resented  by  a  0 bit, and 0 in bit arithmetic corresponds to FALSE in
71       boolean arithmetic.
72
73       -nand, -nor, and -nxor were new in Netpbm 10.85 (December 2018).
74
75
76

SEE ALSO

78       pamcomp(1), pamcut(1), pnminvert(1), pnmarith(1), pbmmask(1), pnm(1)
79
80

AUTHOR

82       Copyright (C) 1989, 1991 by Jef Poskanzer.
83

DOCUMENT SOURCE

85       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
86       source.  The master documentation is at
87
88              http://netpbm.sourceforge.net/doc/pnmpaste.html
89
90netpbm documentation           16 December 2018        Pnmpaste User Manual(0)
Impressum