1DJVUDIGITAL(1) DjVuLibre-3.5 DJVUDIGITAL(1)
2
3
4
6 djvudigital - creates DjVu files from PS or PDF files.
7
8
10 djvudigital [options] inputfile [outputfile]
11
12
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
18 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
22
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
28
30 --verbose, -v
31 Displays more informational messages while converting the file.
32
33 --quiet, -q
34 Do not display informational messages while converting the file.
35
36 --dpi=resolution
37 Specify the desired resolution to resolution dots per inch. The
38 default is 300 dpi.
39
40 --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
46 --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
55 --exact-color
56 Enables a more accurate rendering of the colors. This option
57 requires GhostScript 6.52 or better.
58
59 --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
65 --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
69 --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
74 --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
79 --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
85 --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
90 --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
95 --gsarg=arg1[,arg2,...,argN]
96 Insert extra arguments on the GhostScript command line.
97
98 --cseparg=arg1[,arg2,...,argN]
99 Insert extra arguments on the command line of program csepdjvu
100 or msepdjvu.
101
102 --sepfile
103 Produces a separated data file instead of a DjVu file. Program
104 csepdjvu can then convert the separated data file into a DjVu
105 file.
106
107 --check
108 Display the names of the two auxiliary programs found by
109 djvudigital, namely a suitable ghostscript interpreter and a
110 suitable backend encoder. See the next two section for details.
111
112 --dryrun
113 Simply display the ghostscript command line generated by
114 djvudigital without running it. No output file is produced
115
116 --help Display the manual page for djvudigital.
117
119 Program djvudigital internally relies on a specific Ghostscript driver
120 named djvusep. This driver analyzes the logical structure of the
121 sequence of PostScript rendering commands and decides to execute each
122 command into either the foreground or the background layer. The Ghost‐
123 Script driver produces a separated data file that is then compressed
124 using the DjVuLibre program csepdjvu.
125
126 Before processing the input file, program djvudigital searches a Ghost‐
127 script executable providing the djvusep driver. The search starts with
128 the file specified by the environment variable GSDJVU and continues
129 with command line executables named gs and gsdjvu.
130
131 The DjVuLibre source code contains instruction to compile such a Ghost‐
132 Script executable. More information can be obtained from
133 http://djvu.sourceforge.net/gsdjvu.html.
134
135
137 The output of the djvusep GhostScript driver must be processed by the
138 DjVuLibre program csepdjvu. This program can also be replaced by the
139 the proprietary Lizardtech program msepdjvu. Before processing the
140 input file, program djvudigital searches such an executable. The
141 search starts with the file specified by the environment variable
142 CSEPDJVU and continues with command line executables named msepdjvu and
143 csepdjvu.
144
145
147 The first version of this converter was written by Léon Bottou
148 <leonb@users.sourceforge.net> in AT&T Labs. The DjVuLibre version is
149 derived from code graciously released by Lizardtech in January 2004.
150
151
153 Program djvudigital can only process input files that GhostScript can
154 process properly.
155
156
158 djvu(1), csepdjvu(1), c44(1), gs(1), gzip(1)
159
160
161
162DjVuLibre-3.5 1/31/2004 DJVUDIGITAL(1)