pnmtops man page on Slackware

Man page or keyword search:  
man Server   14563 pages
apropos Keyword Search (all sections)
Output format
Slackware logo
[printable version]

pnmtops(1)							    pnmtops(1)

NAME
       pnmtops - convert portable anymap to PostScript

SYNOPSIS
       pnmtops [-scale s] [-dpi n] [-imagewidth n] [-imageheight n] [-width=N]
       [-height=N] [-equalpixels] [-turn|-noturn]  [-rle|-runlength]  [-nocen‐
       ter] [-nosetpage] [pnmfile]

       All  options  can  be abbreviated to their shortest unique prefix.  You
       may use two hyphens instead of one.  You may separate  an  option  name
       and its value with white space instead of an equals sign.

DESCRIPTION
       Reads  a	 Netpbm	 image	as input.  Produces Encapsulated PostScript as
       output.

       If the input file is in color (PPM), pnmtops generates  a  color	 Post‐
       Script  file.   Some  PostScript	 interpreters can't handle color Post‐
       Script.	If you have one of these you  will  need  to  run  your	 image
       through ppmtopgm first.

       If  you	specify	 no  output  dimensioning options, the output image is
       dimensioned as if you had specified  -scale=1.0,	 which	means  aproxi‐
       mately  72  pixels  of  the input image generate one inch of output (if
       that fits the page).

       Use  -imagewidth,  -imageheight,	 -equalpixels,	-width,	 -height,  and
       -scale to adjust that.

OPTIONS
       -imagewidth
	      -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.

       -equalpixels
	      This option causes the output image to have the same  number  of
	      pixels  as  the input image.  So if the output device is 600 dpi
	      and your image is 3000 pixels wide, the output image would be  5
	      inches wide.

	      You  cannot  use -equalpixels with -imagewidth, -imageheight, or
	      -scale.

       -scale tells how big you want the image on the page.  The value is  the
	      number  of inches of 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 generates.

	      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 ignores the -scale
	      option, issues a warning, and scales the image  to  fit  on  the
	      page.

       -dpi   This  option  specifies the dots per inch of your output device.
	      The default is 300 dpi.  In theory PostScript is device-indepen‐
	      dent and you don't have to worry about this, but in practice its
	      raster rendering can have unsightly bands if the	device	pixels
	      and the image pixels aren't in sync.

	      Also  this  option  is crucial to the working of the equalpixels
	      option.

       -width
	      -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 -nosetpage option.

	      The default is 8.5 inches by 11 inches.

       -turn  -noturn  These  options control whether the image gets turned 90
	      degrees.	Normally, if 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.

       -rle   -runlength  These	 identical options specify run-length compres‐
	      sion.  This may save time if the host-to-printer link  is	 slow;
	      but  normally  the  printer's processing time dominates, so -rle
	      makes things slower.

       -nocenter
	      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 option.  This is use‐
	      ful  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.

       -nosetpage
	      pnmtops normally generates a "setpagedevice" directive  to  tell
	      the printer/plotter what size paper to use (or cut).  The dimen‐
	      sions it specifies on  this  directive  are  those  selected  or
	      defaulted	 by the width and height options or defaulted.	If you
	      don't want a "setpagedevice" directive in	 the  output,  specify
	      -nosetpage.   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.

SEE ALSO
       pnm(5), gs(1),  psidtopgm(1),  pstopnm(1),  pbmtolps(1),	 pbmtoepsi(1),
       pbmtopsg3(1), ppmtopgm(1),

AUTHOR
       Copyright (C) 1989, 1991 by Jef Poskanzer.
       Modified	  November   1993   by	Wolfgang  Stuerzlinger,	 wrzl@gup.uni-
       linz.ac.at

				  25 May 2001			    pnmtops(1)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Slackware

List of man pages available for Slackware

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net