Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pnm2ppa(23 Jun 2002)					  pnm2ppa(23 Jun 2002)

NAME
       pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer for-
       mat.

SYNOPSIS
       pnm2ppa [options] [ -i infile ] [ -o outfile ]

DESCRIPTION
       Reads portable anymap (PNM) format as input. Binary PNM formats	pnmraw
       = {ppmraw (color	pixmap), pgmraw	(graymap), and pbmraw (black-and-white
       bitmap)}	are strongly preferred.	 Output	stream	can  be	 locally  pro-
       cessed  by  Hewlett-Packard's  Printing	Performance Architecture (PPA)
       printers	(HP DeskJet 710C, 712C,	720C, 722C, 820C, and 1000C series).

       (PNM format output can be produced from	PostScript(tm)	input  by  the
       GhostScript output devices "pbmraw", "pgmraw" or	"ppmraw",  or by "pnm-
       raw", which will	choose one of these  formats as	 appropriate  for  the
       document.)   pnm2ppa  assumes the input resolution is 600dpi (or	300dpi
       if the command-line option --dpi300 is  used):  input  at  higher/lower
       resolutions will	result in a correspondingly larger/smaller printed im-
       age, provided it	is within the printer's	allowed	size range.

OPTIONS
       -b bottommargin
	      Sets the bottom margin bottommargin in  units  of	 1/600	inches
	      (e.g.,  -b 150 corresponds to 0.25").

       -B blackness
	      Sets  the	 black	ink  density  blackness	 in  drops  per	 pixel
	      (0,1,2,3,4).

       --bi   Force bidirectional print	sweeps.

       --bw   Disables the color cartridge; will print	in  grey  scale	 using
	      only the black cartridge.

       -d     Displays the current configuration.

       --dpi300
	      Treat input resolution as	300dpi instead of 600dpi.

       --eco  Econofast	 mode:	lower  print  quality that is faster and saves
	      ink.

       -f configFile
	      Re-reads configuration from configFile (after initially  reading
	      it from /usr/local/etc/pnm2ppa.conf).

       -F GammaFile
	      Overrides	 reading the color-correction table (Gamma curve) from
	      the default file	/usr/local/etc/pnm2ppa.gamma,  and  uses  Gam-
	      maFile instead.

       --fd   Enable  fast  ordered dithering instead of using the slower, but
	      beautiful, Floyd-Steinberg dithering. (Has  no  effect  in  --bw
	      mode.)

       -g     Prints  a	 page  of color	intensity samples (for comparison with
	      gamma.ppm	data produced by calibrate_ppa).  This is  part	 of  a
	      color-correction procedure; see COLOR.txt	for more details.

       -h, --help
	      Displays program usage.

       -i infile
	      Input  file infile is either a path to a PPM file, or '-'	to in-
	      dicate stdin  (defaults to stdin).

       -l leftmargin
	      Sets the left margin leftmargin in units of 1/600	inches	(e.g.,
	      -l 150 corresponds to 0.25").

       --noGamma
	      Switches off any color-correction.

       -o outfile | -
	      Output file outfile is either a path to a	file or	device,	or '-'
	      to indicate stdout (defaults to stdout).

       -p     Disables the black ink cartridge;	i.e.,  print  using  only  the
	      color  ink  cartridge, even for printing "black".	 This might be
	      useful for printing high-quality color  images.

       -r rightmargin
	      Sets the right margin  rightmargin  in  units  of	 1/600	inches
	      (e.g., -r	150 corresponds	to 0.25").

       -s papersize
	      Sets  the	default	paper size (now	used only for color-correction
	      output produced by the -g	option).  In normal use,  pnm2ppa  now
	      instead  reads the paper dimensions from pnm input file headers,
	      and checks that it is a valid papersize for  the	given  printer
	      model.   Possible	values for papersize are a4 (A4), letter or us
	      (US Letter, 8.5"x11"), legal (US Legal, 8.5"x14").  The  default
	      is US Letter.

       -t topmargin
	      Sets  the	 top  margin topmargin in units	of 1/600 inches	(ie -t
	      150 corresponds to 0.25").

       --uni  Force unidirectional (left to right) print  sweeps.   Useful  if
	      "shearing" is a problem for high quality color images.

       -v printertype
	      Selects  the printer model.  Possible values of printertype are:
	      710, 712,	720, 722, 820 and 1000.	 The default is	the HP DeskJet
	      7X0 Series (710, 712, 720, 722).

       --verbose
	      Displays	the program's System Log messages on the standard out-
	      put, as well.

       --version
	      Displays the program's version information.

       -x xoffset
	      Sets the x-offset	xoffset	from the left of the page.  Units  are
	      1/600 inches.

       -y yoffset
	      Sets  the	 y-offset  yoffset from	the top	of the page. Units are
	      1/600 inches.

NOTES
       The default configuration file /usr/local/etc/pnm2ppa.conf  is read  in
       first. Command line arguments then modify the resulting definitions.

       The  -v option resets all definitions (margins, offsets,	etc.)  back to
       the inbuilt defaults for	that printer and should	be used	before	subse-
       quent -b, -l, -r, -t, -x	and -y arguments.

SEE ALSO
       pnm(5), ppm(5), pbm(5)

FILES
       /usr/local/etc/pnm2ppa.conf
	      Default configuration file.

       /usr/local/etc/pnm2ppa.gamma
	      Default Gamma (color-correction) file.

AUTHOR
       This  code  is licensed under the GNU Public License version 2. See LI-
       CENSE for details.

       (c) 1998-1999  Tim Norman

       (c) 1999	 Giorgio Marzano

       (c) 1999	 Andrew	van der	Stock

       (c) 1998-2002  Various authors for many,	many fixes

HISTORY
       This program was	originally pbm2ppa, written by Tim Norman.  It	origi-
       nally  supported	 black	and white output on the	820 series.  Tim added
       nascent color support in	early  1999.  In  May  1999,  Giorgio  Marzano
       started	making real headway in getting color support working properly.
       Andrew van der Stock has	maintained the code since September 1999,  and
       made it available at http://sourceforge.net/projects/pnm2ppa.

BUGS
       Faint  horizontal  lines	marking	boundaries between print sweeps	may be
       visible.	 You may get better results when printing images, with the op-
       tions:
	 -p --uni  (this may no	longer apply since recent code improvements).

							  pnm2ppa(23 Jun 2002)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | SEE ALSO | FILES | AUTHOR | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pnm2ppa&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help