1DJVIEW4(1) DjVuLibre DJVIEW4(1)
2
6 djview4 - Standalone DjVu viewer
7
10 djview4 [options] [argument]
11
14 Standalone viewer for DjVu files. Features include navigating docu‐
15 ments, zooming and panning page images, producing and displaying thumb‐
16 nails, displaying document outlines, searching documents for particular
17 words in the hidden text layer, copying hidden text to the clipboard,
18 saving pages and documents as bundled or indirect multi-page files, and
19 printing page and documents. The viewer can simultaneously display
20 several pages using a side-by-side or a continuous layout.
21
24 This program can run as a standalone program or as a slave process for
25 the DjVu browser plugin nsdejavu. When running as a standalone pro‐
26 gram, the command line argument argument can be:
27 * The filename of a valid DjVu document.
29 * A local DjVu document URL of the form:
31 file:///path/name.djvu[?djvuopts&keyword=value&...]
33 The square brackets delimit the optional components of the URL.
35 Various options can be specified using a syntax similar to that of
36 CGI arguments. Specifying options in this manner is very useful for
37 a browser plugin because there are no command line arguments. In
38 the case of a standalone viewer, all options can be specified as
39 command line arguments.
40 * An remote DjVu document URL of the form:
42 http://host/path/name.djvu[?djvuopts&keyword=value&...]
44 Browsing remote DjVu documents with the standalone viewer is less
46 efficient than using the browser plugin. The standalone viewer does
47 not benefit from the browser caching strategies and proxy settings.
48 Proxy settings for the standalone viewer can be set independently
49 with the preferences dialog.
50 An extensive list of options are recognized. Most options can be spec‐
52 ified as command line argument starting with the customary dash charac‐
53 ter (-) or using the syntax of CGI arguments in the document URL. Some
54 options however are only meaningful as command line arguments. Other
55 options are only recognized when running the X11 version of the djview4
56 program.
57
60 The following options are only meaningful when specified on the command
61 line.
62 -help Display a brief help message.
65 -verbose
68 Prints informational messages on the console. This option is
69 very useful because it displays messages about the unrecognized
70 constructs in the DjVu annotation and hyperlink layers.
71 -fullscreen, -fs
74 Start djview4 in full screen mode. Use the key F11 to exit the
75 full screen mode.
76 -style=stylename
79 Specify the graphical user interface style. The recognized val‐
80 ues for stylename depend on the installed version of the Qt
81 toolkit. Common style names include cde, motif, plastique,
82 platinum, and windows.
83
87 The following command line options are recognized by the X11 version of
88 the djview4 program. Unlike most djview4 options, X11 options that
89 demand an argument do not use the equal character to introduce their
90 argument.
91 -display displayname
93 Specify that the djview4 windows should appear on the X11 dis‐
94 play displayname.
95 -geometry WxH+X+Y
98 Specify the initial size and position of the first window using
99 the traditional X11 geometry specification syntax. The numeri‐
100 cal arguments W and H represent the initial window width and
101 height. The numerical arguments X and Y indicate the window
102 position relative to the top left corner of the screen.
103 -name name
106 Set the application name.
107 -title title
110 Set the title of the first window.
111 -fn fontname, -font fontname
114 Specify the name of the default font used for buttons and menus.
115 The font should be specified using a X logical font description
116 string.
117 -bg color, -background color
119 Specify the default background color for graphical user inter‐
120 face elements. The color should be given as a standard X11
121 color name.
122 -fg color, -foreground color
125 Specify the default foreground color for graphical user inter‐
126 face elements. The color should be given as a standard X11
127 color name.
128 -btn color
131 Specify the default button color. The color should be given as
132 a standard X11 color name.
133 -ncols count
136 Limit the number of colors allocated on a 8 bit display. The
137 default color cube contains 216 distinct colors.
138 -cmap Force the allocation of a private color map on a 8-bit display.
140 This might increase the color quality but cause flashing when
141 the viewer window gets activated.
142
145 The following options can be specified as command line options or can
146 be passed by augmenting the document URL using a syntax similar to that
147 of CGI arguments
148 http://.../file.djvu?djvuopts&key=value&key=value&...
150 In order to separate real CGI arguments from these options, the viewer
152 only recognizes keywords that appear after the word djvuopts. The key‐
153 words key are derived from the option names by removing the initial
154 dashes.
155 -page=pagename
158 Display a specific document page. The viewer first searches a
159 page whose identifier matches the argument pagename. Otherwise,
160 if pagename is a number preceded by character + or -, the viewer
161 performs a displacement relative to the current page. Other‐
162 wise, starting from the current page and wrapping around, it
163 searches for a page whose title matches the argument pagename.
164 Otherwise, if pagename is numerical, it is interpreted as an
165 ordinal page number. Otherwise, and finally, the viewer
166 searches a page whose name matches pagename.
167 -pageno=pagenumber
169 The page searching algorithm for option page can cause ambigui‐
170 ties when page titles can be interpreted as numbers. The argu‐
171 ment of option pageno is always interpreted as an ordinal page
172 number. This option is less portable than page because it is
173 not recognized by earlier versions of the djvu plugin. When
174 using this option is necessary, it is advisable to use both the
175 page and pageno options.
176 -zoom=zoomfactor
178 Specify the initial zoom factor. Unless the toolbar, pop-up
179 menu and keyboard are disabled, the user will be able to change
180 the zoom factor. Legal values for zoomfactor are shown in the
181 below:
182 ┌───────────────────────────────────────────────────────┐
184 │number Magnification factor in range 10% to 999%. │
185 │one2one Select the "one-to-one" mode. │
186 │width Select the "fit width" mode. │
187 │page Select the "fit page" mode. │
188 │stretch Stretch the image to the plugin window size. │
189 └───────────────────────────────────────────────────────┘
190 -showposition=px,py
191 Specify a point in the current page that should be as close as
192 possible to the center of the window. The horizontal and verti‐
193 cal positions px,py in the current page are given as fractions
194 in range 0 to 1. For instance, 0,0 designates the upper left
195 corner of the page, 0.5,0.5 is the center, and 1,1 is the lower
196 right corner.
197 -mode=modespec
200 Specify the initial display mode. Unless the toolbar and pop-up
201 menu are disabled, the user will be able to change it. Legal
202 values for modespec are shown in the below:
203 ┌──────────────────────────────────────────────────────┐
205 │color Display the color image. │
206 │bw Display the foreground mask only. │
207 │fore Display the foreground only. │
208 │back Display the background only. │
209 │text Overlay the hidden text over the color image. │
210 └──────────────────────────────────────────────────────┘
211 -hor_align=keyword, -halign=keyword
212 Specify the horizontal position of the page in the viewer win‐
213 dow. (This does not specify what part of the page will be
214 shown, but rather how margins will be laid out around the page
215 in the plugin window.) Argument keyword must be left, center,
216 or right.
217 -ver_align=keyword, -valign=keyword
220 Specify the vertical position of the page in the viewer window.
221 (This does not specify what part of the page will be shown, but
222 rather how margins will be laid out around the page in the plug‐
223 in window.) Argument keyword must be top, center, or bottom.
224 -cache=(yes|no)
227 Enable or disable the caching of fully decoded pages of the doc‐
228 ument. Caching is on by default. Caching of documents whose
229 URL does not contain an extension .djvu or .djv is off by
230 default.
231 -continuous=(yes|no)
234 Enable or disable the continuous layout of multipage documents.
235 -sidebyside=(yes|no), -side_by_side=(yes|no)
238 Enable or disable the side-by-side layout of multipage docu‐
239 ments.
240 -coverpage=(yes|no)
243 Specify whether the cover page must be displayed alone when mul‐
244 tipage documents are shown in side-by-side layout.
245 -righttoleft=(yes|no)
248 Specify whether pages should be arranged right-to-left when mul‐
249 tipage documents are shown in side-by-side layout.
250 -layout=keyword{,keyword}
253 Specify the layout settings using a single list of comma-sepa‐
254 rated keywords. The following keywords are recognized:
255 ┌──────────────────────────────────────────────────────────────────────┐
257 │single Disable both the side-by-side and continuous modes │
258 │double Enable the side-by-side mode. │
259 │continuous Enable the continuous mode. │
260 │cover, nocover Specify whether the cover page should be left alone. │
261 │ltor, rtol Specify the left-to-right or right-to-left layout. │
262 │gap, nogap Specify whether there is a gap between pages. │
263 └──────────────────────────────────────────────────────────────────────┘
264 -scrollbars=(yes|no)
266 Enable or disable the presence of scroll bars when the full
267 image size exceeds the plugin window size. The default is yes.
268 -frame=(yes|no)
271 Enable or disable the display of a thin frame and shadow around
272 the DjVu images. Frames are enabled by default.
273 -background=color
276 Specify the color of the background border displayed around the
277 document. The color color must be given in hexadecimal RRGGBB or
278 #RRGGBB format.
279 -toolbar=keyword{(,|+|-)keyword}
282 Controls the appearance and the contents of the toolbar. The
283 argument of option toolbar is composed of a number of keywords
284 separated by characters comma, plus or minus. The appearance of
285 the toolbar is controlled by keywords placed before the first
286 occurrence of a character plus or minus. The following keywords
287 are recognized in this context:
288 ┌───────────────────────────────────────────────────────────┐
290 │no Disable toolbar. │
291 │always Displays the toolbar. │
292 │auto Enable toolbar "autohide" mode (not implemented). │
293 │top Place toolbar along the top edge. │
294 │bottom Place toolbar along the bottom edge. │
295 └───────────────────────────────────────────────────────────┘
296 The contents of the toolbar is controlled by keywords placed
297 after the first occurrence of a character plus or minus. Each
298 keyword adds (after a plus) or removes (after a minus) a partic‐
299 ular toolbar button or group of buttons. The initial content of
300 the toolbar is determined by the first occurrence of a character
301 plus or minus. When this is a plus, the toolbar is initially
302 empty. When this is a minus, the toolbar initially contains the
303 default selection of buttons.
304 The following keywords are recognized:
306 ┌───────────────────────────────────────────────────────┐
308 │modecombo for the display mode selection tool. │
309 │zoomcombo for the zoom selection tool. │
310 │zoom for the zoom buttons. │
311 │select for the selection button. │
312 │rotate for the image rotation buttons. │
313 │find for the text search button. │
314 │new for the new window button. │
315 │open for the open new document button. │
316 │save for the save button. │
317 │print for the print button. │
318 │layout for the page layout buttons. │
319 │pagecombo for the page selection tool. │
320 │firstlast for the first-page and last-page buttons. │
321 │prevnext for the previous- and next-page buttons. │
322 │backforw reserved for the back and forward buttons. │
323 │help for the contextual help button. │
324 └───────────────────────────────────────────────────────┘
325 For the sake of backward compatibility, the keywords fore, fore_button,
326 back, back_button, bw, bw_button, color, and color_button are inter‐
327 preted like keyword modecombo; the keyword rescombo is a synonym of
328 zoomcombo; the keywords pan, zoomsel, and textsel are interpreted like
329 keyword select; and the keyword doublepage is interpreted like keyword
330 layout. All other keywords are ignored.
331 -menubar=(yes|no)
333 Enable or disable the presence of the menu bar located on top of
334 the window.
335 -statusbar=(yes|no)
338 Enable or disable the presence of the status bar located at the
339 bottom of the window.
340 -sidebar=keyword{,keyword}
343 Control the dockable panels. The argument is a comma separated
344 list of keywords. A first group of keywords selects which pan‐
345 els are affected. Omitting these keywords selects all panels.
346 A second group of keywords then controls the visibility and the
347 position of the selected panels.
348 ┌──────────────────────────────────────────────────────────────┐
350 │thumbnails specify the thumbnail panel. │
351 │outline,bookmarks specify the outline panel. │
352 │search,find specify the search panel. │
353 ├──────────────────────────────────────────────────────────────┤
354 │yes,true show the specified panels (default). │
355 │no,false hide the specified panels. │
356 │left dock specified panels on the left side. │
357 │right dock specified panels on the right side. │
358 │top dock specified panels on the top side. │
359 │bottom dock specified panels on the bottom side. │
360 └──────────────────────────────────────────────────────────────┘
361 -thumbnails=keyword{,keyword}
362 Compatibility alias for -sidebar=thumbnails,keyword{,keyword}.
363 -outline=keyword{,keyword}
366 Compatibility alias for -sidebar=outline,keyword{,keyword}.
367 -menu=(yes|no)
370 Enable or disable the pop-up menu.
371 -keyboard=(yes|no)
374 Enable or disable the DjVu plugin keyboard shortcuts. The
375 default is yes (enabled).
376 -mouse=(yes|no)
379 Enable or disable mouse interaction for panning and selecting.
380 The default is yes (enabled).
381 -links=(yes|no)
384 Enable or disable hyper-links in the DjVu image. Hyper-links
385 are enabled by default.
386 -highlight=x,y,w,h[,color]
389 Display a highlighted rectangle at the specified coordinates in
390 the current page and with the specified color. Coordinates x,
391 y, w, and h are measured in document image coordinates (not
392 screen coordinates). The origin is set at the bottom left cor‐
393 ner of the image. The color color must be given in hexadecimal
394 RRGGBB or #RRGGBB format. Multiple highlighted zone can be
395 specified and can be interspersed with multiple -page=pagename
396 options.
397 -find=text
399 Highlight occurrences of the given string text. This option
400 works when the document contains a hidden text layer. It can be
401 used in conjunction with -sidebar=find to display the text
402 searching interface.
403 String text can be terminated by slash (/) followed by letters
405 specifying search options. The following letters are recognized
406 ┌────────────────────────────────────────────────────┐
408 │c Case-sensitive search. │
409 │C Case-insensitive search (default). │
410 │w Search hits start on word boundaries (default). │
411 │W Ignore word boundaries. │
412 │r Regular expression search. │
413 │R String search (default). │
414 └────────────────────────────────────────────────────┘
415 -rotate=(0|90|180|270)
416 Rotate the djvu image by the specified angle expressed in
417 degrees counter-clockwise.
418 -print=(yes|no)
421 Enable or disable printing the DjVu document. Printing is
422 enabled by default.
423 -save=(yes|no)
426 Enable or disable saving the DjVu document. Saving is enabled
427 by default.
428 -passive
431 Cause the DjVu image to be displayed in a manner similar to an
432 ordinary web image. The default zoom factor is changed to page.
433 The toolbar, the status bar, the scrollbars, the menus, and the
434 keyboard shortcuts are disabled.
435 -passivestretch
438 Cause the DjVu image to be displayed in a manner similar to an
439 ordinary web image. The default zoom factor is changed to
440 stretch. The toolbar, the status bar, the scrollbars, the
441 menus, and the keyboard shortcuts are disabled.
442 -nomenu, -notoolbar, -noscrollbars
445 These options were recognized by some versions of the DjVu view‐
446 ers and are honored for the sake of backward compatibility. A
447 warning message is printed when option -verbose is active.
448 -logo, -textsel, -search
451 These options were recognized by some versions of the DjVu view‐
452 ers but are currently not implemented by djview4. A warning
453 message is printed when option -verbose is active.
454
458 Most features can be accessed using the menus, the toolbar, the side
459 bar or the pop-up menu shown when the right mouse button is depressed
460 over a DjVu image. Detailled help can be accessed by clicking the con‐
461 textual help icon from the toolbar and then clicking on various section
462 of the djview user interface.
463 The following table lists some useful key combinations recognized when
465 the djvu document is active:
466 ┌────────────────────────────────────────────────────────────────────────┐
468 │Key Action │
469 ├────────────────────────────────────────────────────────────────────────┤
470 │SHIFT+F1 Activate the contextual help. │
471 │1,2, and 3 Change zoom to to 100%, 200% and 300%. │
472 │Up, Down, Left, Right Scroll the image in the given direction. │
473 │Home Display top left corner of the image. │
474 │End Display bottom right corner of the image. │
475 │Control+Home Go to the beginning of the multi-page document. │
476 │Control+End Go to the end of the multi-page document. │
477 │Space, Return Scroll down or go to next page. │
478 │Backspace Scroll up or go to previous page. │
479 │Page Down Go to the next page. │
480 │Page Up Go to the previous page. │
481 │+, - Zoom in and out. │
482 │[, ] Rotate image. │
483 │W Select the "Fit Width" zooming mode. │
484 │P Select the "Fit Page" zooming mode. │
485 │CTRL+F, F3 Search the hidden text layer. │
486 └────────────────────────────────────────────────────────────────────────┘
487 Handy effects can be achieved by holding modifier keys. Although these
488 keys are configurable from the preference dialog, the following table
489 lists the default assignments
490 ┌─────────────────────────────────────────────────────────────┐
492 │Key Action │
493 ├─────────────────────────────────────────────────────────────┤
494 │CTRL+SHIFT Hold these keys to show the magnification lens. │
495 │CTRL Hold this key to select an area with the mouse. │
496 │SHIFT Hold this key to display all hyperlinks. │
497 └─────────────────────────────────────────────────────────────┘
499 This program was written by Léon Bottou <leonb@users.sf.net> and is
500 distributed under the GNU General Public License. This program
501 includes code derived from program tiff2pdf, written by Ross Finlayson
502 and released under a BSD license.
503
507 djvu(1), ddjvu(1), nsdejavu(1), djview3(1), tiff2pdf(1)
508DjVuLibre 10/11/2001 DJVIEW4(1)