<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Author" content="Praveen Guduru">
<title>DjVu Plug-In Help: Tour</title>
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body text="#000000" bgcolor="#ffffff" link="#0000ff" vlink="#800000" alink="#000088">
<!-- WARNING!
This file uses HTML CSS feature. Do NOT edit it in any HTML composer
that doesn't understand CSS! Things will very likely break if you
do it. Netscape HTML editor v.4.7 and below does NOT understand CSS.
Moreover, it will remove some important <p> tags and will add useless
<br> on place of them.
-->
<a name="top"></a>
<div class=hdtable>
<table BORDER=0 width="100%">
<tr>
<td class=h2back><h2 style="LINE-HEIGHT: 2.50ex"><a NAME="tour"></a> A tour of the DjVu plug-in</h2>
</td>
</tr>
</table>
</div>
<div class=center>
<table BORDER=0 CELLSPACING=10>
<tr>
<td><IMG alt="DjVu Tour" class=right hspace=25 src="tour.gif" ></td>
<td>
<nobr>
<A href="#scrolling">Scrolling</A><br>
<A href="#toolbar">Popup toolbar</A><br>
<A href="#modes">Display modes</A><br>
<A href="#zoom">Zoom</A><br>
<A href="#navigation">Navigation</A><br>
<div style="MARGIN-BOTTOM: 0.5ex; MARGIN-LEFT: 3ex; MARGIN-TOP: 0.5ex">
<A href="#nav_keyboard" style="FONT-SIZE: 11pt">Using keyboard shortcuts</A><br>
<A href="#nav_toolbar" style="FONT-SIZE: 11pt">Using popup toolbar</A><br>
<A href="#nav_menu" style="FONT-SIZE: 11pt"> Using popup menu</A><br>
</div>
<A href="#saving">Saving</A><br>
<div style="MARGIN-BOTTOM: 0.5ex; MARGIN-LEFT: 3ex; MARGIN-TOP: 0.5ex">
<A href="#save_doc" style="FONT-SIZE: 11pt">Saving the whole document</A><br>
<A href="#save_page" style="FONT-SIZE: 11pt">Saving a single page</A>
</div>
<A href="#searching">Searching</A><br>
<A href="#clipboard">Copy to Clipboard</A><br>
<A href="#exporting">Exporting</A><br>
<A href="#printing">Printing</A><br>
<A href="#information">Information</A><br>
<div style="MARGIN-BOTTOM: 0.5ex; MARGIN-LEFT: 3ex; MARGIN-TOP: 0.5ex">
<A href="#page_info" style="FONT-SIZE: 11pt"><b>"Page information"</b> dialog</A><br>
<A href="#doc_info" style="FONT-SIZE: 11pt"><b>"Document information"</b> dialog</A><br>
</div>
<A href="#preferences">Preferences</A><br><br>
<A href="help.html">Go to help contents</A>
</nobr>
</td>
</tr>
</table>
</div>
<!--------------------------------------------------------------------------->
<h3><a NAME="scrolling"></a>Scrolling</h3>
<p>DjVu documents, when zoomed to sizes larger than the display window, can
be scrolled whenever you see the hand cursor (<img align=top src="hand.gif">) by clicking
on the document, moving the mouse, then unclicking. You can also scroll the
document using the scroll bars at the right and bottom of the document, or by using
Up, Down, Left, and Right <a href="refs.html#keyboard_shortcuts">keyboard shortcuts</a>.
<!--------------------------------------------------------------------------->
<h3><a NAME="toolbar"></a>Popup toolbar</h3>
<p>The popup toolbar is located at the bottom of the plug-in's
window for your convenience. It provides shortcuts to the most often executed
operations such as changing <A href="#modes">display modes</A>,
<A href="#zoom">zooming</A>, and <A href="#navigation">navigating</A>
through a multipage DjVu document.
<p>By default, the toolbar is enabled, and always visible.
To make the toolbar auto hide or disable, you can use the <A href="#preferences">Preferences</A>.
<p>The DjVu Toolbar gets disabled for embedded images if
the window size is too small to fit the Toolbar. The DjVu Toolbar appears as
follows:
<p class=image><IMG src="toolbar.gif" ></p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h3><a NAME="modes"></a>Display mode</h3>
<p>Most DjVu files contain images stored in more than
one <A href="refs.html#chunk_names">layer</A>. There may be several background layers,
a mask layer, and a foreground layer. By switching between different display
modes, one can see what is stored in each layer:</p>
<div class="table">
<table BORDER =1 CELLSPACING=0 CELLPADDING=6>
<tr>
<th>Display Mode</th>
<th>Description</th>
</tr>
<tr class="row1">
<td><b>Color</b> mode</td>
<td><p>All layers are visible</p></td>
</tr>
<tr class="row2">
<td><b>Background</b> mode</td>
<td><p>Only background layers, which typically store the images and paper color (<b>BG44</b>, <b>BGjp</b>) are visible</p></td>
</tr>
<tr class="row1">
<td><b>Foreground</b> mode</td>
<td><p>Only the foreground layer, which typically stores color of the text (<b>FG44</b>, <b>FGjp</b>) masked by mask
layer is visible</p></td>
</tr>
<tr class="row2">
<td><b>Black and White</b> mode</td>
<td><p>Only the mask layer, which typically stores text in black (<b>Sjbz</b>, <b>Smmr</b>) is visible</p></td>
</tr>
</table>
</div>
<p>In order to change the display mode, select the desired mode from the <b>Display</b>
item on toolbar.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h3><a NAME="zoom"></a>Zoom</h3>
<p>The zoom factor (magnification) can be any number
from 5% to 999% and it refers to the magnification of the physical dimensions
of the image. The plug-in tries to compute the actual scaling coefficients
taking into account the display and image DPI information. For example,
if you display a page at 100% then it should appear about the same size
on the screen as it was on paper, provided that:</p>
<ol>
<li>The document creator has supplied correct DPI
information to the DjVu encoder
<li>
The physical display resolution is correct.
Typically, the display resolution is assumed to be 100 DPI.</li>
</ol>
<p>Besides numerical zoom, four more zoom types are recognized:</p>
<div class="table">
<table BORDER=1 CELLSPACING=0 CELLPADDING=6>
<tr>
<th>Zoom</th>
<th>Description</th>
</tr>
<tr class="row1">
<td><b>Fit Width</b></td>
<td>
<p>Scales the image to fit the width of the window.</p>
<p>Note: The default behavior is to select one of the <i>fast</i> zoom factors.
Thus, the page will not fit the window's width precisely. Deselect "<b>Favor
fast magnifications for "Fit" resolutions</b>" in the <b><A href="#preferences">Preferences</A></b>
to disable this behavior.</p>
</td>
</tr>
<tr class="row2">
<td><b>Fit Page</b></td>
<td>
<p>Scales the image to fit the window.</p>
<p>Note: The default behavior is to select one of the <i>fast</i> zoom factors.
Thus, the page will not fit the window precisely. Deselect "<b>Favor fast
magnifications for "Fit" resolutions</b>" in the <b><A href="#preferences">Preferences</A></b>
to disable this behavior.</p>
</td>
</tr>
<tr class="row1">
<td><b>One-to-One</b></td>
<td><p>The image is scaled to be displayed in pixel-to-pixel mode when every
pixel of the original image corresponds to one pixel on the screen.
Note, that this is different from <b>100%</b> zoom when the image is
scaled so that its <b>physical</b>
dimensions on the screen are
about the same as the dimensions of the original.</p></td>
</tr>
<tr class="row2">
<td><b>Stretch</b></td>
<td><p>The image is stretched to fit the window precisely. The original proportions (aspect
ratio) are ignored.</p></td>
</tr>
</table>
</div>
<p>In order to change the zoom factor, you can select the <b>Zoom</b>
item from the popup menu.
If the toolbar at the bottom of the window is enabled, you can select it directly
there. Click inside the combo box, type the zoom factor you want
and hit <b>Enter</b>. This is the fastest known way to set any custom zoom
from 5% to 999%. You can select <b>One-to-One</b>, <b>Fit Width</b>, <b>Fit Page</b>
or <b>Stretch</b> zoom by clicking on the arrow on the right side of the
combo box.</p>
<p>There are also
<a href="refs.html#keyboard_shortcuts">keyboard shortcuts</a> available that directly set the zoom factor.
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h3><a NAME="navigation"></a>Navigation</h3>
<!--------------------------------------------------------------------------->
<p>If you view a multipage DjVu document you will need
a way to navigate through it, that is to go from page to page. There are
three ways to achieve it:
<ul>
<li><A href="#nav_keyboard">Keyboard shortcuts</A>
<li><A href="#nav_toolbar">Popup toolbar</A>
<li><A href="#nav_menu"> Popup menu</A>
<!---------------------------------------------------------------------------></li>
</ul>
<h4><a NAME="nav_keyboard"></a>Navigation using Keyboard Shortcuts</h4>
<p>This is the most useful when you look through the
document page by page. The following hot keys are enabled:</p>
<div class="table">
<table BORDER =1 CELLSPACING=0 CELLPADDING=6>
<tr>
<th>Key</th>
<th>Action</th>
</tr>
<tr class="row1">
<td><b>Page Down</b>, <b>Page Up</b></td>
<td><p>Go to the end/beginning of the page. If already there, switch to the
next/previous page if possible.</p></td>
</tr>
<tr class="row2">
<td><b>Space</b></td>
<td><p>Switch to the next page. Unlike the <b>Page Down</b> key, it will
not go to the bottom of the current page first. It will move to the next
page immediately.</p></td>
</tr>
<tr class="row1">
<td><b>Backspace</b></td>
<td><p>Switch to the previous page. (Same as <b>Space</b>, but goes in the opposite direction.)</p></td>
</tr>
<tr class="row2">
<td><b>Ctrl-Home</b></td>
<td><p>Move to the beginning of the document</p></td>
</tr>
<tr class="row1">
<td><b>Ctrl-End</b></td>
<td><p>Move to the end of the document</p></td>
</tr>
</table>
</div>
<p>The above table only contains the keyboard shortcuts for navigation.
Here is
<a href="refs.html#keyboard_shortcuts">a complete list of keyboard shortcuts</a>.
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h4><a NAME="nav_toolbar"></a>Navigation using the Popup Toolbar</h4>
<p>This is the second way to navigate through a multipage
DjVu document, where you can go to any specific page directly.
<p>Here you can use six buttons from the toolbar to go to
the previous page, next page, plus/minus 10 pages, to the beginning and to the
end of the document. In addition, you can select the page you want to see from
the combo box directly. These multipage navigation items will not be
visible on the toolbar if the plug-in is displaying a single page document.
<p>Please see the <b><A href="#toolbar">Popup Toolbar</A></b>
section for more details.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h4><a NAME="nav_menu"></a> Navigation using Popup Menu</h4>
<p>Using the popup menu, you
can choose an item to <b>Navigate.</b> The following choices are available:
<b>Next Page</b>, <b>Previous Page</b>, <b>+10 Pages</b>, <b>-10 Pages</b>,
<b>First Page</b>, <b>Last Page</b> and <b>Goto Page</b>. After selecting
the last item, you will get a <b>Goto Page</b> dialog where you will
be able to specify what page you want to go to.
<a NAME="goto_page">
</p></A>
<p class=right>
<A href="#top">Go to top</A>
</p>
<h3><a NAME="saving"></a>Saving</h3>
<p>The options available for saving a document are:
<ul>
<li><A href="#save_doc">Saving the whole document</A>
<li><A href="#save_page">Saving a single page</A></li>
</ul>
<p>The Save icon on the <a href="#toolbar">popup toolbar</a> saves the
whole document.</p>
<p class=right>
<!--------------------------------------------------------------------------->
</p>
<h4><a NAME="save_doc"></a>Saving the whole document</h4>
<p>This option is used to save the document you are viewing into either a
single or multiple files on your system.
<p>This capability is also extremely useful for you if you
already have several DjVu documents in one of the obsolete formats (See
<A href="new.html#new_multipage">
Multipage formats</A> section). Since the plug-in understands any of the
four formats (two obsolete and two current) and can save documents in any of
the current formats, it is a convenient tool to do the conversion.
<p>In order to save a multipage document, choose the menu
item <b>Save Document As</b>
from the popup menu. The document format selection dialog
will appear. Choose the <b>INDIRECT</b> format if you want every page to be
saved to a separate file (ideal for web browsing). Choose the <b>BUNDLED</b>
format if you want everything to go into a single file (a good format
for archiving or sending via e-mail).</p>
<p>In the next window, enter the document filename. For <b>BUNDLED</b> documents,
this will be the name of the bundle file. for <b>INDIRECT</b> documents,
this will be the name of the top-level file containing pointers to page
files (see <A href="new.html#new_multipage">Multipage formats</A> for details).
The page files will be created in the same directory as the top-level file.
Their names are built-in the document and will be displayed to you in the next
window.
<p class=right>
<A href="#top">Go to top</A>
</p>
<p class=right>
<!--------------------------------------------------------------------------->
</p>
<h4><a NAME="save_page"></a>Saving a single page</h4>
<p>Besides saving the whole document, you can also extract
and save just one (current) page. To do this, choose the menu item <b>Save Page
As</b>
from the popup menu.
<p class=right>
<A href="#top">Go to top</A>
</p>
<h3><a NAME="searching"></a>Searching</h3>
<p>The 3.0 release of DjVu supports a text chunk (<b>TXTz</b>)
that can be generated by an OCR (Optical Character Recognition) engine.
If you are browsing a document that has this chunk, you can search it for a
specific word or combination of words.
<p>
To search for a string, choose <b>Find</b> item
from the popup menu. The <b>Find dialog</b> should appear. Another way do display
this dialog is to press the <b>F</b>
.</p>
<p class=image><IMG alt=Search src="find.gif" ></p>
<p>A DjVu document may contain no textual information (simply because nobody
ran an OCR engine on it). Unfortunately the plug-in cannot detect this
situation in advance. To be certain that there are no <b>TXTz</b> chunks
in the <i>whole document</i>, it is necessary to load and decode <i>every
page</i>. Since we prefer not to decode everything without a good
reason, we made the <b>Search dialog</b> always available. Should the dialog
fail to find any <b>TXTz</b> chunk in the document during the search procedure,
it will let you know about it.
<p>Please note that DjVu relies on the OCR engine to generate correct
textual information and zones containing separate words and lines. If the
OCR engine failed when creating the textual chunk for this document, the
<b>Search</b> can generate abnormal results.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<h3><a NAME="clipboard"></a> Copy to Clipboard</h3>
<P>The <STRONG>Copy to Clipboard </STRONG>option in the DjVu popup menu is enabled only under Windows NT
operating system. This option enables you to copy the currently displayed DjVu
image in the Browser window to the Windows Clipboard. After the copy, you may
paste the image from the Windows Clipboard into any application that will accept
input from the Windows Clipboard, or you may view the copied image with the
Clipboard Viewer application. Note your display mode setting before you invoke
the copy operation, since only the currently displayed image layers are copied
to the clipboard.</p><p>Before copying the image from the DjVu to the Windows
Clipboard, a copy of the current image is converted to the 24-bit color BMP
format. This conversion is very memory intensive and may take a long time to
complete on systems with a modest amount of RAM memory (i.e. those with less
than 128 MB), and a modest amount of virtual memory (less than 512 MB on disk).
If the copy action does not complete due to insufficient memory, try closing
some other applications to free up RAM memory, or try increasing virtual memory,
and issue the Copy Image to Clipboard action again. The currently displayed
image is not modified by the Copy Image to Clipboard action. Any graphics
associated with any hyperlinks embedded in the image are copied, but the
hyperlink function is not copied to the Windows Clipboard.</P>
<p class=right>
<A href="#top">Go to top</A>
</p>
<H3><a NAME="exporting"></a> Exporting to a File</H3>
<p>The <STRONG>Export to File </STRONG> option in the
DjVu popup menu enables you to save DjVu Image in a different format on local disk.
The default image format of your operating system is used to export DjVu image.
For Windows, the BMP format
is supported and for MAC OS, the PICT format is supported.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<h3><a NAME="printing"></a>Printing</h3>
<p>
Selecting the Print option from the DjVu
popup Menu displays a Print dialog box with the following options:</p>
<h4>
Printer Options</h4>
<p>These options enable the selection of a printer from a
list of known printers. Printing to a file is also possible by selecting a
checkbox. A Properties submenu allows further specification of the paper size, print orientation, page layout,
printing resolution, image scaling, mirror-image and negative printing, and double-sided printing.</p>
<h4>
Print Range Options</h4>
<p><STRONG>All Pages </STRONG>
- Prints
all pages of a single or a multi-page DjVu document.</p>
<p><STRONG>Pages </STRONG>
- Enables printing
of a specified range of pages from a multi-page document.</p>
<p><STRONG>Reduce to Fit </STRONG>- This checkbox enables
the DjVu plug-In to set
the optimum resolution so that the image fits completely onto the printed page. The default
resolution is displayed in the Properties submenu of this dialog box.</p>
<h4>
Copies</h4>
<p>
Sets the number of copies of each page to be printed. The default
number of copies to print for each page is one.</p>
<h4>
The Effects of the Display Mode setting on Printing</h4>
<p><STRONG>Black & White </STRONG>
- Prints the foreground layer in black and white, sending the information to the
printer using the highest resolution available in memory, ensuring maximum readability.</p>
<p><STRONG>Color </STRONG>
- The resolution and the quality of color printing
is controlled by the various settings in the Preferences dialog box.</p>
<p>NOTE: The DjVu plug-In does NOT use the Print command
that is found on the
main browser menu bar to print DjVu images. Instead, in order to print a loaded
image DjVu, select the Print option from the DjVu popup Menu, or click on the print icon on
the <a href="#toolbar">DjVu popup toolbar</a>.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h3><a NAME="information"></a>Displaying various Document Information</h3>
<p>These popup menu items allow you to get more information about the document you are currently
browsing:
<ul>
<li><A href="#page_info"><b>"Page information"</b> dialog</A>
<li><A href="#doc_info"><b>"Document information"</b> dialog</A></li>
</ul>
<h4><a NAME="page_info"></a>The "Page information" dialog</h4>
<p>This dialog contains information about the currently displayed page,
including image dimensions, compression ratio, and a list of chunks (or layers)
that the image is composed of. Refer to the <b><A href="refs.html#chunk_names">Chunk
names</A></b> section for a brief description of supported chunks. Choose
item <b>Page information</b> from the popup menu in order to display this
dialog.</p>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<h4><a NAME="doc_info"></a>The "Document information" dialog</h4>
<table BORDER=0 CELLSPACING=15>
<tr>
<td align=image><IMG alt="Document information" src="docinfo.gif" ></td>
<td>
<p>The information in this dialog contains the name of
the document, format of the document, total size of the document, number
of pages in the document, number of files (only for DjVu 3.0 and newer documents),
and list of all pages with names and
sizes.
<p>The user can double click on any page in the page
list to directly go to that page.</p>
</td>
</tr>
</table>
<p class=right>
<A href="#top">Go to top</A>
</p>
<!--------------------------------------------------------------------------->
<!--------------------------------------------------------------------------->
<!--------------------------------------------------------------------------->
<!--------------------------------------------------------------------------->
<P> </P>
<!--------------------------------------------------------------------------->
<!--------------------------------------------------------------------------->
<h3><a name="preferences">Preferences</a></h3>
<p> When you run the plug-in for the first
time you may want to customize some of the settings. To do this, choose
the menu item <b>Preferences</b>
from the popup menu. This window will appear:</p>
<p class=image><IMG src="preferences.gif" ></p>
<div class="table">
<table BORDER =1 CELLSPACING=0 CELLPADDING=6>
<tr>
<th>Control</th>
<th>Description</th>
</tr>
<tr class="row1">
<td><b>Display Preferences</b></td>
<td>
<p>Here you can adjust the gamma correction for your monitor. Drag the slider
until all four squares look approximately the same.</p>
</td>
</tr>
<tr class="row2">
<td><b>Favor fast magnifications for "Fit" resolutions</b></td>
<td>
<p>This setting tells the plug-in how to scale image in "<b>Fit Width</b>"
and "<b>Fit Page</b>" resolutions. The internal rendering code is the fastest at
magnifications represented by integer numbers. On fast machines you won't
notice the difference, but on slower machines you may want to check this
checkbox in order to gain some speed. When it is checked (default) the
plug-in will find the closest integer magnification and display the image
so that it still fits (width or page), but not necessarily precisely. If
this is checked, the plug-in selects optimal resolutions while you
<STRONG>ZoomIn </STRONG>or <STRONG>ZoomOut.</STRONG>
</p>
</td>
</tr>
<tr class="row1">
<td><b>Hyperlink Preferences:
<ul>
<li>
Draw using simple border
<li>
"Show all hyperlinks" key</li>
</ul></b>
</td>
<td>
<p>On slow machines displaying hyperlinks may take some precious resources
and slow things down. To prevent this from happening you can check the
"<b>Draw using simple border</b>". Once it is checked, all hyperlinks will
be drawn using the XOR method directly into the window. This will be fast but
not pretty.
<p>In addition, sometimes you may want to see all hyperlinks on a given page.
To do this, you can press a magic key (press and keep it pressed for some
time), which is customizable in the <b>"Show all hyperlinks" keys</b> combo
box. The default key is <b>SHIFT</b>.</p>
</td>
</tr>
<tr class="row2">
<td><b>Cache preferences</b></td>
<td>
<p>The DjVu plug-in uses cache to store decoded pages
in memory. This preference setting allows you to set the size of the
cache.
<p> Please note that a page can be <i>decoded</i>,
but not <i>rendered</i>. "Decoding" is just the first stage of
page preparation. After a page has been decoded, it is still stored in a
somewhat compressed state in memory until it is rendered for displaying on
the screen.</p>
<p>The <b>Decoded pages cache</b> is automatically turned off for
files
with not <b>.djvu</b> or <b>.djv</b> extension.
Web developers can turn this cache on or off using either
<a href="refs.html#embed_flags"><b>EMBED</b> flags</a> or
<a href="refs.html#cgi_args"><b>CGI</b> arguments</a>.</p>
</td>
</tr>
<tr class="row1">
<td><b>Toolbar preferences</b></td>
<td>
<p>
You can customize the popup toolbar
displayed at the bottom of the DjVu plug-in's window. You can either disable it completely,
or make it hide when mouse is not near it.</p>
<p>Note that the toolbar is never displayed in small EMBED windows if more than half of it
would not be visible.</p>
</td>
</tr>
<tr class="row2">
<td><b> Save Preferences</b></td>
<td>
<p>Unless checked, all changes in the preferences will affect only the
currently loaded instance of the plug-in. If you want to save changes to
disk, make sure that this check box is checked.</p>
</td>
</tr>
</table>
</div>
<p class=right>
<A href="#top">Go to top</A>
</p>
<p class=right>
<A href="help.html">Go to help contents</a>
</p>
</body>
</html>