1pnm2ppa(28 Oct 2000)                                      pnm2ppa(28 Oct 2000)
2
3
4

NAME

6       pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer for‐
7       mat.
8

SYNOPSIS

10       pnm2ppa [options] [ -i infile ] [ -o outfile ]
11
12

DESCRIPTION

14       Reads portable anymap (PNM) format as input. Binary PNM formats  pnmraw
15       = {ppmraw (color pixmap), pgmraw (graymap), and pbmraw (black-and-white
16       bitmap)} are strongly preferred.  Output stream  can  be  locally  pro‐
17       cessed  by  Hewlett-Packard's  Printing  Performance Architecture (PPA)
18       printers (HP DeskJet 710C, 712C, 720C, 722C, 820C, and 1000C series).
19
20       (PNM format output can be produced from  PostScript(tm)  input  by  the
21       GhostScript output devices "pbmraw", "pgmraw" or "ppmraw",  or by "pnm‐
22       raw", which will choose one of these  formats as  appropriate  for  the
23       document.)
24

OPTIONS

26       -b bottommargin
27              Sets  the  bottom  margin  bottommargin in units of 1/600 inches
28              (e.g.,  -b 150 corresponds to 0.25").
29
30
31       -B blackness
32              Sets  the  black  ink  density  blackness  in  drops  per  pixel
33              (0,1,2,3,4).
34
35
36       --bi   Force bidirectional print sweeps.
37
38
39       --bw   Disables  the  color  cartridge;  will print in grey scale using
40              only the black cartridge.
41
42
43       -d     Displays the current configuration.
44
45
46       --eco  Econofast mode: lower print quality that  is  faster  and  saves
47              ink.
48
49
50       -f configFile
51              Re-reads  configuration from configFile (after initially reading
52              it from /etc/pnm2ppa.conf).
53
54
55       -F GammaFile
56              Overrides reading the color-correction table (Gamma curve)  from
57              the default file /etc/pnm2ppa.gamma, and uses GammaFile instead.
58
59
60       --fd   Enable  fast  ordered dithering instead of using the slower, but
61              beautiful, Floyd-Steinberg dithering. (Has  no  effect  in  --bw
62              mode.)
63
64
65       -g     Prints  a  page  of color intensity samples (for comparison with
66              gamma.ppm data produced by calibrate_ppa).  This is  part  of  a
67              color-correction procedure; see COLOR.txt for more details.
68
69
70       -h, --help
71              Displays program usage.
72
73
74       -i infile
75              Input  file  infile  is  either  a path to a PPM file, or '-' to
76              indicate stdin  (defaults to stdin).
77
78
79       -l leftmargin
80              Sets the left margin leftmargin in units of 1/600 inches  (e.g.,
81              -l 150 corresponds to 0.25").
82
83
84       --noGamma
85              Switches off any color-correction.
86
87
88       -o outfile | -
89              Output file outfile is either a path to a file or device, or '-'
90              to indicate stdout (defaults to stdout).
91
92
93       -p     Disables the black ink cartridge; i.e.,  print  using  only  the
94              color  ink  cartridge, even for printing "black".  This might be
95              useful for printing high-quality color  images.
96
97
98       -r rightmargin
99              Sets the right margin  rightmargin  in  units  of  1/600  inches
100              (e.g., -r 150 corresponds to 0.25").
101
102
103       -s papersize
104              Sets  the default paper size (now used only for color-correction
105              output produced by the -g option).  In normal use,  pnm2ppa  now
106              instead  reads the paper dimensions from pnm input file headers,
107              and checks that it is a valid papersize for  the  given  printer
108              model.   Possible values for papersize are a4 (A4), letter or us
109              (US Letter, 8.5"x11"), legal (US Legal, 8.5"x14").  The  default
110              is US Letter.
111
112
113       -t topmargin
114              Sets  the  top  margin topmargin in units of 1/600 inches (ie -t
115              150 corresponds to 0.25").
116
117
118       --uni  Force unidirectional (left to right) print  sweeps.   Useful  if
119              "shearing" is a problem for high quality color images.
120
121
122       -v printertype
123              Selects  the printer model.  Possible values of printertype are:
124              710, 712, 720, 722, 820 and 1000.  The default is the HP DeskJet
125              7X0 Series (710, 712, 720, 722).
126
127
128       --verbose
129              Displays  the program's System Log messages on the standard out‐
130              put, as well.
131
132
133       --version
134              Displays the program's version information.
135
136
137       -x xoffset
138              Sets the x-offset xoffset from the left of the page.  Units  are
139              1/600 inches.
140
141
142       -y yoffset
143              Sets  the  y-offset  yoffset from the top of the page. Units are
144              1/600 inches.
145
146
147

NOTES

149       The default configuration file /etc/pnm2ppa.conf   is  read  in  first.
150       Command line arguments then modify the resulting definitions.
151
152       The  -v option resets all definitions (margins, offsets, etc.)  back to
153       the inbuilt defaults for that printer and should be used before  subse‐
154       quent -b, -l, -r, -t, -x and -y arguments.
155

SEE ALSO

157       pnm(5), ppm(5), pbm(5)
158
159

FILES

161       /etc/pnm2ppa.conf
162              Default configuration file.
163
164
165       /etc/pnm2ppa.gamma
166              Default Gamma (color-correction) file.
167
168

AUTHOR

170       This  code  is  licensed  under  the  GNU Public License version 2. See
171       LICENSE for details.
172
173       (c) 1998-1999  Tim Norman
174
175       (c) 1999  Giorgio Marzano
176
177       (c) 1999  Andrew van der Stock
178
179       (c) 1998-2000  Various authors for many, many fixes
180

HISTORY

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

BUGS

190       Faint  horizontal  lines marking boundaries between print sweeps may be
191       visible.  For best results when printing images, use  the  options   -p
192       --uni .
193
194
195
196
197                                                          pnm2ppa(28 Oct 2000)
Impressum