~ubuntu-branches/ubuntu/raring/djvulibre/raring

« back to all changes in this revision

Viewing changes to tools/ddjvu.1

  • Committer: Package Import Robot
  • Author(s): Barak A. Pearlmutter
  • Date: 2012-11-12 11:06:39 UTC
  • mfrom: (12.2.29 sid)
  • Revision ID: package-import@ubuntu.com-20121112110639-4krorcf3oypxpkq1
Tags: 3.5.25.3-3
* multiarch fix via dh-exec lossage
* merge upstream fixes

Show diffs side-by-side

added added

removed removed

Lines of Context:
43
43
However a valid output file name is always required when producing a
44
44
TIFF or PDF file.
45
45
 
46
 
 
47
46
.SH MAIN OPTIONS
48
47
.TP
49
48
.BI "-format=" "fmt"
83
82
.IP "*"
84
83
Format
85
84
.B "tiff"
86
 
produces a Tagged Image Format (TIFF) file.
87
 
The resulting file uses the best available 
88
 
lossless compression model.
 
85
produces a Tagged Image Format (TIFF) 
 
86
file using lossless compression.
89
87
Enabling lossy JPEG compression (see option 
90
88
.BI "-quality"
91
89
below) often produces much smaller files.
101
99
produces a Portable Document Format (PDF) file.
102
100
Each page in the resulting file is represented
103
101
by an image at the specified resolution,
104
 
using the best available lossless compression model.
 
102
using lossless compression.
105
103
Enabling lossy JPEG compression (see option 
106
104
.BI "-quality"
107
105
below) often produces much smaller files.
145
143
outputs pages 1 and 3, followed by all the document
146
144
pages in reverse order up to page 4.
147
145
.TP
 
146
.BI "-eachpage"
 
147
When this option is specified, program
 
148
.B ddjvu
 
149
generates one separate file per page
 
150
named by replacing the 
 
151
.B %d
 
152
specification in 
 
153
.I outputfilename
 
154
by the page number 
 
155
in a manner simular to the 
 
156
.BR printf (3)
 
157
function.
 
158
.TP
148
159
.BI "-mode=" "mod"
149
160
Selects which layers of the DjVu image should be rendered.
150
161
Valid rendering modes are 
260
271
when this option is specified.
261
272
.TP
262
273
.BI "-quality=" "factor"
263
 
Enables lossy compression in TIFF and PDF files.
264
 
Without this option, TIFF or PDF output files always 
265
 
use lossless compression or no compression.  
 
274
Enables lossy JPEG compression for TIFF and PDF files.
 
275
This option only affects images that cannot be encoded
 
276
using the preferred TIFF/G4 compression.
266
277
Argument 
267
278
.I factor
268
 
specifies a JPEG quantization factor 
269
 
ranging from 25 to 150. See command 
 
279
is a quantization factor ranging from 25 to 150. 
 
280
See command 
270
281
.BR cjpeg (1)
271
282
for more information on JPEG quantization factors.
272
283
Value 80 is a good starting point.
273
 
.TP
274
 
.B "-quality=uncompressed"
 
284
.TP 
 
285
.BR "-quality=uncompressed"
275
286
Completely disables compression in TIFF and PDF files.
276
287
Although the resulting files are often huge,
277
288
this is sometimes useful for maximal compatibility
278
289
with hastily written software.
 
290
.TP
 
291
.BR "-quality=deflate"
 
292
Enables DEFLATE compression for TIFF files.
 
293
Images that cannot be encoded using the preferred TIFF/G4 compression
 
294
will be encoded with DEFLATE compression if available.
 
295
Otherwise the more portable PACKBITS compression is used.
 
296
Specifying this option is not necessary for PDF files
 
297
because this is the default behavior.
279
298
 
280
299
.SH DEPRECATED OPTIONS
281
300
 
315
334
 
316
335
Command
317
336
.IP "" 3
318
 
.BI "ddjvu -format=ppm -page=1 -size=100x100 " "myfile.djvu" " -"
 
337
.BI "ddjvu -format=ppm -page=1-10 -eachpage -size=100x100 " "myfile.djvu" " thumb%03d.ppm"
319
338
.PP
320
 
produces a thumbnail for the first page of a document and 
321
 
outputs it as a PPM file on the standard output.
 
339
produces 100x100 thumbnails for the first ten page of a document 
 
340
and outputs them as PPM files named
 
341
.BR thumb001.ppm
 
342
to 
 
343
.BR thumb010.ppm .
322
344
 
323
345
.SH CREDITS
324
346
The new version of this program was written 
338
360
.BR ppm (5),
339
361
.BR cjpeg (1),
340
362
.BR tiffsplit (1),
341
 
.BR tiffcp (1)
 
363
.BR tiffcp (1),
 
364
.BR printf (3)