1DJVIEW3(1) DjVuLibre-3.5 DJVIEW3(1)
2
6 djview3 - Standalone DjVu viewer
7
10 djview3 [options] [djvufile]
11
14 Standalone viewer for DjVu files. Features include navigating docu‐
15 ments, zooming and panning page images, producing and displaying thumb‐
16 nails, searching documents for particular words in the hidden text
17 layer, copying hidden text to the clipboard, exporting page images as
18 PNM files, saving pages and documents as bundled or indirect multi-page
19 files, and printing page and documents to Postscript printers.
20
23 -help Display a brief help message.
24 -page=pagenum
26 Open page pagenum of the document.
27 -style=stylename
29 Specify the graphical user interface style. Recognized values
30 for stylename depend on the installed version of the Qt toolkit.
31 Common style names include windows, motif, motifplus, sgi, cde,
32 and platinum.
33 -fullscreen, -fs
35 Start djview3 in full screen mode. This only works if you also
36 provide a DjVu file name on the command line.
37 -geometry=geom
39 Specify the initial window size. The X11 geometry specification
40 geom often has the form wxh+x+y where w and h are the window
41 width and height, and x and y indicate the window position.
42 -display=disp
44 Specify that the djview3 windows should appear on the X11 dis‐
45 play disp.
46 -fn fontname
48 Specify the name of the default font used for buttons and menus.
49 -bg color
51 Specify the default background color.
52 -fg color
54 Specify the default foreground color.
55 -btn color
57 Specify the default button color.
58 -visual TrueColor
60 Force the use of a TrueColor visual on a 8 bit display.
61 -ncols count
63 Limit the number of colors allocated in the color cube on a 8
64 bit display. The default is 216.
65 -cmap Cause djview3 to install a private color map on an 8-bit dis‐
67 play.
68 -fix Checks the files $HOME/.mailcap and $HOME/.mime.types and
70 attempt to reconstruct sensible DjVu entries. This is sometimes
71 useful to make the DjVu plugin work.
72
75 The djvulibre browser plugin works by invoking a standalone DjVu viewer
76 with the special option -netscape. See the man page nsdejavu(1) for
77 more details.
78 When djview3 is invoked by the djvulibre browser plugin, a number of
80 options can be specified as CGI style arguments in document URL accord‐
81 ing to the following template:
82 http://server/dir/file.djvu?djvuopts&keyword=value&keyword=value&...
84 The DjVu browser plugin only recognizes keywords that appear after the
86 word djvuopts. Unrecognized keywords are silently ignored. The fol‐
87 lowing keywords are recognized:
88 passive=(yes|no)
90 Cause the image to be displayed in a manner similar to an ordi‐
91 nary web image. The default zoom factor is changed to "Fit
92 Page". The toolbar, the pop-up menu, the scroll bar, and the
93 keyboard shortcuts are disabled. The default is no.
94 scrollbars=(yes|no)
96 Enable or disable the presence of scroll bars when the full
97 image size exceeds the plugin window size. The default is yes.
98 menu=(yes|no)
100 Enable or disable the pop-up menu. The pop-up menu is enabled
101 by default.
102 keyboard=(yes|no)
104 Enable or disable the DjVu plugin keyboard shortcuts. The
105 default is yes (enabled).
106 frame=(yes|no)
108 Enable or disable the display of a thin gray frame around the
109 DjVu image. Keyboard shortcuts are enabled by default.
110 links=(yes|no)
112 Enable or disable hyper-links in the DjVu image. Hyper-links
113 are enabled by default.
114 logo=(yes|no)
116 Enable or disable the display of the DjVu log while the plug-in
117 is downloading data. This is enabled by default.
118 page=pagenum
120 Specify the initial page to be displayed. Page numbers are num‐
121 bered from 1.
122 zoom=zoomfactor
124 Specify the initial zoom factor. Unless the toolbar, pop-up
125 menu and keyboard are disabled, the user will be able to change
126 the zoom factor. Legal values for zoomfactor are shown in the
127 below:
128 ┌───────────────────────────────────────────────────────┐
130 │number Magnification factor in range 10% to 999%. │
131 │one2one Select the "one-to-one" mode. │
132 │width Select the "fit width" mode. │
133 │page Select the "fit page" mode. │
134 │stretch Stretch the image to the plugin window size. │
135 └───────────────────────────────────────────────────────┘
136 mode=modespec
137 Specify the initial display mode. Unless the toolbar and pop-up
138 menu are disabled, the user will be able to change it. Legal
139 values for modespec are shown in the below:
140 ┌──────────────────────────────────────────┐
142 │color Display the color image. │
143 │bw Display the foreground mask only. │
144 │fore Display the foreground only. │
145 │back Display the background only. │
146 └──────────────────────────────────────────┘
147 hor_align=keyword
148 Specify the horizontal position of the page in the viewer win‐
149 dow. (This does not specify what part of the page will be
150 shown, but rather how margins will be laid out around the page
151 in the plugin window.) Argument keyword must be left, center,
152 or right.
153 ver_align=keyword
155 Specify the vertical position of the page in the viewer window.
156 (This does not specify what part of the page will be shown, but
157 rather how margins will be laid out around the page in the plug‐
158 in window.) Argument keyword must be top, center, or bottom.
159 toolbar=keyword{(,|+|-)keyword}
161 Controls the appearance and the contents of the toolbar. The
162 argument of option toolbar is composed of a number of keywords
163 separated by characters comma, plus or minus. The appearance of
164 the toolbar is controlled by keywords placed before the first
165 occurrence of a character plus or minus. The following keywords
166 are recognized in this context:
167 ┌─────────────────────────────────────────────────────────┐
169 │no Disable toolbar. │
170 │always Disable toolbar "autohide" mode. │
171 │auto Enable toolbar "autohide" mode. │
172 │top Place toolbar along top edge (not implemented). │
173 │bottom Place toolbar along bottom edge. │
174 └─────────────────────────────────────────────────────────┘
175 The contents of the toolbar is controlled by keywords placed
176 after the first occurrence of a character plus or minus. Each
177 keyword adds (after a plus) or remove (after a minus) a particu‐
178 lar toolbar button or group of buttons. The initial content of
179 the toolbar is determined by the first occurrence of a character
180 plus or minus. When this is a plus the toolbar is initially
181 empty. When this is a minus the toolbar is initially full. The
182 following keywords are recognized:
183 ┌───────────────────────────────────────────────────────────────┐
185 │fore,back,color,bw for the display mode selection tool. │
186 │rescombo for the zoom selection tool. │
187 │zoom for the zoom buttons. │
188 │pan for the panning mode button. │
189 │zoomsel for the zooming mode button. │
190 │textsel for the text selection mode button. │
191 │rotate for the image rotation buttons. │
192 │search for the text search button. │
193 │save for the save button. │
194 │print for the print button. │
195 │pagecombo for the page selection tool. │
196 │firstlast for the first-page and last-page buttons. │
197 │prevnext for the previous- and next-page buttons. │
198 │backforw for the back and forward buttons. │
199 └───────────────────────────────────────────────────────────────┘
200 highlight=x,y,w,h[,color]
201 Display a highlighted rectangle at the specified coordinates and
202 with the specified color. Coordinates x, y, w, and h are mea‐
203 sured in document image coordinates (not screen coordinates).
204 The origin is set at the bottom left corner of the image. The
205 color color must be given in hexadecimal RRGGBB format. Omit‐
206 ting the color argument means to use XOR highlighting. Multiple
207 highlighted zone can be specified.
208 rotate=(0|90|180|270)
210 Rotate the djvu image by the specified angle expressed in
211 degrees counter-clockwise.
212 print=(yes|no)
214 Enable or disable printing the djvu image. Printing is enabled
215 by default.
216 cache=(yes|no)
218 Enable or disable the caching of fully decoded pages of the doc‐
219 ument. Caching is on by default. Caching of documents whose
220 URL does not contain extension .djvu or .djv is off by default.
221 The same options can be specified as parameters of EMBED or OBJECT tags
223 in a HTML file. See nsdejavu(1) for more details.
224
230 This program was written by Andrei Erofeev <andrew_erofeev@yahoo.com>
231 and was then improved by Bill Riemers <docbill@sourceforge.net> and
232 Léon Bottou <leonb@users.sourceforge.net>.
233
236 djvu(1), ddjvu(1), nsdejavu(1)
237DjVuLibre-3.5 10/11/2001 DJVIEW3(1)