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.
-
- pamrestack can rearrange into rectangles single-dimention images
+ pamrestack can rearrange into rectangles single-dimension images
produced by programs such as ppmhist and pamseq. This makes
the output easier to examine with a viewer. Conversely, pamrestack
can be used to convert a normal rectangular image into one wide row or one
- tall column if that is desireable for compression, conversion, or analysis.
+ tall column if that is desirable for compression, conversion, or analysis.
-
pamrestack can repair images corrupted by an incorrect width value
@@ -147,6 +147,7 @@ pnmcat -leftright oddrows.ppm evenrows.ppm | pamrestack -width=600
pamseq,
ppmhist,
pnmshear,
+pamscale,
pamdeinterlace,
pamdice,
pamundice,
diff --git a/pamshuffle.html b/pamshuffle.html
index e6646b7f..5895e331 100644
--- a/pamshuffle.html
+++ b/pamshuffle.html
@@ -74,7 +74,7 @@ pixels.
Use this to ensure you get the same image on separate invocations.
By default, pamshuffle uses a seed derived from the time of day
-and process ID, which gives you fairly uncorrelated results in multiple
+and process ID, which gives you quite uncorrelated results in multiple
invocations.
diff --git a/pnmshear.html b/pnmshear.html
index cfeaa149..0c384133 100644
--- a/pnmshear.html
+++ b/pnmshear.html
@@ -108,6 +108,7 @@ in the input, you also must consider the background color. See the
pamflip,
pamhomography,
pnmquant,
+pamrestack,
pnm
--
cgit 1.4.1