manpagez: man pages & more
man djvudigital(1)
Home | html | info | man
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
       GhostScript  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
              applies to PostScript files.  PDF  files  are  always  converted
              according to their native orientation.

       --epsf=disposition
              Specify  how  to handle Encapsulated PostScript files.  Argument
              disposition can take the values  crop,  fit,  and  ignore.   The
              default  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
       sequence of PostScript rendering commands and decides to  execute  each
       command  into  either  the  foreground  or  the  background layer.  The
       GhostScript driver produces a separated data file  that  is  then  com-
       pressed using the DjVuLibre program csepdjvu.

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

       The DjVuLibre source  code  contains  instruction  to  compile  such  a
       GhostScript   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
       input  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)

djvulibre 3.5.27 - Generated Sat Mar 14 18:01:35 CDT 2015
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.