From 1a29632fcc0b7c095f116ad9a760acc80a7b0472 Mon Sep 17 00:00:00 2001 From: giraffedata Date: Sun, 26 Jul 2020 21:43:12 +0000 Subject: miscellaneous update git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3901 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- pnmpaste.html | 99 +++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 55 insertions(+), 44 deletions(-) (limited to 'pnmpaste.html') diff --git a/pnmpaste.html b/pnmpaste.html index 8342965e..92b6672b 100644 --- a/pnmpaste.html +++ b/pnmpaste.html @@ -1,27 +1,28 @@ - -Pnmpaste User Manual - -

pnmpaste

+ +Pnmpaste User Manual + +

pnmpaste

Updated: 16 December 2018 -
-Table Of Contents +
+Table Of Contents -

NAME

+

NAME

pnmpaste - paste a rectangle into a PNM image -

SYNOPSIS

+

SYNOPSIS

-pnmpaste +pnmpaste -[-replace|-or|-and|-xor] +[-replace | -or | -and | -xor | +-nor | -nand | -nxor] -frompnmfile x y -[intopnmfile] +frompnmfile x y +[intopnmfile] -

You can abbreviate all options to their shortest unique prefix. +

You can abbreviate all options to their shortest unique prefix. -

DESCRIPTION

+

DESCRIPTION

This program is part of Netpbm. @@ -42,28 +43,37 @@ edge or below the top edge of the base image, while a negative value indicates the number of pixels right of the right edge or below the bottom edge (so x = -5 means 5 pixels left of the right edge). -

If any part of the pasted image does not fit within the base image, +

If any part of the pasted image does not fit within the base image, pnmpaste fails. -

This tool is most useful in combination with pamcut. For +

This tool is most useful in combination with pamcut. 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. +

Another useful companion tool is pbmmask. -

pamcomp is a more general tool, except that it lacks the +

pamcomp is a more general tool, except that it lacks the "or," "and," and "xor" functions. -pamcomp allows you to specify a transparency mask in order to have +pamcomp allows you to specify a transparency 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. -

OPTIONS

+

OPTIONS

-

The option specifies the operation to use when doing the paste. -The default is -replace, which means to do the obvious paste: +

In addition to the options common to all programs based on libnetpbm +(most notably -quiet, see +Common Options), pnmpaste recognizes the following +command line options: + +

+
-replace, -or, -and, -xor, +-nor, -nand, -nxor +
+

These option specify the operation to use when doing the paste. +The default is -replace, which means to do the obvious paste: replace pixels of the "into" image with those of the "from" image. @@ -71,8 +81,8 @@ replace pixels of the "into" image with those of the and nxor are allowed only if both input images are PBM images. They say to combine the "from" and "into" images by performing boolean operations: Each pixel of the output image is the result of the boolean operation on the -corresponding pixels of the two input image, where white is TRUE and black is -FALSE. +corresponding pixels of the two input images, where white is TRUE and black +is FALSE.

Note that this is different from what you would get by doing a bit arithmetic on the bits in the PBM images, because in PBM, white is @@ -81,30 +91,31 @@ in boolean arithmetic.

-nand, -nor, and -nxor were new in Netpbm 10.85 (December 2018). + +

- -

SEE ALSO

+

SEE ALSO

-pamcomp, -pamcut, -pnminvert, -pnmarith, -pbmmask, -pnm +pamcomp, +pamcut, +pnminvert, +pnmarith, +pbmmask, +pnm -

AUTHOR

+

AUTHOR

Copyright (C) 1989, 1991 by Jef Poskanzer. -
-

Table Of Contents

- - - +
+

Table Of Contents

+ + + -- cgit 1.4.1