Man Linux: Main Page and Category List

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 Leon Bottou <leonb@users.sourceforge.net>,
       Andrei Erofeev <andrew_erofeev@yahoo.com>, and Florin Nicsa.

SEE ALSO

       djvu(1), ddjvu(1).  djview(1)