Debian Codegraph @

upstream/debian-unstable/man1/ppmtopjxl.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmtopjxl User Manual" 1 "14 March 1991" "netpbm documentation"
7
8 .SH NAME
9
10 ppmtopjxl - convert a PPM image to an HP PaintJet XL PCL file
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 ppmtopjxl
16 [\fB-nopack\fP]
17 [\fB-gamma\fP \fIn\fP]
18 [\fB-presentation\fP]
19 [\fB-dark\fP]
20 [\fB-diffuse\fP]
21 [\fB-cluster\fP]
22 [\fB-dither\fP]
23 [\fB-xshift\fP \fIs\fP]
24 [\fB-yshift\fP \fIs\fP]
25 [\fB-xshift\fP \fIs\fP]
26 [\fB-yshift\fP \fIs\fP]
27 [{\fB-xsize\fP|\fB-width\fP|\fB-xscale\fP} \fIs\fP]
28 [{\fB-ysize\fP|\fB-height\fP|\fB-yscale\fP} \fIs\fP]
29 [\fIppmfile\fP]
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 \fBppmtopjxl\fP reads a PPM image as input and produces a PCL file
39 suitable for printing on an HP PaintJet XL printer as output.
40 .PP
41 The generated file is not suitable for printing on a normal
42 PrintJet printer. The \fB-nopack\fP option generates a file which
43 does not use the normal TIFF 4.0 compression method and thus might
44 be printable on a normal PaintJet printer (not an XL).
45
46 .UN options
47 .SH OPTIONS
48 .PP
49 In addition to the options common to all programs based on libnetpbm
50 (most notably \fB-quiet\fP, see
51 .UR index.html#commonoptions
52 Common Options
53 .UE
54 \&), \fBppmtopjxl\fP recognizes the following
55 command line options:
56
57
58
59 .TP
60 \fB-nopack\fP
61 .sp
62 Generate a file which does not use the normal TIFF 4.0 compression
63 method. This file might be printable on a normal PaintJet printer
64 (not an XL).
65
66 .TP
67 \fB-gamma\fP
68 .sp
69 Set the gamma correction for the image. The useful range for the
70 PaintJet XL is approximately 0.6 to 1.5.
71
72 .TP
73 \fB-dither\fP, \fB-cluster\fP, \fB-diffuse\fP
74 .sp
75 Alter the rendering algorithm used for images. These options
76 select ordered dithering, clustered ordered dithering, or error
77 diffusion respectively.
78
79 .TP
80 \fB-dark\fP
81 .sp
82 Enhance images with a dark background when they are reduced in size.
83
84 .TP
85 \fB-presentation\fP
86 .sp
87 Turn on presentation mode, in which two passes are made over the
88 paper to increase ink density. You should use this only for images where
89 quality is critical.
90
91 .TP
92 \fB-xsize\fP, \fB-ysize\fP
93 .sp
94 Resize the image. The parameter to either of these options is
95 interpreted as the number of dots to set the width or height to, but
96 you may append an optional dimension of `\fBpt\fP' (points),
97 `\fBdp\fP' (decipoints), `\fBin\fP' (inches), or `\fBcm\fP'
98 (centimetres). If you specify only one dimension, \fBppmtopjxl\fP
99 will scale the other one appropriately.
100
101 .TP
102 \fB-width\fP, \fB-height\fP
103 .sp
104 Synonyms of \fB-xsize\fP and \fB-ysize\fP.
105
106 .TP
107 \fB-xscale\fP, \fB-yscale\fP
108 .sp
109 Alternatives to \fB-xsize\fP and \fB-ysize\fP. Scale the
110 image by a simple factor.
111
112 .TP
113 \fB-xshift\fP, \fB-yshift\fP
114 .sp
115 Shift the image on the page. These move the image the specified
116 dimensions right and down.
117
118
119
120 .UN seealso
121 .SH SEE ALSO
122 .BR "\fBpnmtopclxl\fP" (1)\c
123 \&,
124 .BR "\fBpbmtolj\fP" (1)\c
125 \&,
126 .BR "\fBppmtolj\fP" (1)\c
127 \&,
128 .BR "\fBppmtopj\fP" (1)\c
129 \&,
130 .BR "\fBthinkjettopbm\fP" (1)\c
131 \&,
132 .BR "ppm" (1)\c
133 \&
134
135 .UN author
136 .SH AUTHOR
137 .PP
138 Angus Duggan
139 .SH DOCUMENT SOURCE
140 This manual page was generated by the Netpbm tool 'makeman' from HTML
141 source. The master documentation is at
142 .IP
143 .B http://netpbm.sourceforge.net/doc/ppmtopjxl.html
144 .PP