1DJVIEW3(1)                       DjVuLibre-3.5                      DJVIEW3(1)
2
3
4

NAME

6       djview3 - Standalone DjVu viewer
7
8

SYNOPSIS

10       djview3 [options] [djvufile]
11
12

DESCRIPTION

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
21

OPTIONS

23       -help  Display a brief help message.
24
25       -page=pagenum
26              Open page pagenum of the document.
27
28       -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
34       -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
38       -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
43       -display=disp
44              Specify that the djview3 windows should appear on the  X11  dis‐
45              play disp.
46
47       -fn fontname
48              Specify the name of the default font used for buttons and menus.
49
50       -bg color
51              Specify the default background color.
52
53       -fg color
54              Specify the default foreground color.
55
56       -btn color
57              Specify the default button color.
58
59       -visual TrueColor
60              Force the use of a TrueColor visual on a 8 bit display.
61
62       -ncols  count
63              Limit  the  number  of colors allocated in the color cube on a 8
64              bit display. The default is 216.
65
66       -cmap  Cause djview3 to install a private color map on  an  8-bit  dis‐
67              play.
68
69       -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
73

USING DJVIEW3 AS A BROWSER PLUGIN

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
79       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
83          http://server/dir/file.djvu?djvuopts&keyword=value&keyword=value&...
84
85       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
89       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
95       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
99       menu=(yes|no)
100              Enable  or  disable the pop-up menu.  The pop-up menu is enabled
101              by default.
102
103       keyboard=(yes|no)
104              Enable or disable  the  DjVu  plugin  keyboard  shortcuts.   The
105              default is yes (enabled).
106
107       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
111       links=(yes|no)
112              Enable or disable hyper-links in the  DjVu  image.   Hyper-links
113              are enabled by default.
114
115       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
119       page=pagenum
120              Specify the initial page to be displayed.  Page numbers are num‐
121              bered from 1.
122
123       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
129                  ┌───────────────────────────────────────────────────────┐
130number    Magnification factor in range 10% to 999%.   │
131one2one   Select the "one-to-one" mode.                │
132width     Select the "fit width" mode.                 │
133page      Select the "fit page" mode.                  │
134stretch   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
141                        ┌──────────────────────────────────────────┐
142color   Display the color image.          │
143bw      Display the foreground mask only. │
144fore    Display the foreground only.      │
145back    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
154       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
160       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
168                 ┌─────────────────────────────────────────────────────────┐
169no       Disable toolbar.                                │
170always   Disable toolbar "autohide" mode.                │
171auto     Enable toolbar "autohide" mode.                 │
172top      Place toolbar along top edge (not implemented). │
173bottom   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
184              ┌───────────────────────────────────────────────────────────────┐
185fore,back,color,bw   for the display mode selection tool.      │
186rescombo             for the zoom selection tool.              │
187zoom                 for the zoom buttons.                     │
188pan                  for the panning mode button.              │
189zoomsel              for the zooming mode button.              │
190textsel              for the text selection mode button.       │
191rotate               for the image rotation buttons.           │
192search               for the text search button.               │
193save                 for the save button.                      │
194print                for the print button.                     │
195pagecombo            for the page selection tool.              │
196firstlast            for the first-page and last-page buttons. │
197prevnext             for the previous- and next-page buttons.  │
198backforw             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
209       rotate=(0|90|180|270)
210              Rotate  the  djvu  image  by  the  specified  angle expressed in
211              degrees counter-clockwise.
212
213       print=(yes|no)
214              Enable or disable printing the djvu image.  Printing is  enabled
215              by default.
216
217       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
222       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
225
226
227
228

CREDITS

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
234

SEE ALSO

236       djvu(1), ddjvu(1), nsdejavu(1)
237
238
239
240DjVuLibre-3.5                     10/11/2001                        DJVIEW3(1)
Impressum