1DJVUPS(1) DjVuLibre-3.5 DJVUPS(1)
2
3
4
6 djvups - Convert DjVu documents to PostScript.
7
8
10 djvups [options] [djvufile] [outputfile]
11
12
14 This program decodes DjVu file djvufile, and generates a PostScript
15 file named outputfile. The DjVu data is read from the standard input
16 when argument djvufile is not specified or when it is equal to a single
17 dash. Similarly, the output data is written to the standard output
18 when argument outputfile is not specified or equal to a single dash.
19
20 PostScript printers have various capabilities. Investigate options
21 -level and -gray for obtaining the best results.
22
23
25 -help Prints the list of recognized options.
26
27 -verbose
28 Displays a progress bar.
29
30 -page=pagespec
31 Specify the document pages to be converted. The page specifica‐
32 tion pagespec contains one or more comma-separated page ranges.
33 A page range is either a page number, or two page numbers sepa‐
34 rated by a dash. Specification 1-10, for instance, prints pages
35 1 to 10. Specification 1,3,99999-4 prints pages 1 and 3, fol‐
36 lowed by all the document pages in reverse order up to page 4.
37
38 -format=ps
39 Produce a PostScript file. This is the default.
40
41 -format=eps
42 Produce an Encapsulated PostScript file. Encapsulated Post‐
43 Script files are suitable for embedding images into other docu‐
44 ments. Encapsulated PostScript file can only contain a single
45 page. Setting this option overrides the options -copies, -orien‐
46 tation, -zoom, -cropmarks, and -booklet.
47
48 -copies=n
49 Specify the number of copies to print.
50
51 -orientation=orient
52 Specify whether pages should be printed using the auto, por‐
53 trait, or landscape orientation.
54
55 -mode=modespec
56 Specify how pages should be decoded. The default mode, color,
57 renders all the layers of the DjVu documents. Mode black only
58 renders the foreground layer mask. This mode does not work with
59 DjVuPhoto images because these files have no foreground layer
60 mask. Modes foreground and background only render the fore‐
61 ground layer or the background layer of a DjVuDocument image.
62
63 -zoom=zoomspec
64 Specify a zoom factor zoomspec. The default zoom factor, auto,
65 scales the image to fit the page. Argument zoomspec also can be
66 a number in range 25 to 2400 representing a magnification per‐
67 centage relative to the original size of the document.
68
69 -frame=yesno
70 Specifying yes causes the generation of a thin gray border rep‐
71 resenting the boundaries of the document pages. The default is
72 no.
73
74 -cropmarks=yesno
75 Specifying yes causes the generation of crop marks indicating
76 where pages should be cut. The default is no.
77
78 -level=languagelevel
79 Select the language level of the generated PostScript. lan‐
80 guagelevel. Valid language levels are 1, 2, and 3. Level 3
81 produces the most compact and fast printing PostScript files.
82 Some of these files however require a very modern printer.
83 Level 2 is the default value. The generated PostScript files
84 are almost as compact and work with all but the oldest Post‐
85 Script printers. Level 1 can be used as a last resort option.
86
87 -color=yesno
88 The default value, yes, generates a color PostScript file.
89 Specifying value no converts the image to gray scale. The
90 resulting PostScript file is smaller and marginally more porta‐
91 ble.
92
93 -gray This option is equivalent to option -color=no and is provided
94 for convenience.
95
96 -colormatch=yesno
97 The default value, yes, generates a PostScript file using device
98 independent colors in compliance with the sRGB specification.
99 Modern printers then produce colors that match the original as
100 well as possible. Specifying value no generates a PostScript
101 file using device dependent colors. This is sometimes useful
102 with older printers. You can then use option -gamma to tune the
103 output colors.
104
105 -gamma=gammaspec
106 Specify a gamma correction factor for the device dependent Post‐
107 Script colors. Argument gammaspec must be in range 0.3 to 5.0.
108 Gamma correction normally pertains to cathodic screens only. It
109 gets meaningful for printers because several models interpret
110 device dependent RGB colors by emulating the color response of a
111 cathodic tube.
112
113 -booklet=opt
114 Turns the booklet printing mode on. The booklet mode prints two
115 pages on each side in a way suitable for making a booklet by
116 folding the sheets. Option opt can take values no for disabling
117 the booklet mode, yes for enabling the recto/verso booklet mode,
118 and recto or verso to print only one side of each sheet.
119
120 -bookletmax=max
121 Specifies the maximal number of pages per booklet. A single
122 printout might then be composed of several booklets. Argument
123 max is rounded up to the next multiple of 4. Specifying 0 sets
124 no maximal number of pages and ensures that the printout will
125 produce a single booklet. This is the default.
126
127 -bookletalign=align
128 Specifies a positive or negative offset applied to the verso of
129 each sheet. Argument align is expressed in points (one point is
130 1/72th of an inch, or 0.352 millimeter) This is useful with cer‐
131 tain printers to ensure that both recto and verso are properly
132 aligned. The default value is of course 0.
133
134 -bookletfold=base[+incr]
135 Specifies the extra margin left between both pages on a single
136 sheet. The base value base is expressed in points (one point is
137 1/72th of an inch, or 0.352 millimeter). This margin is incre‐
138 mented for each outer sheet by value incr expressed in milli‐
139 points. The default value is 18+200.
140
141
143 This program was written by Léon Bottou <leonb@users.sourceforge.net>,
144 Andrei Erofeev <andrew_erofeev@yahoo.com>, and Florin Nicsa.
145
146
148 djvu(1), ddjvu(1). djview(1)
149
150
151
152DjVuLibre-3.5 01/18/2003 DJVUPS(1)