DJVUPS
Section: ~DjVuLibre-3.5~ (1)
Updated: 01/18/2003
Index
Return to Main Contents
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éon Bottou <
leonb@users.sourceforge.net>,
Andrei Erofeev <
andrew_erofeev@yahoo.com>, and Florin Nicsa.
SEE ALSO
djvu(1),
ddjvu(1).
djview(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- CREDITS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 00:05:50 GMT, November 14, 2015