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 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 specifica-
	      tion  pagespec contains one or more comma-separated page ranges.
	      A	page range is either a page number, or two page	numbers	 sepa-
	      rated by a dash.	Specification 1-10, for	instance, prints pages
	      1	 to  10.  Specification	1,3,99999-4 prints pages 1 and 3, fol-
	      lowed 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	 Post-
	      Script  files are	suitable for embedding images into other docu-
	      ments.  Encapsulated PostScript file can only contain  a	single
	      page. Setting this option	overrides the options -copies, -orien-
	      tation, -zoom, -cropmarks, and -booklet.

       -copies=n
	      Specify the number of copies to print.

       -orientation=orient
	      Specify  whether	pages  should  be printed using	the auto, por-
	      trait, 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 fore-
	      ground 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 per-
	      centage relative to the original size of the document.

       -frame=yesno
	      Specifying yes causes the	generation of a	thin gray border  rep-
	      resenting	 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
	      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	 Post-
	      Script 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  re-
	      sulting 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 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
	      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 cer-
	      tain 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	incre-
	      mented  for  each	 outer sheet by	value incr expressed in	milli-
	      points. 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)

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+14.3.quarterly>

home | help