From e4e922f2f8e8b97f11a0be7028e91f8349e1c561 Mon Sep 17 00:00:00 2001 From: giraffedata Date: Sat, 3 Nov 2007 18:47:38 +0000 Subject: "miscellaneous update" git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@455 9d0c8265-081b-0410-96cb-a4ca84ce46f8 --- libnetpbm_image.html | 6 ++-- pnmmontage.html | 100 ++++++++++++++++++++++++++++++++++++--------------- 2 files changed, 74 insertions(+), 32 deletions(-) diff --git a/libnetpbm_image.html b/libnetpbm_image.html index 7216a2b1..48e3ae8c 100644 --- a/libnetpbm_image.html +++ b/libnetpbm_image.html @@ -431,7 +431,6 @@ C library string functions. const tuplen * const tuplenrow, pnm_transformMap * const transform, tuple * const tuplerow); -

void pnm_gammarown( @@ -446,13 +445,12 @@ C library string functions.

void pnm_applyopacityrown( struct pam * const pamP, -tuplen * const tuplenrow); +tuplen * const tuplenrow);

void pnm_unapplyopacityrown( struct pam * const pamP, -tuplen * const tuplenrow); - +tuplen * const tuplenrow);

pnm_transformMap * pnm_creategammatransform( const struct pam * const pamP); diff --git a/pnmmontage.html b/pnmmontage.html index 7273cb93..bf4d2cbd 100644 --- a/pnmmontage.html +++ b/pnmmontage.html @@ -2,17 +2,15 @@ Pnmmontage User Manual

pnmmontage

-Updated: 31 December 2000 +Updated: 03 November 2007
Table Of Contents - 

NAME

pnmmontage - create a montage of PNM images -  -

SYNOPSIS

+

SYNOPSIS

pnmmontage @@ -24,10 +22,11 @@ pnmmontage - create a montage of PNM images [-0|-1|-2|...|-9] +[-data=filename] + pnmfile... -  -

DESCRIPTION

+

DESCRIPTION

This program is part of Netpbm. @@ -35,20 +34,55 @@ pnmmontage - create a montage of PNM images minimum-area composite image, optionally producing a C header file with the locations of the subimages within the composite image. -  -

OPTIONS

+

OPTIONS

-
-header +
-data=filename + +
This option causes pnmmontage to write a file that describes +in machine-readable form the positions of the original images within +the packed image. Here is an example: + +
+
+            :0:0:227:298
+            ../image1.ppm:0:0:227:149
+            ../image2.ppm:0:149:227:149
+
+
+ + +

This option was new in Netpbm 10.6 (July 2002). + +

-header=filename
Tells pnmmontage to write a C header file of the locations of the original images within the packed image. Each original image generates four #defines within the packed file: xxxX, xxxY, xxxSZX, and xxxSZY, where xxx is the name of the file, converted to all -uppercase. The ouput also includes #defines OVERALLX and OVERALLY, which +uppercase. The output also includes #defines OVERALLX and OVERALLY, which specifies the total size of the montage image. +

Here is an example: + +

+
+            #define OVERALLX 227
+            #define OVERALLY 298
+            
+            #define X 0
+            #define Y 0
+            #define SZX 227
+            #define SZY 149
+            
+            #define X 0
+            #define Y 149
+            #define SZX 227
+            #define SZY 149
+
+
+
-prefix
Tells pnmmontage to use the specified prefix on all of the @@ -63,9 +97,9 @@ subimage times the height of the tallest subimage, whichever is greater. pnmmontage then initiates a problem-space search to find the best packing; if it finds a solution that is (at least) as good as the minimum area times the quality as a percent, it will break -out of the search. Thus, -q 100 will find the best possible +out of the search. Thus, -quality=100 will find the best possible solution; however, it may take a very long time to do so. The default -is -q 200. +is -quality=200.
-0, -1, ... -9 @@ -77,16 +111,23 @@ The higher the number, the slower the computation. The default is -5.
-  -

NOTES

+ + +

NOTES

Using -9 is excessively slow on all but the smallest image -sets. If the anymaps differ in maxvals, then pnmmontage will pick the +sets. If the input images differ in maxvals, then pnmmontage will pick the smallest maxval which is evenly divisible by each of the maxvals of the original images. -  -

SEE ALSO

+

The minimum area arrangement is often not a convenient shape. For +example, it might be a tall, thin column of images, when you'd rather +have something more square. To force a minimum width or height, you +can include a strut image - a black image that wide and one pixel high. +Similarly, you can use a vertical strut to force a minimum height. + + +

SEE ALSO

pnmcat, @@ -102,22 +143,25 @@ the original images. ppm -  -

AUTHOR

+

HISTORY

+ +

pnmmontage was new in Netpbm 9.10 (January 2001). + + +

AUTHOR

Copyright (C) 2000 by Ben Olmstead.
-  -

Table Of Contents

+

Table Of Contents

-- cgit 1.4.1