NAME
djvups - Convert DjVu documents to PostScript.
SYNOPSIS
djvups [options]
[djvufile] [outputfile]
DESCRIPTION
This program decodes DjVu file djvufile,
and generates a PostScript file named outputfile. The DjVu
data is read from the standard input when argument djvufile
is not specified or when it is equal to a single dash. Similarly,
the output data is written to the standard output when argument
outputfile is not specified or equal to a single dash.
PostScript printers have various capabilities. Investigate
options -level and -gray for obtaining the best
results.
OPTIONS
- -help
- Prints the list of recognized options.
- -verbose
- Displays a progress bar.
- -page=pagespec
- Specify the document pages to be converted. The page
specification pagespec contains one or more comma-separated
page ranges. A page range is either a page number, or two page
numbers separated by a dash. Specification 1-10, for
instance, prints pages 1 to 10. Specification 1,3,99999-4
prints pages 1 and 3, followed by all the document pages in reverse
order up to page 4.
- -format=ps
- Produce a PostScript file. This is the default.
- -format=eps
- Produce an Encapsulated PostScript file. Encapsulated
PostScript files are suitable for embedding images into other
documents. Encapsulated PostScript file can only contain a single
page. Setting this option overrides the options -copies,
-orientation, -zoom, -cropmarks, and
-booklet.
- -copies=n
- Specify the number of copies to print.
- -orientation=orient
- Specify whether pages should be printed using the auto,
portrait, or landscape orientation.
- -mode=modespec
- Specify how pages should be decoded. The default mode,
color, renders all the layers of the DjVu documents. Mode
black only renders the foreground layer mask. This mode does
not work with DjVuPhoto images because these files have no
foreground layer mask. Modes foreground and
background only render the foreground layer or the
background layer of a DjVuDocument image.
- -zoom=zoomspec
- Specify a zoom factor zoomspec. The default zoom factor,
auto, scales the image to fit the page. Argument
zoomspec also can be a number in range 25 to
2400 representing a magnification percentage relative to the
original size of the document.
- -frame=yesno
- Specifying yes causes the generation of a thin gray
border representing the boundaries of the document pages. The
default is no.
- -cropmarks=yesno
- Specifying yes causes the generation of crop marks
indicating where pages should be cut. The default is no.
- -level=languagelevel
- Select the language level of the generated PostScript.
languagelevel. Valid language levels are 1, 2,
and 3. Level 3 produces the most compact and fast
printing PostScript files. Some of these files however require a
very modern printer. Level 2 is the default value. The
generated PostScript files are almost as compact and work with all
but the oldest PostScript printers. Level 1 can be used as a
last resort option.
- -color=yesno
- The default value, yes, generates a color PostScript
file. Specifying value no converts the image to gray scale.
The resulting PostScript file is smaller and marginally more
portable.
- -gray
- This option is equivalent to option -color=no and is
provided for convenience.
- -colormatch=yesno
- The default value, yes, generates a PostScript file
using device independent colors in compliance with the sRGB specification. Modern printers then produce colors
that match the original as well as possible. Specifying value
no generates a PostScript file using device dependent
colors. This is sometimes useful with older printers. You can then
use option -gamma to tune the output colors.
- -gamma=gammaspec
- Specify a gamma correction factor for the device dependent
PostScript colors. Argument gammaspec must be in range
0.3 to 5.0. Gamma correction normally pertains to
cathodic screens only. It gets meaningful for printers because
several models interpret device dependent RGB colors by emulating
the color response of a cathodic tube.
- -booklet=opt
- Turns the booklet printing mode on. The booklet mode prints two
pages on each side in a way suitable for making a booklet by
folding the sheets. Option opt can take values no for
disabling the booklet mode, yes for enabling the recto/verso
booklet mode, and recto or verso to print only one
side of each sheet.
- -bookletmax=max
- Specifies the maximal number of pages per booklet. A single
printout might then be composed of several booklets. Argument
max is rounded up to the next multiple of 4. Specifying
0 sets no maximal number of pages and ensures that the
printout will produce a single booklet. This is the default.
- -bookletalign=align
- Specifies a positive or negative offset applied to the verso of
each sheet. Argument align is expressed in points (one point
is 1/72th of an inch, or 0.352 millimeter) This is useful with
certain printers to ensure that both recto and verso are properly
aligned. The default value is of course 0.
- -bookletfold=base[+incr]
- Specifies the extra margin left between both pages on a single
sheet. The base value base is expressed in points (one point
is 1/72th of an inch, or 0.352 millimeter). This margin is
incremented for each outer sheet by value incr expressed in
millipoints. The default value is 18+200.
CREDITS
This program was written by L'eon Bottou
<leonb@users.sourceforge.net>,
Andrei Erofeev <andrew_erofeev@yahoo.com>,
and Florin Nicsa.
SEE ALSO
djvu(1),
ddjvu(1).
djview(1)