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

DESCRIPTION

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

OPTIONS

53       The option specifies the operation to use when doing  the  paste.   The
54       default  is -replace.  The other logical operations are only allowed if
55       both input images are PBM images.  These operations act as if white  is
56       TRUE and black is FALSE.
57
58       You can abbreviate all options to their shortest unique prefix.
59
60

SEE ALSO

62       pamcomp(1), pamcut(1), pnminvert(1), pnmarith(1), pbmmask(1), pnm(1)
63
64

AUTHOR

66       Copyright (C) 1989, 1991 by Jef Poskanzer.
67
68
69
70netpbm documentation           21 February 1991        Pnmpaste User Manual(0)
Impressum