summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/ppmtopjxl.1
blob: d3508b738904a909a3c607086bd35d7662f49913 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmtopjxl User Manual" 0 "14 March 1991" "netpbm documentation"

.SH NAME

ppmtopjxl - convert a PPM image to an HP PaintJet XL PCL file

.UN synopsis
.SH SYNOPSIS

ppmtopjxl 
[\fB-nopack\fP] 
[\fB-gamma\fP \fIn\fP] 
[\fB-presentation\fP] 
[\fB-dark\fP] 
[\fB-diffuse\fP] 
[\fB-cluster\fP] 
[\fB-dither\fP] 
[\fB-xshift\fP \fIs\fP] 
[\fB-yshift\fP \fIs\fP] 
[\fB-xshift\fP \fIs\fP] 
[\fB-yshift\fP \fIs\fP] 
[{\fB-xsize\fP|\fB-width\fP|\fB-xscale\fP} \fIs\fP] 
[{\fB-ysize\fP|\fB-height\fP|\fB-yscale\fP} \fIs\fP] 
[\fIppmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmtopjxl\fP reads a PPM image as input and produces a PCL file
suitable for printing on an HP PaintJet XL printer as output.
.PP
The generated file is not suitable for printing on a normal
PrintJet printer.  The \fB-nopack\fP option generates a file which
does not use the normal TIFF 4.0 compression method and thus might
be printable on a normal PaintJet printer (not an XL).

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBppmtopjxl\fP recognizes the following
command line options:



.TP
\fB-nopack\fP
.sp
Generate a file which does not use the normal TIFF 4.0 compression
method. This file might be printable on a normal PaintJet printer
(not an XL).

.TP
\fB-gamma\fP
.sp
Set the gamma correction for the image. The useful range for the
PaintJet XL is approximately 0.6 to 1.5.

.TP
\fB-dither\fP, \fB-cluster\fP, \fB-diffuse\fP
.sp
Alter the rendering algorithm used for images.  These options
select ordered dithering, clustered ordered dithering, or error
diffusion respectively.

.TP
\fB-dark\fP
.sp
Enhance images with a dark background when they are reduced in size.

.TP
\fB-presentation\fP
.sp
Turn on presentation mode, in which two passes are made over the
paper to increase ink density.  You should use this only for images where
quality is critical.

.TP
\fB-xsize\fP, \fB-ysize\fP
.sp
Resize the image.  The parameter to either of these options is
interpreted as the number of dots to set the width or height to, but
you may append an optional dimension of `\fBpt\fP' (points),
`\fBdp\fP' (decipoints), `\fBin\fP' (inches), or `\fBcm\fP'
(centimetres).  If you specify only one dimension, \fBppmtopjxl\fP
will scale the other one appropriately.

.TP
\fB-width\fP, \fB-height\fP
.sp
Synonyms of \fB-xsize\fP and \fB-ysize\fP.

.TP
\fB-xscale\fP, \fB-yscale\fP
.sp
Alternatives to \fB-xsize\fP and \fB-ysize\fP.  Scale the
image by a simple factor.

.TP
\fB-xshift\fP, \fB-yshift\fP
.sp
Shift the image on the page.  These move the image the specified
dimensions right and down.



.UN seealso
.SH SEE ALSO
.BR "\fBpnmtopclxl\fP" (1)\c
\&,
.BR "\fBpbmtolj\fP" (1)\c
\&,
.BR "\fBppmtolj\fP" (1)\c
\&,
.BR "\fBppmtopj\fP" (1)\c
\&,
.BR "\fBthinkjettopbm\fP" (1)\c
\&,
.BR "ppm" (5)\c
\&

.UN author
.SH AUTHOR
.PP
Angus Duggan
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/ppmtopjxl.html
.PP