Linux Certif

Toute la documentation sur la certification Linux LPI

djview4

NAME

djview4 - Standalone DjVu viewer

SYNOPSIS

djview4 [options] [argument]

DESCRIPTION

Standalone viewer for DjVu files. Features include navigating documents, zooming and panning page images, producing and displaying thumbnails, displaying document outlines, searching documents for particular words in the hidden text layer, copying hidden text to the clipboard, saving pages and documents as bundled or indirect multi-page files, and printing page and documents. The viewer can simultaneously display several pages using a side-by-side or a continuous layout.

COMMAND LINE ARGUMENT AND OPTIONS

This program can run as a standalone program or as a slave process for the DjVu browser plugin nsdejavu. When running as a standalone program, the command line argument argument can be:

*

The filename of a valid DjVu document.

*

A local DjVu document URL of the form:

file:///path/name.djvu[?djvuopts&keyword=value&...]

The square brackets delimit the optional components of the URL. Various options can be specified using a syntax similar to that of CGI arguments. Specifying options in this manner is very useful for a browser plugin because there are no command line arguments. In the case of a standalone viewer, all options can be specified as command line arguments.

*

An remote DjVu document URL of the form:

http://host/path/name.djvu[?djvuopts&keyword=value&...]

Browsing remote DjVu documents with the standalone viewer is less efficient than using the browser plugin. The standalone viewer does not benefit from the browser caching strategies and proxy settings. Proxy settings for the standalone viewer can be set independently with the preferences dialog.

An extensive list of options are recognized. Most options can be specified as command line argument starting with the customary dash character (-) or using the syntax of CGI arguments in the document URL. Some options however are only meaningful as command line arguments. Other options are only recognized when running the X11 version of the djview4 program.

COMMAND LINE OPTIONS

The following options are only meaningful when specified on the command line.

-help

Display a brief help message.

-verbose

Prints informational messages on the console. This option is very useful because it displays messages about the unrecognized constructs in the DjVu annotation and hyperlink layers.

-fullscreen, -fs

Start djview4 in full screen mode. Use the key F11 to exit the full screen mode.

-style=stylename

Specify the graphical user interface style. The recognized values for stylename depend on the installed version of the Qt toolkit. Common style names include cde, motif, plastique, platinum, and windows.

-netscape

This option should exclusively be used by the browser plugin nsdejavu to start the program djview4 as a slave process.

X11 OPTIONS

The following command line options are recognized by the X11 version of the djview4 program.

-display=displayname

Specify that the djview4 windows should appear on the X11 display displayname.

-geometry=WxH+X+Y

Specify the initial size and position of the first window using the traditional X11 geometry specification syntax. The numerical arguments W and H represent the initial window width and height. The numerical arguments X and Y indicate the window position relative to the top left corner of the screen.

-name name

Set the application name.

-title title

Set the title of the first window.

-fn fontname, -font fontname

Specify the name of the default font used for buttons and menus. The font should be specified using a X logical font description string.

-bg color, -background color

Specify the default background color for graphical user interface elements. The color should be given as a standard X11 color name.

-fg color, -foreground color

Specify the default foreground color for graphical user interface elements. The color should be given as a standard X11 color name.

-btn color

Specify the default button color. The color should be given as a standard X11 color name.

-ncols count

Limit the number of colors allocated on a 8 bit display. The default color cube contains 216 distinct colors.

-cmap

Force the allocation of a private color map on a 8-bit display. This might increase the color quality but cause flashing when the viewer window gets activated.

GENERAL OPTIONS

The following options can be specified as command line options or can be passed by augmenting the document URL using a syntax similar to that of CGI arguments

http://.../file.djvu?djvuopts&key=value&key=value&...

In order to separate real CGI arguments from these options, the viewer only recognizes keywords that appear after the word djvuopts. The keywords key are derived from the option names by removing the initial dashes.

-page=pagename

Display a specific document page. The viewer first searches a page whose title matches the argument pagename. Otherwise, it tries first to interpret the argument as a number indicating the position of the page, and then as a string matching the internal page identifiers.

This convention might cause ambiguities when page titles can be interpreted as numbers. To reduce these problems, a number preceded by a dollar sign ($) is always interpreted as the position of the desired page regardless of the existing page names.

-zoom=zoomfactor

Specify the initial zoom factor. Unless the toolbar, pop-up menu and keyboard are disabled, the user will be able to change the zoom factor. Legal values for zoomfactor are shown in the below:

number Magnification factor in range 10% to 999%. one2one Select the "one-to-one" mode. width Select the "fit width" mode. page Select the "fit page" mode. stretch Stretch the image to the plugin window size.

-mode=modespec

Specify the initial display mode. Unless the toolbar and pop-up menu are disabled, the user will be able to change it. Legal values for modespec are shown in the below:

color Display the color image. bw Display the foreground mask only. fore Display the foreground only. back Display the background only.

-hor_align=keyword, -halign=keyword

Specify the horizontal position of the page in the viewer window. (This does not specify what part of the page will be shown, but rather how margins will be laid out around the page in the plugin window.) Argument keyword must be left, center, or right.

-ver_align=keyword, -valign=keyword

Specify the vertical position of the page in the viewer window. (This does not specify what part of the page will be shown, but rather how margins will be laid out around the page in the plugin window.) Argument keyword must be top, center, or bottom.

-cache=(yes|no)

Enable or disable the caching of fully decoded pages of the document. Caching is on by default. Caching of documents whose URL does not contain an extension is off by default.

-continuous=(yes|no)

Enable or disable the continous layout of multipage documents.

-sidebyside=(yes|no), -side_by_side=(yes|no)

Enable or disable the side-by-side layout of multipage documents.

-scrollbars=(yes|no)

Enable or disable the presence of scroll bars when the full image size exceeds the plugin window size. The default is yes.

-frame=(yes|no)

Enable or disable the display of a thin frame and shadow around the DjVu images. Frames are enabled by default.

-toolbar=keyword{(,|+|-)keyword}

Controls the appearance and the contents of the toolbar. The argument of option toolbar is composed of a number of keywords separated by characters comma, plus or minus. The appearance of the toolbar is controlled by keywords placed before the first occurrence of a character plus or minus. The following keywords are recognized in this context:

no Disable toolbar. always Displays the toolbar. auto Enable toolbar "autohide" mode (not implemented). top Place toolbar along the top edge. bottom Place toolbar along the bottom edge.

The contents of the toolbar is controlled by keywords placed after the first occurrence of a character plus or minus. Each keyword adds (after a plus) or remove (after a minus) a particular toolbar button or group of buttons. The initial content of the toolbar is determined by the first occurrence of a character plus or minus. When this is a plus the toolbar is initially empty. When this is a minus the toolbar initially contains the default selection of buttons.
The following keywords are recognized:

modecombo for the display mode selection tool. zoomcombo for the zoom selection tool. zoom for the zoom buttons. select for the selection button. rotate for the image rotation buttons. find for the text search button. new for the new window button. open for the open new document button. save for the save button. print for the print button. layout for the page layout buttons. pagecombo for the page selection tool. firstlast for the first-page and last-page buttons. prevnext for the previous- and next-page buttons. backforw help

For the sake of backward compatibility, the keywords fore, fore_button, back, back_button, bw, bw_button, color, and color_button are interpreted like keyword modecombo; the keyword rescombo is a synonym of zoomcombo; the keywords pan, zoomsel, and textsel are interpreted like keyword select; and the keyword doublepage is interpreted like keyword layout. All other keywords are ignored.

-menubar=(yes|no)

Enable or disable the presence of the menu bar located on top of the window.

-statusbar=(yes|no)

Enable or disable the presence of the status bar located at the bottom of the window.

-sidebar=keyword{,keyword}

Enable or disable the side bar. The following keywords are recognized.

no,false hide the sidebar. yes,true show the sidebar. thumbnails sidebar displays the thumbnails. outline,bookmarks sidebar display the document outline. search,find sidebar display the search interface. left sidebar can dock on the left side. right sidebar can dock on the right side. top sidebar can dock on the top side. bottom sidebar can dock on the bottom side.

-thumbnails=keyword{,keyword}

Compatibility alias for -sidebar=thumbnails,keyword{,keyword}.

-outline=keyword{,keyword}

Compatibility alias for -sidebar=outline,keyword{,keyword}.

-menu=(yes|no)

Enable or disable the pop-up menu.

-keyboard=(yes|no)

Enable or disable the DjVu plugin keyboard shortcuts. The default is yes (enabled).

-links=(yes|no)

Enable or disable hyper-links in the DjVu image. Hyper-links are enabled by default.

-highlight=x,y,w,h[,color]

Display a highlighted rectangle at the specified coordinates and with the specified color. Coordinates x, y, w, and h are measured in document image coordinates (not screen coordinates). The origin is set at the bottom left corner of the image. The color color must be given in hexadecimal RRGGBB format. Multiple highlighted zone can be specified.

-find=text

Hightlights the occurences of string text. This option works when the document contains a hidden text layer. It can be used in conjunction with -sidebar=find to display the text searching interface.

-rotate=(0|90|180|270)

Rotate the djvu image by the specified angle expressed in degrees counter-clockwise.

-print=(yes|no)

Enable or disable printing the DjVu documment. Printing is enabled by default.

-save=(yes|no)

Enable or disable saving the DjVu document. Saving is enabled by default.

-passive

Cause the DjVu image to be displayed in a manner similar to an ordinary web image. The default zoom factor is changed to page. The toolbar, the status bar, the scrollbars, the menus, and the keyboard shortcuts are disabled.

-passivestretch

Cause the DjVu image to be displayed in a manner similar to an ordinary web image. The default zoom factor is changed to stretch. The toolbar, the status bar, the scrollbars, the menus, and the keyboard shortcuts are disabled.

-nomenu, -notoolbar, -noscrollbars

These options were recognized by some versions of the DjVu viewers and are honored for the sake of backward compatibility. A warning message is printed when option -verbose is active.

-logo, -textsel, -search

These options were recognized by some versions of the DjVu viewers but are currently not implemented by djview4. A warning message is printed when option -verbose is active.

CREDITS

This program was written by Léon Bottou <leonb@users.sf.net> and is distributed under the GNU General Public License.

This program includes code derived from program tiff2pdf, written by Ross Finlayson and released under a BSD license.

SEE ALSO

djvu(1), ddjvu(1), nsdejavu(1), djview3(1), tiff2pdf(1)