From 85f024990d52feebafeed5ff7d942e4eb8bfa506 Mon Sep 17 00:00:00 2001 From: giraffedata Date: Sun, 31 Jul 2022 00:52:07 +0000 Subject: miscellaneous update git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4381 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- directory.html | 12 +++-- pnmcat.html | 162 ++++++++++++++++++++------------------------------------- 2 files changed, 62 insertions(+), 112 deletions(-) diff --git a/directory.html b/directory.html index d5db244f..e09a6927 100644 --- a/directory.html +++ b/directory.html @@ -739,7 +739,7 @@ a color map containing all possible colors of given maxval
pnmrotate
rotate an image -
pnmcat +
pamcat
concatenate images
pamcomp @@ -1099,10 +1099,11 @@ These all work on the Netpbm formats as input.

Obsolete Names

There used to be programs by the following names. Each has been either -renamed to a more illustrative name, or superseded by a more general -function. In most cases, Netpbm is installed with symbolic links that allow -old programs and procedures to use these names but run the replacement -programs: +renamed to a more illustrative name, or superseded by a more general function. +In most cases, Netpbm is installed with symbolic links that allow old programs +and procedures to use these names but run the replacement programs. In some +cases, programs by these names still exist but are just simple backward +compatibility wrappers around the replacement program.

diff --git a/pnmcat.html b/pnmcat.html index 0acca289..a2affa65 100644 --- a/pnmcat.html +++ b/pnmcat.html @@ -2,130 +2,78 @@ Pnmcat User Manual

pnmcat

-Updated: 30 May 2011 -
-Table Of Contents +Updated: 30 July 2022

NAME

-pnmcat - concatenate Netpbm images +pnmcat - replaced by pamcat -

SYNOPSIS

- -pnmcat - -{-leftright | -lr | -topbottom | -tb} - -[-white|-black] - -[-jtop|-jbottom|-jcenter] -[-jleft|-jright|-jcenter] - -pnmfile ... - - -

Minimum unique abbreviation of option is acceptable. You may use -double hyphens instead of single hyphen to denote options. You may -use white space in place of the equals sign to separate an option name -from its value. - -

DESCRIPTION

+

DESCRIPTION

This program is part of Netpbm. -

pnmcat reads one or more PNM images as input, concatenates them -either left to right or top to bottom, and produces a single PNM image -as output. - -

The arguments are names of input files. Any one of these, but not more -than one, may be "-" to indicate Standard Input. If you have no -arguments, that means a single input image from Standard Input (and that is -pointless - the output is the same as the input). - -

To assemble a regular grid of images, you can use pamundice. - -

To do the reverse, you might use pamdice to split an image -up into smaller ones of equal size or pamcut to chop off part -of an image or extract part of an image. - -

pnmtile concatenates a single input image to itself repeatedly. - -

OPTIONS

- -

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

Direction

- -
-
-topbottom, -tb -
Combine images vertically, top to bottom. - -
-leftright, -lr -
Combine images horizontally, left to right. +

pnmcat was obsoleted by pamcat, +introduced with Netpbm 11.00 (September 2022). pamcat is almost +backward compatible with pnmcat, plus adds many additional functions, +including the ability to process PAM images. -

You must specify the direction by specifying one of the above. +

These are the ways in which pamcat is not backward compatible with + pnmcat: -

- -

Justification

- -
-
-jtop, -jbottom, -jleft, -jright, - -jcenter -
- If the PNM images are not all the same height when you're concatenating left - to right or width when you're concatenating top to bottom, the smaller ones - have to be justified with the largest. By default, pnmcat centers - them, but you can specify justification to one side or the other with one of - the -jxxx options. So, -topbottom -jleft would stack - the PNMs on top of each other, flush with the left edge. -leftright - -jbottom would line up the images left to right with their bottom edges - aligned as if sitting on a table. -
- -

Margin Color

- -
+
    +
  • pamcat produces PAM output, whereas pnmcat produces PNM. + With pamcat, If your inputs are PNM and you want PNM output, you + can run the output through pnmtopnm. But most Netpbm programs + that take PNM input can just as well take the PAM input, so this may not + be necessary. + +
  • pnmcat recognizes PBM, PGM, and PPM input images as visual + images and makes sure the images are the same in the concatenated + outputs even though the output may be a different format. For example, + if you are concatenating PBM image foo.pbm and PPM image bar.ppm, the + resulting image will be PPM and the foo part of it will have the same + black and white pixels as the foo.pbm input. + +

    pamcat, on the other hand, work on generic PAM images and does + not really recognize colors. It sees a PBM input as a 1-plane image + and a PPM input as a 3-plane image and produces a 3-plane output + image. By default, in the example above, the foo part of the output + contains the black and white sample values in its first plane, but + zeroes in its second and third planes, which means if you take the + output image to be a PPM-like color visual image, the foo part is + black and red instead of black and white. + +

    But this is easy to fix. Use the -extendplane option to say + instead of making those additional planes zero, make them copies of + the first plane. So the three panes in the foo part of the output + image will all contain the same sample values as the single plane of + the PBM input, which means if you use the output image as a color + image, those pixels are black and white. +

-
-white, -black -
These options specify what color to use to fill in the extra space -when doing the justification. If neither is specified, pnmcat -chooses whichever seems to be right for the images. +

For full backward compatibility, pnmcat remains in Netpbm, + implemented as a simple wrapper of pamcat. For the fewest problems + with future releases of Netpbm, you should not use pnmcat in any + new work. -

-

SEE ALSO

+

Using pnmcat in old Netpbm

-pamundice, +

In Netpbm before 11.00, use the manual for pamcat with +pnmcat, observing the following differences: -pamdice, +

-pamcut, -pnm + + -

AUTHOR

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

Table Of Contents

- - - -- cgit 1.4.1