1DJVUPS(1)                        DjVuLibre-3.5                       DJVUPS(1)
2
3
4

NAME

6       djvups - Convert DjVu documents to PostScript.
7
8

SYNOPSIS

10       djvups  [options] [djvufile] [outputfile]
11
12

DESCRIPTION

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

OPTIONS

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

CREDITS

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

SEE ALSO

148       djvu(1), ddjvu(1).  djview(1)
149
150
151
152DjVuLibre-3.5                     01/18/2003                         DJVUPS(1)
Impressum