Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DJVUPS(1)			  DjVuLibre-3.5 		       DJVUPS(1)

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 argu-
     ment djvufile is not specified or when it is equal to a single dash.  Simi-
     larly, the output data is written to the standard output when argument out-
     putfile 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.  En-
	    capsulated 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,  ren-
	    ders  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  repre-
	    senting 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.   lan-
	    guagelevel.   Valid  language  levels are 1, 2, and 3.  Level 3 pro-
	    duces 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.	Specify-
	    ing  value no converts the image to gray scale.  The resulting Post-
	    Script 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 in-
	    dependent  colors in compliance with the sRGB specification.  Modern
	    printers then produce colors that match the original as well as pos-
	    sible.  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 Post-
	    Script 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  print-
	    out  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 de-
	    fault value is 18+200.

CREDITS
     This  program was written by Leon Bottou <leonb@users.sourceforge.net>, An-
     drei Erofeev <andrew_erofeev@yahoo.com>, and Florin Nicsa.

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

DjVuLibre-3.5			   01/18/2003			       DJVUPS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=djvups&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help