Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pnmpaste(1) [v7 man page]

pnmpaste(1)                                                   General Commands Manual                                                  pnmpaste(1)

NAME
pnmpaste - paste a rectangle into a portable anymap SYNOPSIS
pnmpaste [-replace|-or|-and |-xor] frompnmfile x y [intopnmfile] DESCRIPTION
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. If the second anymap is not specified, it is read from stdin. The x and y can be negative, in which case they are interpreted relative to the right and bottom of the anymap, respectively. This tool is most useful in combination with pnmcut. 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. Another useful companion tool is pbmmask. pnmcomp is, a more general tool, except that it lacks the "or," "and," and "xor" functions. pnmcomp 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. The optional flag specifies the operation to use when doing the paste. The default is -replace. The other, logical operations are only allowed if both input images are bitmaps. These operations act as if white is TRUE and black is FALSE. All flags can be abbreviated to their shortest unique prefix. SEE ALSO
pnmcomp(1), pnmcut(1), pnminvert(1), pnmarith(1), pbmmask(1), pnm(5) AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer. 21 February 1991 pnmpaste(1)

Check Out this Related Man Page

pbmmask(1)						      General Commands Manual							pbmmask(1)

NAME
pbmmask - create a mask bitmap from a regular bitmap SYNOPSIS
pbmmask [-expand] [pbmfile] DESCRIPTION
Reads a portable bitmap as input. Creates a corresponding mask bitmap and writes it out. The color to be interpreted as "background" is determined automatically. Regardless of which color is background, the mask will be white where the background is and black where the figure is. This lets you do a masked paste like this, for objects with a black background: pbmmask obj > objmask pnmpaste < dest -and objmask <x> <y> | pnmpaste -or obj <x> <y> For objects with a white background, you can either invert them or add a step: pbmmask obj > objmask pnminvert objmask | pnmpaste -and obj 0 0 > blackback pnmpaste < dest -and objmask <x> <y> | pnmpaste -or blackback <x> <y> Note that this three-step version works for objects with black backgrounds too, if you don't care about the wasted time. You can also use masks with graymaps and pixmaps, using the pnmarith tool. For instance: ppmtopgm obj.ppm | pgmtopbm -threshold | pbmmask > objmask.pbm pnmarith -multiply dest.ppm objmask.pbm > t1.ppm pnminvert objmask.pbm | pnmarith -multiply obj.ppm - > t2.ppm pnmarith -add t1.ppm t2.ppm An interesting variation on this is to pipe the mask through the pnmsmooth script before using it. This makes the boundary between the two images less sharp. OPTIONS
-expand Expands the mask by one pixel out from the image. This is useful if you want a little white border around your image. (A better solution might be to turn the pbmlife tool into a general cellular automaton tool...) SEE ALSO
ppmcolormask(1), pnmpaste(1), pnminvert(1), pbm(5), pnmarith(1), pnmsmooth(1) AUTHOR
Copyright (C) 1988 by Jef Poskanzer. 08 August 1989 pbmmask(1)
Man Page