1DJVUDIGITAL(1) DjVuLibre-3.5 DJVUDIGITAL(1)
2
6 djvudigital - creates DjVu files from PS or PDF files.
7
10 djvudigital [options] inputfile [outputfile]
11
14 This program creates a DjVu file from the PostScript (.ps), GZipped
15 PostScript (.ps.gz), Encapsulated PostScript (.eps), or Portable Docu‐
16 ment Format (.pdf) file inputfile.
17 The output file name is either given by argument outputfile or gener‐
19 ated by replacing the input file name suffixes by the DjVu suffix
20 (.djvu).
21
24 This program depends on a specific GhostScript driver. If your Ghost‐
25 Script program does not provide this driver, please check
26 http://djvu.sourceforge.net/gsdjvu.html.
27
30 --verbose, -v
31 Displays more informational messages while converting the file.
32 --quiet, -q
34 Do not display informational messages while converting the file.
35 --dpi=resolution
37 Specify the desired resolution to resolution dots per inch. The
38 default is 300 dpi.
39 --psrotate=angle
41 Rotate the PostScript file by angle degrees clockwise. Only the
42 values 0, 90, 180, and 270 are supported. This option only
43 applies to PostScript files. PDF files are always converted
44 according to their native orientation.
45 --epsf=disposition
47 Specify how to handle Encapsulated PostScript files. Argument
48 disposition can take the values crop, fit, and ignore. The
49 default disposition crop creates a DjVu file whose size matches
50 the bounding box of the Encapsulated PostScript file. Value fit
51 rescales the graphics to the default page size. Value ignore
52 disables all Encapsulated PostScript specific code. This option
53 requires Ghostscript 7.07 or better.
54 --exact-color
56 Enables a more accurate rendering of the colors. This option
57 requires GhostScript 6.52 or better.
58 --threshold=thres
60 Specify a threshold for the foreground/background separation
61 code. Acceptable values of thres range from 0 to 100. Larger
62 values place more information into the foreground layer. The
63 default threshold value is 80.
64 --bg-subsample=sub
66 Specify the background subsampling ratio. Argument sub must be
67 an integer between 1 and 6. The default value is 3.
68 --bg-slices=n+...+n
70 Specify the encoding quality of the background layer. The syn‐
71 tax for the argument is similar to that described for the -slice
72 option of command c44. The default is 72+11+10+10.
73 --fg-colors=ncolors
75 Specify the maximum number of distinct colors in the foreground
76 layer. Argument ncolors can take integer values between 1 and
77 4000. The default value is 256.
78 --fg-image-colors=ncolors
80 Specify the maximum number of distinct colors in an image for
81 considering encoding it into the foreground layer. Argument
82 ncolors can take integer values between 1 and 4000. The default
83 value is 256.
84 --words
86 Extract the text from the PostScript code and incorporates this
87 information into the DjVu file. This option records the loca‐
88 tion of every word.
89 --lines
91 Extract the text from the PostScript code and incorporates this
92 information into the DjVu file. This option saves a few bytes
93 by only recording the location of each line.
94 --gsarg=arg1[,arg2,...,argN]
96 Insert extra arguments on the GhostScript command line.
97 --cseparg=arg1[,arg2,...,argN]
99 Insert extra arguments on the command line of program csepdjvu
100 or msepdjvu.
101 --help Display the manual page for djvudigital.
103 --check
105 Display the names of the auxiliary programs found by djvudigi‐
106 tal.
107
109 Program djvudigital internally relies on a specific Ghostscript driver
110 named djvusep. This driver analyzes the logical structure of the
111 sequence of PostScript rendering commands and decides to execute each
112 command into either the foreground or the background layer. The Ghost‐
113 Script driver produces a separated data file that is then compressed
114 using the DjVuLibre program csepdjvu.
115 Before processing the input file, program djvudigital searches a Ghost‐
117 script executable providing the djvusep driver. The search starts with
118 the file specified by the environment variable GSDJVU and continues
119 with command line executables named gs and gsdjvu.
120 The DjVuLibre source code contains instruction to compile such a Ghost‐
122 Script executable. More information can be obtained from
123 http://djvu.sourceforge.net/gsdjvu.html.
124
127 The output of the djvusep GhostScript driver must be processed by the
128 DjVuLibre program csepdjvu. This program can also be replaced by the
129 the proprietary Lizardtech program msepdjvu. Before processing the
130 input file, program djvudigital searches such an executable. The
131 search starts with the file specified by the environment variable
132 CSEPDJVU and continues with command line executables named msepdjvu and
133 csepdjvu.
134
137 The first version of this converter was written by Léon Bottou
138 <leonb@users.sourceforge.net> in AT&T Labs. The DjVuLibre version is
139 derived from code graciously released by Lizardtech in January 2004.
140
143 Program djvudigital can only process input files that GhostScript can
144 process properly.
145
148 djvu(1), csepdjvu(1), c44(1), gs(1), gzip(1)
149DjVuLibre-3.5 1/31/2004 DJVUDIGITAL(1)