From 231a64a1749f7223cc30cfafc1695a03955009ad Mon Sep 17 00:00:00 2001 From: giraffedata Date: Sun, 4 Dec 2022 22:07:00 +0000 Subject: miscellaneous update git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4473 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- directory.html | 27 ++++++++++++++++++++------- pamhomography.html | 41 ++++++++++++++++++++++++----------------- pamrestack.html | 5 +++-- pamshuffle.html | 2 +- pnmshear.html | 1 + 5 files changed, 49 insertions(+), 27 deletions(-) diff --git a/directory.html b/directory.html index e09a6927..10d25a66 100644 --- a/directory.html +++ b/directory.html @@ -593,6 +593,12 @@ convert Palm Pilot Image Viewer format to Netpbm formats.
pbmtozinc
convert PBM to Zinc Interface Library icon +
pamtoqoi +
convert from Netpbm formats to Quite OK Image format + +
qoitopam +
convert from Quite OK Image format to PAM +
rawtopgm
convert raw grayscale bytes to PGM @@ -886,7 +892,8 @@ a color map containing all possible colors of given maxval
rubber sheet deforming, distortion, stretching of an image
pamhomography -
map one arbitrary quadrilateral image region to another +
stretch/shrink a quadrilateral region of an image to +another quadrilateral shape
pamaddnoise
add noise to an image @@ -916,12 +923,6 @@ a color map containing all possible colors of given maxval
pamundice
assemble an image from tiles (opposite of pamdice) -
ppmtorgb3 -
separate a PPM into three PGMs - -
rgb3toppm -
combine three PGMs into one PPM -
pammixinterlace
mix adjacent lines to merge interlaced images @@ -951,6 +952,9 @@ a color map containing all possible colors of given maxval
ppmfade
produce series of images fading from one to another +
pamshuffle +
move pixels around randomly +
pamoil
turn a PNM or PAM image into an oil painting @@ -1034,12 +1038,21 @@ These all work on the Netpbm formats as input.
pamstack
stack the planes of multiple PAM images into a single output image +
ppmtorgb3 +
separate a PPM into three PGMs + +
rgb3toppm +
combine three PGMs into one PPM +
pampick
pick images out of a multi-image Netpbm image stream
pamsplit
split a multi-image Netpbm file into multiple 1-image files +
pamrestack +
rearrange (reflow) pixels into different size rows +
pamexec
run a shell command on each image of a multi-image stream diff --git a/pamhomography.html b/pamhomography.html index a20a5c5e..843c9c05 100644 --- a/pamhomography.html +++ b/pamhomography.html @@ -11,14 +11,15 @@

pamhomography

-Updated: 03 January 2021 +Updated: 04 December 2022
Table of Contents

NAME

-

pamhomography - map one arbitrary quadrilateral image region to another

+

pamhomography - stretch/shrink a quadrilateral region of an image to + another quadrilateral shape

SYNOPSIS

@@ -29,6 +30,7 @@ Updated: 03 January 2021 [-mapfile=map_file] [-view=coords] [-fill=color] + [-verbose [pam_file]

You can abbreviate any option to its shortest unique prefix. You can use @@ -41,8 +43,9 @@ from its value with whitespace instead of =.

This program is part of Netpbm.

-

pamhomography transforms a quadrilateral—not necessarily -rectangular—region of an image, producing a new image. +

pamhomography stretches and shrinks an arbitrary quadrilateral +portion of an input image you specify (not necessarily rectangular), into a +new quadrilateral shape you specify, producing a new image.

You can do any affine image transformation: translation, reflection, scaling, @@ -67,20 +70,18 @@ options:

This defines the source quadrilateral. coords is a list of four - integer-valued (x, y) coordinates. If you do not - specify -from, the source quadrilateral is taken to be the four - corners of the input image in clockwise order, starting from the upper - left.

+ integer-valued (x, y) coordinates. If you do not specify the + source with either -from or -mapfile, the source quadrilateral + is the entire input image.
-to=coords

This defines the target quadrilateral. coords is a list of four -integer-valued (x, y) coordinates. If you do not -specify -to, the target quadrilateral is taken to be the four corners -of the input image in clockwise order, starting from the upper left.

- +integer-valued (x, y) coordinates. If you do not specify the +target with either -to or -mapfile, the target quadrilateral is +the same as the entire input image.
-mapfile=map_file
@@ -94,6 +95,9 @@ coordinates. In the latter case, the source quadrilateral is taken to be the four corners of the input image in clockwise order, starting from the upper left.

+

Anything you specify with -to or -from overrides what is in + this file. +

-view=coords
@@ -116,18 +120,21 @@ argument of the pnm_parsecolor() library routine.

The default is black, and for images with a transparency plane, transparent.

+ +
-verbose +
+This makes the program issue some informational messages about what it is +doing. + + +

Cooordinates should normally be specified in clockwise order. The syntax is fairly flexible: all characters other than the plus sign, minus sign, and digits are treated as separators. Although coordinates need to be integers, they may lie outside the image's boundary.

-

If you specify -mapfile along with -from and/or -to, --from and -to override the quadrilaterals specified -by map_file.

- -

PARAMETERS

pamhomography's only parameter, pam_file, is the name of the diff --git a/pamrestack.html b/pamrestack.html index 008eabbd..9d513cfa 100644 --- a/pamrestack.html +++ b/pamrestack.html @@ -91,11 +91,11 @@ Print information about the processing to Standard Error.

pamrestack is a general editor with many possible uses.