{ "content": [ { "type": "text", "text": "# pnmtops(1) (man)\n\n**Summary:** pnmtops - convert portable anymap to PostScript\n\n**Synopsis:** pnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight n] [-width=N] [-height=N]\n[-equalpixels] [-turn|-noturn] [-rle|-runlength] [-nocenter] [-setpage] [-nosetpage] [pnm‐\nfile]\nAll options can be abbreviated to their shortest unique prefix. You may use two hyphens in‐\nstead of one. You may separate an option name and its value with white space instead of an\nequals sign.\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | — | — | -imageheight Tells how wide and high you want the image on the page, in inches. The aspect ratio of the image is preserv |\n| — | — | — | This option causes the output image to have the same number of pixels as the input im‐ age. So if the output device is 6 |\n| — | — | — | output image that you want 72 pixels of the input to generate. But pnmtops rounds the number to something that is an int |\n| — | — | — | dpi. In theory PostScript is device-independent and you don't have to worry about this, but in practice its raster rende |\n| — | — | — | -height These options specify the dimensions of the page on which the output is to be printed. This can affect the size |\n| — | — | — | an image fits the page better when turned (e.g. the image is wider than it is tall, but the page is taller than it is wi |\n| — | — | — | if the host-to-printer link is slow; but normally the printer's processing time domi‐ nates, so -rle makes things slower |\n| — | — | — | By default, pnmtops centers the image on the output page. You can cause pnmtops to instead put the image against the upp |\n| — | — | — | pnmtops can generate a \"setpagedevice\" directive to tell the printer/plotter what size paper to use (or cut). The dimens |\n\n## See Also\n\n- pnm(5)\n- gs(1)\n- psidtopgm(1)\n- pstopnm(1)\n- pbmtolps(1)\n- pbmtoepsi(1)\n- pbmtopsg3(1)\n- topgm(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (10 lines)\n- **DESCRIPTION** (14 lines)\n- **OPTIONS** (1 lines) — 9 subsections\n - -imagewidth (10 lines)\n - -equalpixels (7 lines)\n - -scale (13 lines)\n - -dpi (7 lines)\n - -width (13 lines)\n - -turn -noturn (5 lines)\n - -rle -runlength (3 lines)\n - -nocenter (8 lines)\n - -setpage (12 lines)\n- **SEE ALSO** (4 lines)\n- **AUTHOR** (6 lines)\n\n## Full Content\n\n### NAME\n\npnmtops - convert portable anymap to PostScript\n\n### SYNOPSIS\n\npnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight n] [-width=N] [-height=N]\n[-equalpixels] [-turn|-noturn] [-rle|-runlength] [-nocenter] [-setpage] [-nosetpage] [pnm‐\nfile]\n\n\nAll options can be abbreviated to their shortest unique prefix. You may use two hyphens in‐\nstead of one. You may separate an option name and its value with white space instead of an\nequals sign.\n\n### DESCRIPTION\n\nReads a Netpbm image as input. Produces Encapsulated PostScript as output.\n\nIf the input file is in color (PPM), pnmtops generates a color PostScript file. Some Post‐\nScript interpreters can't handle color PostScript. If you have one of these you will need to\nrun your image through ppmtopgm first.\n\nIf you specify no output dimensioning options, the output image is dimensioned as if you had\nspecified -scale=1.0, which means aproximately 72 pixels of the input image generate one inch\nof output (if that fits the page).\n\nUse -imagewidth, -imageheight, -equalpixels, -width, -height, and -scale to adjust that.\n\n### OPTIONS\n\n#### -imagewidth\n\n-imageheight Tells how wide and high you want the image on the page, in inches. The\naspect ratio of the image is preserved, so if you specify both of these, the image on\nthe page will be the largest image that will fit within the box of those dimensions.\n\nIf these dimensions are greater than the page size, you get Postscript output that\nruns off the page.\n\nYou cannot use imagewidth or imageheight with -scale or -equalpixels.\n\n#### -equalpixels\n\nThis option causes the output image to have the same number of pixels as the input im‐\nage. So if the output device is 600 dpi and your image is 3000 pixels wide, the out‐\nput image would be 5 inches wide.\n\nYou cannot use -equalpixels with -imagewidth, -imageheight, or -scale.\n\n#### -scale\n\noutput image that you want 72 pixels of the input to generate.\n\nBut pnmtops rounds the number to something that is an integral number of output device\npixels. E.g. if the output device is 300 dpi and you specify -scale=1.0, then 75 (not\n72) pixels of input becomes one inch of output (4 output pixels for each input pixel).\nNote that the -dpi option tell pnmtops how many pixels per inch the output device gen‐\nerates.\n\nIf the size so specified does not fit on the page (as measured either by the -width\nand -height options or the default page size of 8.5 inches by 11 inches), pnmtops ig‐\nnores the -scale option, issues a warning, and scales the image to fit on the page.\n\n#### -dpi\n\ndpi. In theory PostScript is device-independent and you don't have to worry about\nthis, but in practice its raster rendering can have unsightly bands if the device pix‐\nels and the image pixels aren't in sync.\n\nAlso this option is crucial to the working of the equalpixels option.\n\n#### -width\n\n-height These options specify the dimensions of the page on which the output is to be\nprinted. This can affect the size of the output image.\n\nThe page size has no effect, however, when you specify the -imagewidth, -imageheight,\nor -equalpixels options.\n\nThese options may also affect positioning of the image on the page and even the paper\nselected (or cut) by the printer/plotter when the output is printed. See the -noset‐‐\npage option.\n\nThe default is 8.5 inches by 11 inches.\n\n#### -turn -noturn\n\nan image fits the page better when turned (e.g. the image is wider than it is tall,\nbut the page is taller than it is wide), it gets turned automatically to better fit\nthe page. If you specify the -turn option, pnmtops turns the image no matter what its\nshape; If you specify -noturn, pnmtops does not turn it no matter what its shape.\n\n#### -rle -runlength\n\nif the host-to-printer link is slow; but normally the printer's processing time domi‐\nnates, so -rle makes things slower.\n\n#### -nocenter\n\nBy default, pnmtops centers the image on the output page. You can cause pnmtops to\ninstead put the image against the upper left corner of the page with the -nocenter op‐\ntion. This is useful for programs which can include PostScript files, but can't cope\nwith pictures which are not positioned in the upper left corner.\n\nFor backward compatibility, pnmtops accepts the option -center, but it has no effect.\n\n#### -setpage\n\npnmtops can generate a \"setpagedevice\" directive to tell the printer/plotter what size\npaper to use (or cut). The dimensions it specifies on this directive are those se‐\nlected or defaulted by the width and height options or defaulted. If you want a \"set‐\npagedevice\" directive in the output, specify -setpage. This can be useful if your\nprinter chokes on this directive, which has not always been defined in Postscript, or\nyou want to fake out the printer and print on one size paper as if you're printing on\nanother.\n\nBefore release 10.0 the default was to generate the \"setpagedevice\" directive, and\nthere is the switch -nosetpage to supress it, but that's actually a no-op now.\n\n### SEE ALSO\n\npnm(5), gs(1), psidtopgm(1), pstopnm(1), pbmtolps(1), pbmtoepsi(1), pbmtopsg3(1), ppm‐‐\ntopgm(1),\n\n### AUTHOR\n\nCopyright (C) 1989, 1991 by Jef Poskanzer.\nModified November 1993 by Wolfgang Stuerzlinger, wrzl@gup.uni-linz.ac.at\n\n\n\n25 May 2001 pnmtops(1)\n\n" } ], "structuredContent": { "command": "pnmtops", "section": "1", "mode": "man", "summary": "pnmtops - convert portable anymap to PostScript", "synopsis": "pnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight n] [-width=N] [-height=N]\n[-equalpixels] [-turn|-noturn] [-rle|-runlength] [-nocenter] [-setpage] [-nosetpage] [pnm‐\nfile]\nAll options can be abbreviated to their shortest unique prefix. You may use two hyphens in‐\nstead of one. You may separate an option name and its value with white space instead of an\nequals sign.", "flags": [ { "flag": "", "long": null, "arg": null, "description": "-imageheight Tells how wide and high you want the image on the page, in inches. The aspect ratio of the image is preserved, so if you specify both of these, the image on the page will be the largest image that will fit within the box of those dimensions. If these dimensions are greater than the page size, you get Postscript output that runs off the page. You cannot use imagewidth or imageheight with -scale or -equalpixels." }, { "flag": "", "long": null, "arg": null, "description": "This option causes the output image to have the same number of pixels as the input im‐ age. So if the output device is 600 dpi and your image is 3000 pixels wide, the out‐ put image would be 5 inches wide. You cannot use -equalpixels with -imagewidth, -imageheight, or -scale." }, { "flag": "", "long": null, "arg": null, "description": "output image that you want 72 pixels of the input to generate. But pnmtops rounds the number to something that is an integral number of output device pixels. E.g. if the output device is 300 dpi and you specify -scale=1.0, then 75 (not 72) pixels of input becomes one inch of output (4 output pixels for each input pixel). Note that the -dpi option tell pnmtops how many pixels per inch the output device gen‐ erates. If the size so specified does not fit on the page (as measured either by the -width and -height options or the default page size of 8.5 inches by 11 inches), pnmtops ig‐ nores the -scale option, issues a warning, and scales the image to fit on the page." }, { "flag": "", "long": null, "arg": null, "description": "dpi. In theory PostScript is device-independent and you don't have to worry about this, but in practice its raster rendering can have unsightly bands if the device pix‐ els and the image pixels aren't in sync. Also this option is crucial to the working of the equalpixels option." }, { "flag": "", "long": null, "arg": null, "description": "-height These options specify the dimensions of the page on which the output is to be printed. This can affect the size of the output image. The page size has no effect, however, when you specify the -imagewidth, -imageheight, or -equalpixels options. These options may also affect positioning of the image on the page and even the paper selected (or cut) by the printer/plotter when the output is printed. See the -noset‐‐ page option. The default is 8.5 inches by 11 inches." }, { "flag": "", "long": null, "arg": null, "description": "an image fits the page better when turned (e.g. the image is wider than it is tall, but the page is taller than it is wide), it gets turned automatically to better fit the page. If you specify the -turn option, pnmtops turns the image no matter what its shape; If you specify -noturn, pnmtops does not turn it no matter what its shape." }, { "flag": "", "long": null, "arg": null, "description": "if the host-to-printer link is slow; but normally the printer's processing time domi‐ nates, so -rle makes things slower." }, { "flag": "", "long": null, "arg": null, "description": "By default, pnmtops centers the image on the output page. You can cause pnmtops to instead put the image against the upper left corner of the page with the -nocenter op‐ tion. This is useful for programs which can include PostScript files, but can't cope with pictures which are not positioned in the upper left corner. For backward compatibility, pnmtops accepts the option -center, but it has no effect." }, { "flag": "", "long": null, "arg": null, "description": "pnmtops can generate a \"setpagedevice\" directive to tell the printer/plotter what size paper to use (or cut). The dimensions it specifies on this directive are those se‐ lected or defaulted by the width and height options or defaulted. If you want a \"set‐ pagedevice\" directive in the output, specify -setpage. This can be useful if your printer chokes on this directive, which has not always been defined in Postscript, or you want to fake out the printer and print on one size paper as if you're printing on another. Before release 10.0 the default was to generate the \"setpagedevice\" directive, and there is the switch -nosetpage to supress it, but that's actually a no-op now." } ], "examples": [], "see_also": [ { "name": "pnm", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/pnm/5/json" }, { "name": "gs", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/gs/1/json" }, { "name": "psidtopgm", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/psidtopgm/1/json" }, { "name": "pstopnm", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pstopnm/1/json" }, { "name": "pbmtolps", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pbmtolps/1/json" }, { "name": "pbmtoepsi", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pbmtoepsi/1/json" }, { "name": "pbmtopsg3", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pbmtopsg3/1/json" }, { "name": "topgm", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/topgm/1/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 10, "subsections": [] }, { "name": "DESCRIPTION", "lines": 14, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-imagewidth", "lines": 10 }, { "name": "-equalpixels", "lines": 7 }, { "name": "-scale", "lines": 13 }, { "name": "-dpi", "lines": 7 }, { "name": "-width", "lines": 13 }, { "name": "-turn -noturn", "lines": 5 }, { "name": "-rle -runlength", "lines": 3 }, { "name": "-nocenter", "lines": 8 }, { "name": "-setpage", "lines": 12 } ] }, { "name": "SEE ALSO", "lines": 4, "subsections": [] }, { "name": "AUTHOR", "lines": 6, "subsections": [] } ] } }