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
       processed  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)

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

home | help