Provided by: djvulibre-bin_3.5.27.1-14ubuntu0.1_amd64 bug

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)