home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsp / pbmtk / !PBMtk / Docs / !DTPguide / Manpages < prev   
Encoding:
Text File  |  1993-12-02  |  21.3 KB  |  807 lines
  1. COMMAND LINE MANUAL PAGES
  2. =========================
  3. These pages provide a description of each of the implemented menu options.
  4.  
  5. Each manual page is headed by the PBMtk menu entry, followed by the original
  6. PBMPlus (Unix version) description of the command line invocation of each
  7. function. The PBMtk dialog boxes allow for most, if not all, of the possible
  8. options that are provided for by the command line.
  9.  
  10. Note that each of the PBMPlus functions that have been incorporated into
  11. PBMtk can be invoked from the command line using the syntax provided in
  12. these manual pages. The binary executables for each of the functions are
  13. in the directory !PBMtk.bin. (Do not remove these binaries from this
  14. directory. They are required by PBMtk).
  15.  
  16. PBMPlus functions are designed to operate with defaults if no option is
  17. provided by the user. In addition the functions are designed to accept input
  18. from stdin and from Unix pipes, and the output to be written to stdout. As a
  19. result the command synopsis never includes a requirement for an output
  20. filename, and where only one input file is required it is optional. The
  21. command line cannot be operated this way in RISC OS and it will always be
  22. necessary to provide input filenames on the command line and redirect the
  23. output to a file if it is to be captured. Options other than filenames can
  24. be ignored if the defaults are acceptable.
  25.  
  26. The following examples serve to illustrate the above;
  27.  
  28. Unix Command line description:
  29.  
  30. fredtoppm [ -long | -short] [ fredfile] (default is short)
  31.  
  32. RISC OS Command line use:
  33.  
  34. fredtoppm fred > fredppm
  35.  
  36. (where short is OK, and the input fredfile is 'fred' and the output file is
  37. 'fredppm')
  38.  
  39. fredtoppm long fred > fredppm
  40.  
  41. (where the long option is required)
  42.  
  43. Conventions
  44.  
  45. options are enclosed in brackets [] are optional. Alternatives are separated
  46. by a |. Parameters not enclosed by brackets are required.
  47.  
  48.  
  49. =============================================================================
  50.  
  51. Readin -> YUVtoPPM
  52. ==================
  53.  
  54. NAME
  55.  
  56. yuvtoppm - convert Abekas YUV bytes into a portable pixmap
  57.  
  58. SYNOPSIS
  59.  
  60. yuvtoppm width height [ imagedata ]
  61.  
  62.  
  63. DESCRIPTION
  64.  
  65. Reads raw Abekas YUV bytes as input. Produces a portable pixmap as output.
  66. The input file is just YUV bytes.
  67. You have to specify the width and height on the command line, since the
  68. program obviously can't get them from the file. The maxval is assumed to be
  69. 255.
  70.  
  71. "SEE ALSO"
  72.  
  73. ppmtoyuv(1), ppm(5)
  74.  
  75. AUTHOR
  76.  
  77. Marc Boucher <marc@PostImage.COM>,
  78. based on Example Conversion Program, A60/A64 Digital Video Interface
  79. Manual, page 69.
  80.         
  81. Copyright (C) 1991 by DHD PostImage Inc.
  82.         
  83. Copyright (C) 1987 by Abekas Video Systems Inc.
  84.                                                 
  85. ***************************************************************************
  86.  
  87. Writeout -> PPMtoYUV
  88. ====================
  89.  
  90. NAME
  91.  
  92. ppmtoyuv - convert a portable pixmap into an Abekas YUV file
  93.  
  94. SYNOPSIS
  95.  
  96. ppmtoyuv [ ppmfile ]
  97.  
  98. DESCRIPTION
  99.  
  100. Reads a portable pixmap as input.
  101. Produces an Abekas YUV file as output.
  102.          
  103. "SEE ALSO"
  104.  
  105. yuvtoppm(1), ppm(5)
  106.  
  107. AUTHOR
  108.  
  109. Marc Boucher <marc@PostImage.COM>,
  110. based on Example Conversion Program, A60/A64 Digital Video Interface
  111. Manual, page 69.
  112.         
  113. Copyright (C) 1991 by DHD PostImage Inc.
  114.         
  115. Copyright (C) 1987 by Abekas Video Systems Inc.
  116.                                                 
  117. ***************************************************************************
  118.  
  119. PBM -> Make
  120. ===========
  121.  
  122.  NAME
  123.  
  124. pbmmake - create a blank bitmap of a specified size
  125.  
  126.  SYNOPSIS
  127.  
  128. pbmmake [ -white | -black | -gray] width height
  129.  
  130.  DESCRIPTION
  131.  
  132. Produces a portable bitmap of the specified width and height.
  133. The color defaults to white.
  134.  
  135.  OPTIONS
  136.  
  137. In addition to the usual -white and -black , this program implements -gray.
  138. This gives a simple 50% gray pattern with 1's and 0's alternating.
  139.  
  140. All flags can be abbreviated to their shortest unique prefix.
  141.  
  142.  "SEE ALSO"
  143.  
  144. pbm(5), ppmmake(1)
  145.  
  146.  AUTHOR
  147.  
  148. Copyright (C) 1989 by Jef Poskanzer.
  149.  
  150. ***************************************************************************
  151. PGM -> Crater
  152. =============
  153.  
  154. NAME
  155.  
  156. pgmcrater - create cratered terrain by fractal forgery
  157.  
  158. SYNOPSIS
  159.  
  160.  
  161. pgmcrater [ -number n ] [ -height | -ysize s ] [ -width | -xsize s ]
  162. [ -gamma g ]
  163.  
  164. DESCRIPTION
  165.  
  166. pgmcrater creates a portable graymap which mimics cratered terrain.  The
  167. graymap is created by simulating the impact of a given number of craters
  168. with random position and size, then rendering the resulting terrain
  169. elevations based on a light source shining from one side of the screen.  The
  170. size distribution of the craters is based on a power law which results in
  171. many more small craters than large ones.  The number of craters of a given
  172. size varies as the reciprocal of the area as described on pages 31 and 32 of
  173. Peitgen and Saupe[1]; cratered bodies in the Solar System are observed to
  174. obey this relationship.  The formula used to obtain crater radii governed by
  175. this law from a uniformly distributed pseudorandom sequence was developed by
  176. Rudy Rucker.
  177.  
  178. High resolution images with large numbers of craters often benefit from
  179. being piped through pnmsmooth . The averaging performed by this process
  180. eliminates some of the jagged pixels and lends a mellow ``telescopic image''
  181. feel to the overall picture.
  182.  
  183. OPTIONS
  184.  
  185.  -number " n" 
  186. Causes n craters to be generated.  If no -number specification
  187. is given, 50000 craters will be generated.  Don't expect to see them all! 
  188. For every large crater there are many, many more tiny ones which tend simply
  189. to erode the landscape.  In general, the more craters you specify the more
  190. realistic the result; ideally you want the entire terrain to have been
  191. extensively turned over again and again by cratering.  High resolution
  192. images containing five to ten million craters are stunning but take quite a
  193. while to create.
  194.  
  195.  -height " height"
  196. Sets the height of the generated image to height pixels.  The default height
  197. is 256 pixels.
  198.  
  199.  -width " width"
  200. Sets the width of the generated image to width pixels.  The default width is
  201. 256 pixels.
  202.  
  203.  -xsize " width"
  204. Sets the width of the generated image to width pixels.  The default width is
  205. 256 pixels.
  206.  
  207.  -ysize " height"
  208. Sets the height of the generated image to height pixels.  The default height
  209. is 256 pixels.
  210.  
  211.  -gamma " factor"
  212. The specified factor is used to gamma correct the graymap in the same manner
  213. as performed by pnmgamma . The default value is 1.0, which results in a
  214. medium contrast image. Values larger than 1 lighten the image and reduce
  215. contrast, while values less than 1 darken the image, increasing contrast.
  216.  
  217. All flags can be abbreviated to their shortest unique prefix.
  218.  
  219. BUGS
  220.  
  221. The -gamma option isn't really necessary since you can achieve the same
  222. effect by piping the output from pgmcrater through pnmgamma . However,
  223. pgmcrater performs an internal gamma map anyway in the process of rendering
  224. the elevation array into a graymap, so there's no additional overhead in
  225. allowing a user-specified gamma.
  226.  
  227. Real craters have two distinct morphologies. pgmcrater simulates only small
  228. craters, which are hemispherical in shape (regardless of the incidence angle
  229. of the impacting body, as long as the velocity is sufficiently high).  Large
  230. craters, such as Copernicus and Tycho on the Moon, have a ``walled plain''
  231. shape with a cross-section more like:
  232.  
  233.  
  234.  
  235.                 /\\                            /\\
  236.  
  237.           _____/  \\____________/\\____________/  \\_____
  238.  
  239.  
  240. Larger craters should really use this profile, including the central
  241. peak, and totally obliterate the pre-existing terrain.
  242.  
  243.  
  244. "SEE ALSO"
  245.  
  246.  pgm (5),
  247.  pnmgamma (1),
  248.  pnmsmooth (1)
  249.  [1] Peitgen, H.-O., and Saupe, D. eds., The Science Of Fractal Images, New
  250. York: Springer Verlag, 1988.
  251.  
  252.  AUTHOR
  253.  
  254. John Walker
  255. Autodesk SA
  256. Avenue des Champs-Montants 14b
  257. CH-2074 MARIN
  258. Suisse/Schweiz/Svizzera/Svizra/Switzerland
  259. Usenet:
  260. kelvin@Autodesk.com
  261.  
  262. Fax:
  263. 038/33 88 15
  264.  
  265. Voice:
  266. 038/33 76 33
  267.  
  268. Permission to use, copy, modify, and distribute this software and its
  269. documentation for any purpose and without fee is hereby granted,
  270. without any conditions or restrictions.  This software is provided ``as
  271. is'' without express or implied warranty.
  272.  
  273. PLUGWARE!
  274. If you like this kind of stuff, you may also enjoy ``James Gleick's
  275. Chaos--The Software'' for MS-DOS, available for $59.95 from your
  276. local software store or directly from Autodesk, Inc., Attn: Science
  277. Series, 2320 Marinship Way, Sausalito, CA 94965, USA.  Telephone:
  278. (800) 688-2344 toll-free or, outside the U.S. (415) 332-2344 Ext
  279. 4886.  Fax: (415) 289-4718.  ``Chaos--The Software'' includes a more
  280. comprehensive fractal forgery generator which creates
  281. three-dimensional landscapes as well as clouds and planets, plus five
  282. more modules which explore other aspects of Chaos.  The user guide of
  283. more than 200 pages includes an introduction by James Gleick and
  284. detailed explanations by Rudy Rucker of the mathematics and algorithms
  285. used by each program.
  286.  
  287. ***************************************************************************
  288.  
  289.  
  290. PGM -> Edge
  291. ===========
  292.  
  293. NAME
  294.  
  295. pgmedge - edge-detect a portable graymap
  296.  
  297. SYNOPSIS
  298.  
  299. pgmedge [ pgmfile ]
  300.  
  301.  
  302.  DESCRIPTION
  303.  
  304. Reads a portable graymap as input.
  305. Outlines the edges, and writes a portable graymap as output.
  306.  
  307. Piping the result through pgmtopbm -threshold and playing with the threshold
  308. value will give a bitmap of the edges. thresholding
  309.  
  310. The edge detection technique used is to take the Pythagorean sum of two
  311. Sobel gradient operators at 90 degrees to each other. For more details see
  312. "Digital Image Processing" by Gonzalez and Wintz, chapter 7.
  313.  
  314.  
  315. "SEE ALSO"
  316.  
  317. pgmenhance(1), pgmtopbm(1), pgm(5), pbm(5)
  318.  
  319. AUTHOR
  320.  
  321. Copyright (C) 1991 by Jef Poskanzer.
  322.  
  323. ***************************************************************************
  324.  
  325. PGM -> Enhance
  326. ==============
  327.  
  328.  NAME
  329.  
  330. pgmenhance - edge-enhance a portable graymap
  331.  
  332.  
  333.  SYNOPSIS
  334.  
  335. pgmenhance [ -N ] [ pgmfile ]
  336.  
  337.  
  338.  DESCRIPTION
  339.  
  340. Reads a portable graymap as input. Enhances the edges, and writes a portable
  341. graymap as output.
  342. The edge enhancing technique is taken from Philip R. Thompson's "xim"
  343. program, which in turn took it from section 6 of "Digital Halftones by Dot
  344. Diffusion", D. E. Knuth, ACM Transaction on Graphics Vol. 6, No. 4, October
  345. 1987, which in turn got it from two 1976 papers by J. F. Jarvis et. al.
  346.  
  347.  OPTIONS
  348.  
  349. The optional -N flag should be a digit from 1 to 9. 1 is the lowest level of
  350. enhancement, 9 is the highest, The default is 9.
  351.  
  352.  
  353.  "SEE ALSO"
  354.  
  355. pgmedge(1), pgm(5), pbm(5)
  356.  
  357.  
  358.  AUTHOR
  359.  
  360. Copyright (C) 1989 by Jef Poskanzer.
  361.  
  362. ***************************************************************************
  363.  
  364. PPM -> Pattern
  365. ==============
  366.  
  367.  NAME
  368.  
  369. ppmpat - create a patterned pixelmap
  370.  
  371.  SYNOPSIS
  372.  
  373. ppmpat -gingham2 | -g2 | -gingham3 | -g3 | -madras | -tartan | -poles
  374. |-squig | -camo | -anticamo width height
  375.  
  376.  DESCRIPTION
  377.  
  378. Produces a portable pixmap of the specified width and height,with a pattern
  379. in it.
  380.  
  381. This program is mainly to demonstrate use of the ppmdraw routines, a simple
  382. but powerful drawing library. See the ppmdraw.h include file for more info
  383. on using these routines. Still, some of the patterns can be rather pretty.
  384. If you have a color workstation, something like "ppmpat -squig 300 300" |
  385. "ppmquant 128" should generate a nice background.
  386.  
  387.  OPTIONS
  388.  
  389. The different flags specify various different pattern types:
  390.  
  391. -gingham2
  392. A gingham check pattern.  Can be tiled.
  393.  
  394. -gingham3
  395. A slightly more complicated gingham.  Can be tiled.
  396.  
  397. -madras
  398. A madras plaid.  Can be tiled.
  399.  
  400. -tartan
  401. A tartan plaid.  Can be tiled.
  402.  
  403. -poles
  404. Color gradients centered on randomly-placed poles. May need to be run
  405. through ppmquant .
  406.  
  407. -squig
  408. Squiggley tubular pattern.  Can be tiled. May need to be run through
  409. ppmquant.
  410.  
  411. -camo
  412. Camouflage pattern.
  413. May need to be run through ppmquant .
  414.  
  415. -anticamo
  416. Anti-camouflage pattern - like -camo, but ultra-bright colors.
  417. May need to be run through ppmquant .
  418.  
  419. All flags can be abbreviated to their shortest unique prefix.
  420.  REFERENCES
  421. Some of the patterns are from "Designer's Guide to Color 3" by Jeanne Allen.
  422.  
  423.  "SEE ALSO"
  424.  
  425. pnmtile(1), ppmquant(1), ppm(5)
  426.  
  427.  AUTHOR
  428.  
  429. Copyright (C) 1989 by Jef Poskanzer.
  430.  Permission to use, copy, modify, and distribute this software and its
  431.  documentation for any purpose and without fee is hereby granted, provided
  432.  that the above copyright notice appear in all copies and that both that
  433.  copyright notice and this permission notice appear in supporting
  434.  documentation.  This software is provided "as is" without express or
  435.  implied warranty.
  436. *****************************************************************************
  437.  
  438.  
  439. PPM -> Relief
  440. =============
  441.  
  442.  NAME
  443.  
  444. ppmrelief - run a Laplacian relief filter on a portable pixmap
  445.  
  446.  SYNOPSIS
  447.  
  448. ppmrelief [ ppmfile ]
  449.  
  450.  DESCRIPTION
  451.  
  452. Reads a portable pixmap as input. Does a Laplacian relief filter, and writes
  453. a portable pixmap as output. The Laplacian relief filter is described in
  454. "Beyond Photography" by Holzmann, equation 3.19. It's a sort of
  455. edge-detection.
  456.  
  457.  "SEE ALSO"
  458.  
  459. pgmbentley(1), pgmoil(1), ppm(5)
  460.  
  461.  AUTHOR
  462.  
  463. Copyright (C) 1990 by Wilson Bent (whb@hoh-2.att.com)
  464.                                                 
  465. ***************************************************************************
  466.  
  467. PPM -> To-PGM
  468. =============
  469.  
  470.  NAME
  471.  
  472. ppmtopgm - convert a portable pixmap into a portable graymap
  473.  
  474.  SYNOPSIS
  475.  ppmtopgm [ ppmfile ]
  476.  
  477.  DESCRIPTION
  478.  
  479. Reads a portable pixmap as input. Produces a portable graymap as output. The
  480. quantization formula used is .299 r + .587 g + .114 b.
  481.         
  482. Note that although there is pgmtoppm program, it is not necessary for simple
  483. conversions from pgm to ppm , because any ppm program can read pgm (and pbm)
  484. files automagically. pgmtoppm is for colorizing  pgm file.  Also,
  485. see ppmtorgb3 ppmtorgb3 for a different way of converting color to gray.
  486.  
  487.  QUOTE
  488.         
  489. Cold-hearted orb that rules the night
  490. Removes the colors from our sight
  491. Red is gray, and yellow white
  492. But we decide which is right
  493. And which is a quantization error.
  494.  
  495.  "SEE ALSO"
  496.  
  497. pgmtoppm(1), ppmtorgb3(1), rgb3toppm(1), ppm(5), pgm(5)
  498.  
  499.  AUTHOR
  500.  
  501. Copyright (C) 1989 by Jef Poskanzer.
  502.                                                 
  503. ***************************************************************************
  504.  
  505. PNM -> Arithmetic
  506. =================
  507.  
  508. pnmarith - perform arithmetic on two portable anymaps
  509.  
  510.  SYNOPSIS
  511.  
  512. pnmarith -add | -subtract | -multiply pnmfile1 pnmfile2
  513.  
  514.  DESCRIPTION
  515.  
  516. Reads two portable anymaps as input. Performs the specified arithmetic
  517. operation, and produces a portable anymap as output. The two input anymaps
  518. must be the same width and height.
  519.  
  520. The arithmetic is performed between corresponding pixels in the two
  521. anymaps, as if maxval was 1.0, black was 0.0, and a linear scale in between.
  522. Results that fall outside of [0..1) are truncated.
  523.  
  524. All flags can be abbreviated to their shortest unique prefix.
  525.  
  526.  "SEE ALSO"
  527.  
  528. pbmmask(1), pnmpaste(1), pnminvert(1), pnm(5)
  529.  
  530.  AUTHOR
  531.  
  532. Copyright (C) 1989, 1991 by Jef Poskanzer.
  533. =============================================================================
  534. PNM -> Concatenate
  535. ==================
  536.  
  537. pnmcat - concatenate portable anymaps
  538.  
  539.  SYNOPSIS
  540.  
  541. pnmcat [ -white | -black ] -leftright | -lr [ -jtop | -jbottom ] pnmfile
  542. pnmfile ...
  543.  
  544. pnmcat [ -white | -black ] -topbottom | -tb [ -jleft | -jright ] pnmfile
  545. pnmfile
  546.  ...
  547.  
  548.  DESCRIPTION
  549.  
  550. Reads portable anymaps as input. Concatenates them either left to right or
  551. top to bottom, and produces a portable anymap as output.
  552.  
  553.  OPTIONS
  554.  
  555.  
  556. If the anymaps are not all the same height (left-right) or width (top-bottom),
  557. the smaller ones have to be justified with the largest.
  558. By default, they get centered, but you can specify one side or the other
  559. with one of the -j* flags. So,-topbottom -jleft would stack the anymaps on
  560. top of each other, flush with the left edge. The -white and -black flags
  561. specify what color to use to fill in the extra space when doing this
  562. justification. If neither is specified, the program makes a guess.
  563.  
  564. All flags can be abbreviated to their shortest unique prefix.
  565.  
  566.  "SEE ALSO"
  567.  
  568. pnm(5)
  569.  
  570.  AUTHOR
  571.  
  572. Copyright (C) 1989 by Jef Poskanzer.
  573. =============================================================================
  574. PNM -> Convolution 
  575. ==================
  576.  
  577. pnmconvol - general MxN convolution on a portable anymap
  578.  
  579.  SYNOPSIS
  580.  
  581. pnmconvol convolutionfile [ pnmfile ]
  582.  
  583.  DESCRIPTION
  584.  
  585. Reads two portable anymaps as input. Convolves the second using the first,
  586. and writes a portable anymap as output.
  587.  
  588. Convolution means replacing each pixel with a weighted average of the
  589. nearby pixels.  The weights and the area to average are determined by
  590. the convolution matrix. The unsigned numbers in the convolution file are
  591. offset by -maxval/2 to make signed numbers, and then normalized, so the
  592. actual values in the convolution file are only relative.
  593.  
  594. Here is a sample convolution file;
  595. it does a simple average of the nine immediate neighbors, resulting
  596. in a smoothed image:
  597.  
  598.     P2
  599.     3 3
  600.     18
  601.     10 10 10
  602.     10 10 10
  603.     10 10 10
  604.  
  605.  
  606. To see how this works, do the above-mentioned offset: 10 - 18/2 gives 1.
  607. The possible range of values is from 0 to 18, and after the offset
  608. that's -9 to 9.  The normalization step makes the range -1 to 1, and
  609. the values get scaled correspondingly so they become 1/9 - exactly what
  610. you want.
  611. The equivalent matrix for 5x5 smoothing would have maxval 50 and be
  612. filled with 26.
  613.  
  614. The convolution file will usually be a graymap, so that the same convolution
  615. gets applied to each color component. However, if you want to use a pixmap
  616. and do a different convolution to different colors, you can certainly do
  617. that.
  618.  
  619.  "SEE ALSO"
  620.  
  621. pnmsmooth(1), pnm(5)
  622.  
  623.  AUTHOR
  624.  
  625. Copyright (C) 1989, 1991 by Jef Poskanzer.
  626. =============================================================================
  627. PNM -> Cut
  628. ==========
  629.  
  630. pnmcut - cut a rectangle out of a portable anymap
  631.  
  632.  SYNOPSIS
  633.  
  634. pnmcut x y width height [ pnmfile ]
  635.  
  636.  DESCRIPTION
  637.  
  638. Reads a portable anymap as input. Extracts the specified rectangle, and
  639. produces a portable anymap as output.
  640.  
  641. The x and y can be negative, in which case they are interpreted relative to
  642. the right and bottom of the anymap, respectively.
  643.  
  644.  "SEE ALSO"
  645.  
  646. pnm(5)
  647.  
  648.  AUTHOR
  649.  
  650. Copyright (C) 1989 by Jef Poskanzer.
  651. =============================================================================
  652.  
  653. PNM -> NoRaw
  654. ============
  655.  
  656.  NAME
  657.  
  658. pnmnoraw - force a portable anymap into plain format
  659.  
  660.  SYNOPSIS
  661.  
  662. pnmnoraw [ pnmfile ]
  663.  
  664.  DESCRIPTION
  665.  
  666. Reads a portable anymap as input. Writes it out in plain (non-raw) format.
  667. This is fairly useless if you haven't defined the
  668. PBMPLUS_RAWBITS compile-time option.
  669.  
  670.  "SEE ALSO"
  671.  
  672. pnm(5)
  673.  
  674.  AUTHOR
  675.  
  676. Copyright (C) 1991 by Jef Poskanzer.
  677.  
  678. ***************************************************************************
  679.  
  680. PNM -> Paste
  681. ============
  682.  
  683. pnmpaste - paste a rectangle into a portable anymap
  684.  
  685.  SYNOPSIS
  686.  
  687. pnmpaste [ -replace | -or | -and | -xor ] frompnmfile x y [ intopnmfile ]
  688.  
  689.  DESCRIPTION
  690.  
  691. Reads two portable anymaps as input.
  692. Inserts the first anymap into the second at the specified location,
  693. and produces a portable anymap the same size as the second as output.
  694.  
  695. If the second anymap is not specified, it is read from stdin.
  696. The x and y can be negative, in which case they are interpreted relative to
  697. the right and bottom of the anymap, respectively.
  698.  
  699. This tool is most useful in combination with pnmcut . For instance, if you
  700. want to edit a small segment of a large image, and your image editor cannot
  701. edit the large image, you can cut out the segment you are interested in,
  702. edit it, and then paste it back in.
  703.  
  704. Another useful companion tool is pbmmask .
  705.  
  706. OPTIONS
  707.  
  708. The optional flag specifies the operation to use when doing the paste.
  709. The default is  -replace . The other, logical operations are only allowed if
  710. both input images are bitmaps. These operations act as if white is TRUE and
  711. black is FALSE.
  712.  
  713. All flags can be abbreviated to their shortest unique prefix.
  714.  
  715.  "SEE ALSO"
  716.  
  717. pnmcut(1), pnminvert(1), pnmarith(1), pnm(5), pbmmask(1)
  718.  
  719.  AUTHOR
  720.  
  721.  
  722. Copyright (C) 1989, 1991 by Jef Poskanzer.
  723. ***************************************************************************
  724.  
  725. PNM -> Scale
  726. ============
  727.  
  728.  NAME
  729.  
  730. pnmscale - scale a portable anymap
  731.  
  732.  
  733.  SYNOPSIS
  734.  
  735. pnmscale s [pnmfile]
  736.  
  737. pnmscale -xsize | -width | -ysize | -height s [pnmfile]
  738.  
  739. pnmscale -xscale | -yscale s [pnmfile]
  740.  
  741. pnmscale -xscale | -xsize | -width s -yscale | -ysize | -height s [pnmfile]
  742.  
  743. pnmscale -xysize x y [pnmfile]
  744.  
  745.  
  746.  DESCRIPTION
  747.  
  748. Reads a portable anymap as input. Scales it by the specified factor or
  749. factors and produces a portable anymap as output. If the input file is in
  750. color, the output will be too, otherwise it will be grayscale. You can both
  751. enlarge (scale factor > 1) and reduce (scale factor < 1).
  752.  
  753. You can specify one dimension as a pixel size, and the other dimension
  754. will be scaled correspondingly.
  755.  
  756. You can specify one dimension as a scale, and the other dimension will not
  757. be scaled.
  758.  
  759. You can specify different sizes or scales for each axis.
  760.  
  761. Or, you can use the special -xysize flag, which fits the image into the
  762. specified size without changing the aspect ratio.
  763.  
  764. All flags can be abbreviated to their shortest unique prefix.
  765.  
  766. If you enlarge by a factor of 3 or more, you should probably add a pnmsmooth
  767. step; otherwise, you can see the original pixels in the resulting image.
  768.  
  769.  
  770.  "SEE ALSO"
  771.  
  772. pbmreduce(1), pnmenlarge(1), pnmsmooth(1), pnm(5)
  773.  
  774.  
  775.  AUTHOR
  776.  
  777. Copyright (C) 1989, 1991 by Jef Poskanzer.
  778.  
  779. ***************************************************************************
  780.  
  781. PNM -> Tile
  782. ===========
  783.  
  784.  NAME
  785.  
  786. pnmtile - replicate a portable anymap into a specified size
  787.  
  788.  SYNOPSIS
  789.  
  790. pnmtile width height [ pnmfile ]
  791.  
  792.  
  793.  DESCRIPTION
  794.  
  795. Reads a portable anymap as input.
  796. Replicates it until it is the specified size, and produces a portable anymap
  797. as output.
  798.  
  799.  "SEE ALSO"
  800.  
  801. pnm(5)
  802.  
  803.  AUTHOR
  804.  
  805. Copyright (C) 1989 by Jef Poskanzer.
  806.  
  807. ***************************************************************************