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

FreeBSD Manual Pages

  
 
  

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

NAME
       djvudigital - creates DjVu files	from PS	or PDF files.

SYNOPSIS
       djvudigital  [options] inputfile	[outputfile]

DESCRIPTION
       This  program  creates  a  DjVu file from the PostScript	(.ps), GZipped
       PostScript (.ps.gz), Encapsulated PostScript (.eps), or Portable	 Docu-
       ment Format (.pdf) file inputfile.

       The  output  file name is either	given by argument outputfile or	gener-
       ated by replacing the input file	 name  suffixes	 by  the  DjVu	suffix
       (.djvu).

PREREQUISITES
       This  program depends on	a specific GhostScript driver.	If your	Ghost-
       Script  program	does   not   provide   this   driver,	please	 check
       http://djvu.sourceforge.net/gsdjvu.html.

OPTIONS
       --verbose, -v
	      Displays more informational messages while converting the	file.

       --quiet,	-q
	      Do not display informational messages while converting the file.

       --dpi=resolution
	      Specify the desired resolution to	resolution dots	per inch.  The
	      default is 300 dpi.

       --psrotate=angle
	      Rotate the PostScript file by angle degrees clockwise.  Only the
	      values  0, 90, 180, and 270 are supported.  This option only ap-
	      plies to PostScript files.  PDF files are	always	converted  ac-
	      cording to their native orientation.

       --epsf=disposition
	      Specify  how  to handle Encapsulated PostScript files.  Argument
	      disposition can take the values crop, fit, and ignore.  The  de-
	      fault  disposition  crop	creates	a DjVu file whose size matches
	      the bounding box of the Encapsulated PostScript file. Value  fit
	      rescales	the  graphics  to the default page size.  Value	ignore
	      disables all Encapsulated	PostScript specific code.  This	option
	      requires Ghostscript 7.07	or better.

       --exact-color
	      Enables  a  more	accurate rendering of the colors.  This	option
	      requires GhostScript 6.52	or better.

       --threshold=thres
	      Specify a	threshold  for	the  foreground/background  separation
	      code.   Acceptable  values  of thres range from 0	to 100.	Larger
	      values place more	information into the  foreground  layer.   The
	      default threshold	value is 80.

       --bg-subsample=sub
	      Specify  the background subsampling ratio.  Argument sub must be
	      an integer between 1 and 6.  The default value is	3.

       --bg-slices=n+...+n
	      Specify the encoding quality of the background layer.  The  syn-
	      tax for the argument is similar to that described	for the	-slice
	      option of	command	c44.  The default is 72+11+10+10.

       --fg-colors=ncolors
	      Specify the maximum number of distinct colors in the  foreground
	      layer.   Argument	 ncolors can take integer values between 1 and
	      4000.  The default value is 256.

       --fg-image-colors=ncolors
	      Specify the maximum number of distinct colors in	an  image  for
	      considering  encoding  it	 into  the foreground layer.  Argument
	      ncolors can take integer values between 1	and 4000.  The default
	      value is 256.

       --words
	      Extract  the text	from the PostScript code and incorporates this
	      information into the DjVu	file.  This option records  the	 loca-
	      tion of every word.

       --lines
	      Extract  the text	from the PostScript code and incorporates this
	      information into the DjVu	file.  This option saves a  few	 bytes
	      by only recording	the location of	each line.

       --gsarg=arg1[,arg2,...,argN]
	      Insert extra arguments on	the GhostScript	command	line.

       --cseparg=arg1[,arg2,...,argN]
	      Insert  extra  arguments on the command line of program csepdjvu
	      or msepdjvu.

       --sepfile
	      Produces a separated data	file instead of	a DjVu	file.  Program
	      csepdjvu	can  then  convert the separated data file into	a DjVu
	      file.

       --check
	      Display the  names  of  the  two	auxiliary  programs  found  by
	      djvudigital,  namely  a  suitable	 ghostscript interpreter and a
	      suitable backend encoder.	 See the next two section for details.

       --dryrun
	      Simply  display  the  ghostscript	 command  line	generated   by
	      djvudigital without running it.  No output file is produced

       --help Display the manual page for djvudigital.

GHOSTSCRIPT ISSUES
       Program	djvudigital internally relies on a specific Ghostscript	driver
       named djvusep.  This driver analyzes the	logical	structure of  the  se-
       quence  of  PostScript  rendering  commands and decides to execute each
       command into either the foreground or the background layer.  The	Ghost-
       Script  driver  produces	 a separated data file that is then compressed
       using the DjVuLibre program csepdjvu.

       Before processing the input file, program djvudigital searches a	Ghost-
       script  executable providing the	djvusep	driver.	The search starts with
       the file	specified by the environment  variable	GSDJVU	and  continues
       with command line executables named gs and gsdjvu.

       The DjVuLibre source code contains instruction to compile such a	Ghost-
       Script	executable.    More   information   can	  be   obtained	  from
       http://djvu.sourceforge.net/gsdjvu.html.

CSEPDJVU ISSUES
       The  output  of the djvusep GhostScript driver must be processed	by the
       DjVuLibre program csepdjvu.  This program can also be replaced  by  the
       the proprietary Lizardtech program msepdjvu.  Before processing the in-
       put file, program djvudigital searches such an executable.  The	search
       starts with the file specified by the environment variable CSEPDJVU and
       continues with command line executables named msepdjvu and csepdjvu.

CREDITS
       The first  version  of  this  converter	was  written  by  Leon	Bottou
       <leonb@users.sourceforge.net>  in  AT&T Labs.  The DjVuLibre version is
       derived from code graciously released by	Lizardtech in January 2004.

BUGS
       Program djvudigital can only process input files	that  GhostScript  can
       process properly.

SEE ALSO
       djvu(1),	csepdjvu(1), c44(1), gs(1), gzip(1)

DjVuLibre-3.5			   1/31/2004			DJVUDIGITAL(1)

NAME | SYNOPSIS | DESCRIPTION | PREREQUISITES | OPTIONS | GHOSTSCRIPT ISSUES | CSEPDJVU ISSUES | CREDITS | BUGS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=djvudigital&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help