~adamreichold/qpdfview/trunk

1317 by Adam Reichold
move HTML help charset meta tag as Qt's heuristic will not look far enough beyond the license preamble
1
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
2
370 by Adam Reichold
added online help
3
<!--
4
5
Copyright 2012 Benjamin Eltzner
6
Copyright 2012 Adam Reichold
7
8
This file is part of qpdfview.
9
10
qpdfview is free software: you can redistribute it and/or modify
11
it under the terms of the GNU General Public License as published by
12
the Free Software Foundation, either version 2 of the License, or
13
(at your option) any later version.
14
15
qpdfview is distributed in the hope that it will be useful,
16
but WITHOUT ANY WARRANTY; without even the implied warranty of
17
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18
GNU General Public License for more details.
19
20
You should have received a copy of the GNU General Public License
21
along with qpdfview.  If not, see <http://www.gnu.org/licenses/>.
22
403 by Adam Reichold
improved online help
23
This file is additionally licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC-BY-SA) license. The full text of the license can be found at https://creativecommons.org/licenses/by-sa/3.0/legalcode
24
370 by Adam Reichold
added online help
25
-->
26
27
<html>
28
29
<head>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
30
    <title>Help</title>
370 by Adam Reichold
added online help
31
</head>
32
33
<body>
34
35
<h2><a name="top">Help</a></h2>
36
37
<h4>Table of contents</h4>
38
<ol>
39
    <li><a href="#mainmenu">Main menu</a></li>
40
    <ol>
41
        <li><a href="#file">File</a></li>
42
        <li><a href="#edit">Edit</a></li>
43
        <li><a href="#view">View</a></li>
44
        <li><a href="#tabs">Tabs</a></li>
45
        <li><a href="#bookmarks">Bookmarks</a></li>
46
        <li><a href="#help">Help</a></li>
47
    </ol>
48
    <li><a href="#mainview">Main view</a></li>
49
    <li><a href="#auxiliaryviews">Auxiliary views</a></li>
50
    <li><a href="#settings">Settings</a></li>
714 by Adam Reichold
review of the MainWindow class
51
    <ol>
52
    	<li><a href="#behaviorsettings">Behavior settings</a></li>
53
    	<li><a href="#graphicssettings">Graphics settings</a></li>
54
    	<li><a href="#interfacesettings">Interface settings</a></li>
1020 by Adam Reichold
prepare online help for explaination of shortcut editor
55
    	<li><a href="#shortcutsettings">Shortcut settings</a></li>
56
    	<li><a href="#modifiersettings">Modifier settings</a></li>
714 by Adam Reichold
review of the MainWindow class
57
    </ol>
370 by Adam Reichold
added online help
58
</ol>
59
60
<h4>Introduction</h4>
61
974 by Adam Reichold
updated information about application capabilities in the documentation
62
<p><em>qpdfview</em> is a tabbed document viewer. It uses Poppler for PDF support, libspectre for PS support, DjVuLibre for DjVu support, CUPS for printing support and the Qt toolkit for its interface.</p>
370 by Adam Reichold
added online help
63
686 by Adam Reichold
fixed some British versus American English problems
64
<p>Please refer to the manual page for information on command-line options and configuration files.</p>
412 by Adam Reichold
imported Slovak translation
65
370 by Adam Reichold
added online help
66
<h3><a name="mainmenu">Main menu</a> <a href="#top">&uarr;</a></h3>
67
68
<h4><a name="file">File</a> <a href="#top">&uarr;</a></h4>
69
70
<ul>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
71
    <li><b>Open...</b> Opens a dialog to choose a file to open in the current tab. If there is no tab, the file is opened in a new tab.</li>
72
    <li><b>Open in new tab...</b> Opens a dialog to choose files to open in new tabs.</li>
73
    <li><b>Recently used</b> Contains a list of the most recently used files (if enabled in the settings).</li>
74
    <li><b>Refresh</b> Reloads the file displayed in the current tab.</li>
75
    <li><b>Save</b> Saves changes to annotations and form fields to the file displayed in the current tab.</li>
76
    <li><b>Save as...</b> Opens a dialog to save the file displayed in the current tab including changes to annotations and form fields.</li>
77
    <li><b>Save copy...</b> Opens a dialog to save an umodified copy of the file displayed in the current tab.</li>
686 by Adam Reichold
fixed some British versus American English problems
78
    <li><b>Print...</b> Opens a dialog to print the file displayed in the current tab.</li>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
79
    <li><b>Exit</b> Closes all tabs and ends the program.</li>
370 by Adam Reichold
added online help
80
</ul>
81
82
<h4><a name="edit">Edit</a> <a href="#top">&uarr;</a></h4>
83
84
<ul>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
85
    <li><b>Next/Previous/First/Last page</b> Skips to the next/previous/first/last page of the document.</li>
1683 by Adam Reichold
Add new menu entry to online help.
86
    <li><b>Jump to page...</b> Opens a dialog to enter a page to display in the current tab.</li>
87
    <li><b>Jump backward/forward</b> Jumps backward/forward in the history of displayed page.</li>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
88
    <li><b>Search...</b> Opens the search dock below the main view. The search automatically starts two seconds after the last change of the search term or is manually started by pressing the return key. If the Shift modifier is held when the return key is pressed, the search starts in all tabs instead of just the current tab. (This effect is reversed if the extended search dock is enabled in the settings.)</li>
89
    <li><b>Find previous/next</b> Jumps to the previous/next occurrence of the search term in the document.</li>
90
    <li><b>Cancel search</b> Cancels the currently running search and closes the search dock.</li>
91
    <li><b>Copy to clipboard</b> If checked, the program will wait for a frame to be dragged to copy texts or images.</li>
92
    <li><b>Add annotation</b> If checked, the program will wait for a frame to be dragged to add annotations.</li>
93
    <li><b>Settings...</b> Opens the settings dialog. The button labeled 'Defaults' will revert all settings on all tabs to their default values. The button labeled 'Defaults on current tab' will revert only the settings on the current tab to their default values.</li>
370 by Adam Reichold
added online help
94
</ul>
95
1313.1.2 by Adam Reichold
update help to describe shortcuts
96
<p>The <em>current page</em> can be changed by entering the desired page into the text field in the edit tool bar, which can be focused using Ctrl+K, and pressing the return key.</p>
370 by Adam Reichold
added online help
97
98
<h4><a name="view">View</a> <a href="#top">&uarr;</a></h4>
99
100
<ul>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
101
    <li><b>Continuous</b> Determines whether all rows of the page layout are visible at once.</li>
102
    <li><b>Two pages</b> Determines whether the page layout uses two columns.</li>
103
    <li><b>Two pages with cover page</b> Determines whether the page layout uses two columns with a break after the cover page.</li>
104
    <li><b>Multiple pages</b> Determines whether the page layout uses multiple columns. The number of columns can be changed in the settings dialog.</li>
1482 by Adam Reichold
Fix a typo and a missing menu entry in the help files.
105
    <li><b>Right to left</b> Determines how pages are arranged in layouts with multiple pages per row.</li>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
106
    <li><b>Zoom in</b> Increases the scale factor by 10 percent. The maximum scale factor is 5000 percent.</li>
107
    <li><b>Zoom out</b> Decreases the scale factor by 10 percent. The minimum scale factor is 10 percent.</li>
108
    <li><b>Original size</b> Resets the scale factor to 100 percent.</li>
958 by Adam Reichold
updated online help
109
    <li><b>Fit to page width</b> Determines the scale factor such that all pages fully fit into the main view horizontally.</li>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
110
    <li><b>Fit to page size</b> Determines the scale factor such that all pages fully fit into the main view horizontally and vertically.</li>
111
    <li><b>Rotate left</b> Rotates the pages left/counterclockwise by 90 degrees.</li>
112
    <li><b>Rotate right</b> Rotates the pages right/clockwise by 90 degrees.</li>
1683 by Adam Reichold
Add new menu entry to online help.
113
    <li><b>Invert colors</b> Determines whether pages are rendered with inverted colors.</li>
1767 by Adam Reichold
Update translations templates.
114
    <li><b>Convert to grayscale</b> Determines whether pages are converted to grayscale after rendering.</li>
1914 by Adam Reichold
Merge the composition mode and related render parameter handling changes.
115
    <li><b>Trim margins</b> Enables the removal of empty page margins after rendering.</li>
1917 by Adam Reichold
Fix naming of composition-mode menu and update translation template.
116
    <li><b>Composition</b> Enables the composition of the rendered page with the paper color to adjust the background of scanned documents.</li>
2013 by Adam Reichold
Extend the options to save a document with making save and save-as the defaults while the old save copy option becomes an alternative that has no keyboard shortcut bound by default to come closer to the usual defaults of editors instead of Poppler-based viewers.
117
    <li><b>Tool bars</b> This menu contains a list of available tool bars for accessing frequently used actions.</li>
118
    <li><b>Docks</b> This menu contains a list of available docks for displaying supplementary information.</li>
119
    <li><b>Fonts...</b> Opens a dialog listing the fonts used in the document.</li>
120
    <li><b>Fullscreen</b> Toggles the fullscreen mode, i.e. the window is shown maximized and without decoration.</li>
121
    <li><b>Presentation...</b> Enters presentation mode which can be left by pressing F12 or escape. The home/end key is used to display the first/last page. Arrow keys right and down, space and the page down key jump to the next page. Arrow keys left and up, backspace and the page up key jump to the previous page. Pressing control and return jumps back to the page before the last jump.</li>
370 by Adam Reichold
added online help
122
</ul>
123
1313.1.2 by Adam Reichold
update help to describe shortcuts
124
<p>The <em>scale factor</em> can be changed by entering the desired percentage into the text field in the view tool bar, which can be focused using Ctrl+L, and pressing the return key.</p>
370 by Adam Reichold
added online help
125
126
<h4><a name="tabs">Tabs</a> <a href="#top">&uarr;</a></h4>
127
128
<ul>
405 by Adam Reichold
more online help work
129
    <li><b>Previous/Next tab</b> Makes the previous/next tab the current tab. Cycles to the last/first tab if the first/last tab is the current tab.</li>
130
    <li><b>Close tab</b> Closes the current tab.</li>
131
    <li><b>Close all tabs</b> Closes all tabs.</li>
407 by Adam Reichold
added forgotten close all tabs but current tab action
132
    <li><b>Close all tabs but current tab</b> Closes all tabs except for the current tab.</li>
1432 by Adam Reichold
Update online help w.r.t latest functions.
133
    <li><b>Recently closed</b> Contains a list of the most recently closed tabs (if enabled in the settings).</li>
370 by Adam Reichold
added online help
134
</ul>
135
967 by Adam Reichold
add shortcuts to access the first nine tabs
136
<p>This menu contains a list of all tabs which can be made the current tab by clicking on the corresponding menu item. Tabs can also be closed by middle-clicking. The first nine tabs can also be activated by holding the Alt modifier and pressing keys one to nine.</p>
370 by Adam Reichold
added online help
137
138
<h4><a name="bookmarks">Bookmarks</a> <a href="#top">&uarr;</a></h4>
139
140
<ul>
498 by Adam Reichold
updated the online help
141
    <li><b>Previous bookmark</b> Jumps to the closest bookmark before the current page.</li>
142
    <li><b>Next bookmark</b> Jumps to the closest bookmark after the current page.</li>
466 by Adam Reichold
updated online help
143
    <li><b>Add bookmark</b> Adds a bookmark for the current file and page.</li>
492 by Adam Reichold
improved navigation using the bookmarks and allowed for bookmarking the first page for consistency
144
    <li><b>Remove bookmark</b> Removes the bookmark for the current file and page.</li>
466 by Adam Reichold
updated online help
145
    <li><b>Remove all bookmarks</b> Removes all bookmarks.</li>
146
    <li><b>Open</b> Opens the corresponding file in the current tab. If there is no tab, the file is opened in a new tab.</li>
147
    <li><b>Open in new tab</b> Opens the corresponding file in a new tab.</li>
958 by Adam Reichold
updated online help
148
    <li><b>Jump to page</b> Jumps to the corresponding page if the corresponding file is already open. Otherwise the corresponding file is opened in a new tab.</li>
370 by Adam Reichold
added online help
149
</ul>
150
151
<h4><a name="help">Help</a> <a href="#top">&uarr;</a></h4>
152
153
<ul>
445 by Adam Reichold
updated online help
154
	<li><b>Contents</b> Displays this document.</li>
155
	<li><b>About</b> Displays the program version.</li>
370 by Adam Reichold
added online help
156
</ul>
157
158
<h3><a name="mainview">Main view</a> <a href="#top">&uarr;</a></h3>
159
1068 by Adam Reichold
fix mistake in online help
160
<p>The backspace/space key skips to the previous/next page. The home/end key skips to the first/last page. The arrow, page up and page down keys scroll the viewport. Pressing control and return jumps to the page before the last jump.</p>
445 by Adam Reichold
updated online help
161
1497 by Adam Reichold
Implement a zoom-to-selection action using the middle mouse button.
162
<p>Using the mouse wheel scrolls up and down. Holding <b>ALT</b> while using the mouse wheel scrolls left and right. Holding <b>CTRL</b> while using the mouse wheel scales the document. Holding <b>SHIFT</b> while using the mouse wheel rotates the document. (Keyboard modifiers can be changed in the settings dialog.) Click and hold the middle mouse button to select a rectangle to zoom to.</p>
405 by Adam Reichold
more online help work
163
1496 by Adam Reichold
Update changelog and help file.
164
<p>Links are highlighted by red frames (if enabled in the settings). Left-click on a link to show the linked page or open the linked URL in the default browser (if enabled in the settings). Middle-click on a link to show the linked page in a new tab. Hovering over a link displays its destination as a tool tip.</p>
443 by Adam Reichold
improved online help
165
958 by Adam Reichold
updated online help
166
<p>Form fields are highlighted by blue frames (if enabled in the settings). Left-click on a form field to edit its contents. Hovering over a form field displays its name as a tool tip.</p>
665 by Adam Reichold
update online help
167
1953 by Adam Reichold
Update translation templates for changes in the SyncTeX handling.
168
<p>The source of a position in the document can be opened in the source editor using the context menu which optionally contains an item for the first matching <em>SyncTeX</em> node.</p>
593 by Adam Reichold
updated documentation regarding SyncTeX support
169
446 by Adam Reichold
use a better composition technique for the progress line edit
170
<p>To <em>copy texts or images</em>, hold <b>SHIFT</b>, click and hold the left mouse button to drag a frame around the area to copy. Once the mouse button is released, a pop-up menu is displayed to select whether to copy texts or images into the clipboard.</p>
443 by Adam Reichold
improved online help
171
1730 by Adam Reichold
Expose the new modifiers setting in the settings dialog and adjust the help file accordingly.
172
<p>To <em>add annotations</em>, hold <b>CTRL</b>, click and hold the left mouse button to drag a frame around the region to annotate. Once the mouse button is released, a pop-up menu is displayed to select whether to add text or highlight annotations. Left-click to <em>edit annotations</em>. Right-click to <em>remove annotations</em>. (Adding and removing annotations requires version 0.20.1 or higher of the Poppler library.) Hovering over an annotation displays its contents as a tool tip.</p>
173
174
<p>To <em>zoom to a selection</em>, hold <b>SHIFT</b> and <b>CTRL</b>, click and hold the left mouse button to drag a frame around region to zoom into.</p>
370 by Adam Reichold
added online help
175
1553 by Adam Reichold
Update online help w.r.t. to toggling tool and menu bar visibility.
176
<p>The <em>visibility of the tool and menu bars</em> can be toggled using configurable keyboard shortcuts whose default values are "Shift+Alt+T" and "Shift+Alt+M".</p>
177
370 by Adam Reichold
added online help
178
<h3><a name="auxiliaryviews">Auxiliary views</a> <a href="#top">&uarr;</a></h3>
179
1889 by Adam Reichold
Extend the online help w.r.t. keyboard navigation of the outline view.
180
<p>The <em>outline view</em> displays an overview of the contents of the document. A left click on an entry jumps to the respective page in the main view. The context menu can be used to expand/collapse all items below the selected item.</p>
181
182
<p>The outline view can also be navigated using the keyboard and the mouse wheel. Holding Shift and using the Up/Down keys will scroll the view. Holding Shift and using the Left/Right keys will collapse/expand one level of items below the selected item. Holding Control and using the Left/Right keys will completely collapse/expand the selected item and its children. Holding Shift and using the mousel wheel will change the selected item. Holding Control and using the mouse wheel will expand/collapse the selected item.</p>
183
184
<p>The <em>properties view</em> displays additional information contained in the document.</p>
185
186
<p>The <em>thumbnails view</em> displays smaller versions of the pages of the document. A left click on an entry jumps to the respective page in the main view.</p>
187
188
<p>The <em>bookmarks view</em> shows the bookmarks related to the document displayed in the current tab. The context menu contains entries to jump to the previous/next boookmark or to add bookmarks. The context menu of each entry also contains entries to edit and delete bookmarks.</p>
189
190
<p>If enabled in the settings, the <em>extended search dock</em> shows an overview containing the results of all searches being performed in all tabs. It also shows the text surrounding a result with the search term being emphasized. Clicking on a result opens the corresponding tab and jumps to its position.</p>
1796 by Adam Reichold
Extend the online help to agani cover all entries of the settings dialog and begin to document the two recently added docks.
191
370 by Adam Reichold
added online help
192
<h3><a name="settings">Settings</a> <a href="#top">&uarr;</a></h3>
193
714 by Adam Reichold
review of the MainWindow class
194
<h4><a name="behaviorsettings">Behavior settings</a> <a href="#top">&uarr;</a></h4>
502 by Adam Reichold
minor style issue in the online help
195
196
<ul>
197
    <li><b>Open URL</b> Determines whether links to URL are opened in the default browser.</li>
198
    <li><b>Auto-refresh</b> Determines whether files are automatically reloaded if changed on disk.</li>
1213 by Adam Reichold
Import Benjamin's updates to online help and manual page
199
    <li><b>Track recently used</b> If enabled, a recently used menu is available and lists as many recently used files as set in the "Recently used count" option. (Effective after restart.)</li>
1483 by Adam Reichold
Fix typo in default language help (but dot not update the template since we are in freeze).
200
    <li><b>Keep recently closed</b> If enabled, a recently closed menu is available and lists as many recently closed tabs as set in the "Recently closed count" option. Keeping the tabs available could increase memory usage considerably. (Effective after restart.)</li>
502 by Adam Reichold
minor style issue in the online help
201
    <li><b>Restore tabs</b> If enabled, tabs and their properties are saved on ending the program and restored on restart.</li>
202
    <li><b>Restore bookmarks</b> If enabled, bookmarks are saved on ending the program and restored on restart.</li>
718.1.1 by Adam Reichold
reimplement all persistent storage using SQLite adding a cleaner implementation of per-file settings
203
    <li><b>Restore per-file settings</b> If enabled, per-file settings are saved/restored on opening/closing tabs.</li>
1615 by Adam Reichold
Update documentation w.r.t to saveDatabaseInterval setting.
204
    <li><b>Save database interval</b> The interval after which tabs, bookmarks or per-file settings are saved to the database.</li>
958 by Adam Reichold
updated online help
205
    <li><b>Synchronize presentation</b> If enabled, the main view can be used to control the presentation view.</li>
1061 by Adam Reichold
add more TODOs to the online help
206
    <li><b>Presentation screen</b> The index of the screen to display the presentation view on.</li>
1581 by Adam Reichold
Make zoom factor into a proper setting accessible via the settings dialog.
207
    <li><b>Synchronize outline view</b> If enabled, the outline view will highlight the first entry pointing to the current page whenever the current page changes.</li>
2109 by Adam Reichold
Add relative-jumps setting to enable forcibly jump to the beginning of a page.
208
    <li><b>Relative jumps</b> If enable, the view port will keep its position relative to the visible page when jumping to another page.</li>
1907 by Adam Reichold
Fix a typo in the online help and import its updated translations.
209
    <li><b>Minimal scrolling</b> If enabled, the view port will only be scrolled if the target position is not yet visible.</li>
1581 by Adam Reichold
Make zoom factor into a proper setting accessible via the settings dialog.
210
    <li><b>Zoom factor</b> The number by which the scale factor is multiplied resp. divided upon zooming in resp. out.</li>
1270 by Adam Reichold
fix typo in online help
211
    <li><b>Highlight color</b> Determines the color of highlights.</li>
1135 by Adam Reichold
update online help
212
    <li><b>Highlight duration</b> Determines the duration of temporary highlights.</li>
1076 by Adam Reichold
update online help and revert dropping of ineffective jumps from history
213
    <li><b>Annotation color</b> The color of annotations added by the program using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
602 by Adam Reichold
grammer fixes (sorry for the need to retranslate)
214
    <li><b>Source editor</b> The program which is started to edit sources. '%1' is replaced by the absolute file path. '%2' resp. '%3' is replaced by line resp. column number.</li>
502 by Adam Reichold
minor style issue in the online help
215
</ul>
216
714 by Adam Reichold
review of the MainWindow class
217
<h4><a name="graphicssettings">Graphics settings</a> <a href="#top">&uarr;</a></h4>
502 by Adam Reichold
minor style issue in the online help
218
219
<ul>
1796 by Adam Reichold
Extend the online help to agani cover all entries of the settings dialog and begin to document the two recently added docks.
220
    <li><b>Use tiling</b> Pages will be divided into tiles before rendering and caching to reduce memory usage.</li>
1279 by Adam Reichold
fill out document placeholders in manual page and online help
221
    <li><b>Keep obsolete pixmaps</b> If enabled, then upon change of the zoom factor, cached pixmaps will be used to draw approximations of final pixmaps until these are available at the cost of increased memory usage.</li>
222
    <li><b>Use device pixel ratio</b> If enabled, the highest available device pixel ratio is used to render at physical and display at logical resolution.</li>
2111 by Adam Reichold
Add setting to ignore logical DPI as it is reported incorrectly in some multi monitor setups.
223
    <li><b>Use logical DPI</b> If enabled, the horizontal and vertical resolution of the monitor as reported by the operating system is used to define a scale factor of 100%.</li>
502 by Adam Reichold
minor style issue in the online help
224
    <li><b>Decorate pages</b> Determines whether pages are set apart from the background.</li>
225
    <li><b>Decorate links</b> Determines whether links are highlighted by red frames.</li>
665 by Adam Reichold
update online help
226
    <li><b>Decorate form fields</b> Determines whether form fields are highlighted by blue frames.</li>
751 by Adam Reichold
imported Bosnian translation
227
    <li><b>Background color</b> Determines the color of the background using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
739.1.5 by Adam Reichold
updated online help
228
    <li><b>Paper color</b> Determines the color of pages using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
1279 by Adam Reichold
fill out document placeholders in manual page and online help
229
    <li><b>Presentation background color</b> Overrides the paper color in the computation of the background color of the presentation view and is defined using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
628.1.6 by Adam Reichold
updated online help
230
    <li><b>Pages per row</b> Number of pages per row in the 'multiple pages' layout mode.</li>
502 by Adam Reichold
minor style issue in the online help
231
    <li><b>Page spacing</b> Determines both vertical and horizontal space displayed between pages.</li>
232
    <li><b>Thumbnail spacing</b> Determines both vertical and horizontal space displayed between thumbnails.</li>
233
    <li><b>Thumbnail size</b> Determines the size of the thumbnails.</li>
234
    <li><b>Cache size</b> The program will try to cache rendered pages within this limit increasing rendering speed at the cost of increased memory usage.</li>
235
    <li><b>Prefetch</b> The program will try to render pages that are not yet visible increasing rendering speed at the cost of increased cache usage.</li>
935 by Adam Reichold
updated translation templates and online help
236
    <li><b>Prefetch distance</b> The number of rows beyond the current row and twice the number of rows before the current row that are prefetched.</li>
1000 by Adam Reichold
updated change log and online help
237
    <li><b>PDF settings</b>
1099 by Adam Reichold
small improvements to the online help
238
    <ul>
239
        <li><b>Antialiasing</b> Improves display quality at the cost of performance</li>
240
        <li><b>Text antialiasing</b> Improves text display quality at the cost of performance</li>
241
        <li><b>Text hinting</b> May improve text display quality for certain fonts.</li>
1795 by Adam Reichold
Synchronize online help structure with current settings dialog.
242
        <li><b>Overprint preview</b> If enabled, a preview of printing one layer of ink on top of another is displayed.</li>
1440 by Adam Reichold
Updated translation templates.
243
        <li><b>Thin line mode</b> Chooses the optimization used to draw thin lines.</li>
244
        <li><b>Backend</b> Chooses the backend used to render pages.</li>
1099 by Adam Reichold
small improvements to the online help
245
    </ul>
246
    </li>
247
    <li><b>PS settings</b>
248
    <ul>
249
        <li><b>Graphics antialias bits</b> Determines the amount of antialiasing for graphics.</li>
250
        <li><b>Text antialias bits</b> Determines the amount of antialiasing for text.</li>
251
    </ul>
252
    </li>
370 by Adam Reichold
added online help
253
</ul>
254
714 by Adam Reichold
review of the MainWindow class
255
<h4><a name="interfacesettings">Interface settings</a> <a href="#top">&uarr;</a></h4>
630 by Adam Reichold
updated online help to correspond to settings dialog layout
256
257
<ul>
1798 by Adam Reichold
Fix another inconsistency in the online help.
258
    <li><b>Extended search dock</b> If enabled, the default search dock is extended by an overview showing the results of all tabs. (Effective after restart.)</li>
259
    <li><b>Annotation overlay</b> If enabled, all annotations on a page will be displayed as an interactive overlay. Otherwise each annotation will be handled as a separate pop-up window.</li>
260
    <li><b>Form field overlay</b> If enabled, all form fields on a page will be displayed as an interactive overlay. Otherwise each form field will be handled as a separate pop-up window.</li>
630 by Adam Reichold
updated online help to correspond to settings dialog layout
261
    <li><b>Tab position</b> Defines at which edge of the main view tabs will be displayed.</li>
262
    <li><b>Tab visibility</b> Determines whether tabs will be displayed if less than two documents are opened.</li>
1513 by Adam Reichold
Expose documentTitleAsTabTitle and spreadTabs settings in settings dialog.
263
    <li><b>Spread tabs</b> Determines if tabs will be spread out evenly over the whole tab bar.</li>
1076 by Adam Reichold
update online help and revert dropping of ineffective jumps from history
264
    <li><b>New tab next to current tab</b> If enabled, new tabs are opened to the right of the active tab.</li>
1756 by Adam Reichold
Small tweak to exit-after-last-tab help text.
265
    <li><b>Exit after last tab</b> If enabled, the application exits after the last tab is closed.</li>
1432 by Adam Reichold
Update online help w.r.t latest functions.
266
    <li><b>Recently used count</b> Sets the number of files that are listed in the recently used menu, if "Track recently used" is enabled. (Effective after restart.)</li>
267
    <li><b>Recently closed count</b> Sets the number of tabs that are listed in the recently closed menu, if "Keep recently closed" is enabled. (Effective after restart.)</li>
1046.1.55 by Adam Reichold
add possibility to add jump backward/forward to the edit tool bar and to generally add separators to the tool bars
268
    <li><b>File tool bar</b> Defines which actions are visible in the file tool bar. Available actions are openInNewTab, open, refresh, saveCopy, saveAs, print and separator. (Effective after restart.)</li>
269
    <li><b>Edit tool bar</b> Defines which actions are visible in the edit tool bar. Available actions are currentPage, previousPage, nextPage, firstPage, lastPage, jumpToPage, jumpBackward, jumpForward, search, copyToClipboardMode, addAnnotationMode and separator. (Effective after restart.)</li>
270
    <li><b>View tool bar</b> Defines which actions are visible in the view tool bar. Available actions are scaleFactor, zoomIn, zoomOut, continuousMode, twoPagesMode, twoPagesWithCoverPageMode, multiplePagesMode, originalSize, fitToPageWidthMode, fitToPageSizeMode, rotateLeft, rotateRight, fullscreen, presentation and separator. (Effective after restart.)</li>
2057 by Adam Reichold
Also extend the help information w.r.t. to the openCopyInNewWindow action.
271
    <li><b>Document context menu</b> Defines which actions are visible in the document's context menu. Available actions are openCopyInNewTab, openCopyInNewWindow, openContainingFolder, moveToInstance, previousPage, nextPage, firstPage, lastPage, jumpToPage, jumpBackward, jumpForward, setFirstPage, findPrevious, findNext, cancelSearch and separator.</li>
272
    <li><b>Tab context menu</b> Defines which actions are visible in a tab's context menu. Available actions are openCopyInNewTab, openCopyInNewWindow, openContainingFolder, moveToInstance, copyFilePath, selectFilePath, closeAllTabs, closeAllTabsButThisOne, closeAllTabsToTheLeft, closeAllTabsToTheRight and separator.</li>
1797 by Adam Reichold
Fix a typo in the online help.
273
    <li><b>Scrollable menus</b> Will override the default style so that pop-up menus scroll instead being laid-out in mutliple columns if they are larger than the available screen space. (Effective after restart.)</li>
1833 by Adam Reichold
Expose searchable menus via the settings dialog.
274
    <li><b>Searchable menus</b> Extends the default keyboard navigation of the tabs and bookmarks menus by a search-as-you-type mechanism.</li>
1795 by Adam Reichold
Synchronize online help structure with current settings dialog.
275
    <li><b>Toggle tool and menu bars with fullscreen</b> Always toggles the visibility of the tool and menu bars when toggling fullscreen mode.</li>
1656 by Adam Reichold
Expose the page label setting via the settings dialog.
276
    <li><b>Use page label</b> Determines if document-supplied page label will be used instead of page numbers when available.</li>
1513 by Adam Reichold
Expose documentTitleAsTabTitle and spreadTabs settings in settings dialog.
277
    <li><b>Document title as tab title</b> Determines if the tab title as derived from the meta-data instead of the file name.</li>
1135 by Adam Reichold
update online help
278
    <li><b>Current page in window title</b> If enabled, the current page and number of pages of the document in the active tab are displayed in the window title.</li>
1485 by Adam Reichold
Add another missing settings entry to the default online help.
279
    <li><b>Instance name in window title</b> If enabled and the current instance is named, its name is displayed in the window title.</li>
1144 by Adam Reichold
updated online help
280
    <li><b>Highlight current thumbnail</b> If enabled, the current page is highlighted in the thumbnails view.</li>
1076 by Adam Reichold
update online help and revert dropping of ineffective jumps from history
281
    <li><b>Limit thumbnails to results</b> If this option is enabled and a search is conducted, only the pages where the search term is found are displayed in the thumbnails view.</li>
630 by Adam Reichold
updated online help to correspond to settings dialog layout
282
</ul>
283
1020 by Adam Reichold
prepare online help for explaination of shortcut editor
284
<h4><a name="shortcutsettings">Shortcut settings</a> <a href="#top">&uarr;</a></h4>
285
1482 by Adam Reichold
Fix a typo and a missing menu entry in the help files.
286
<p>The shortcut settings allows the adjustment of keyboard shortcuts to personal preference. Shortcuts are changed by double-clicking on the shortcut to edit it and entering the new shortcut. Each action can have several shortcuts by entering a semicolon-separated list of them. Names of keys that are not single letters are written out explicitly (e.g. "Alt", "Ctrl", "PgDown"), where the matching is not case sensitive. If the shortcut contains modifier keys, the names of the keys are joined by a plus sign and modifier keys must be listed first, e.g. "Ctrl+A" or "Ctrl++".</p>
1020 by Adam Reichold
prepare online help for explaination of shortcut editor
287
288
<h4><a name="modifiersettings">Modifier settings</a> <a href="#top">&uarr;</a></h4>
630 by Adam Reichold
updated online help to correspond to settings dialog layout
289
290
<ul>
814 by Adam Reichold
move document view enumerations and print options to global header
291
    <li><b>Zoom</b> The keyboard modifiers to zoom using the mouse wheel in the main view.</li>
292
    <li><b>Rotate</b> The keyboard modifiers to rotate using the mouse wheel in the main view.</li>
293
    <li><b>Scroll</b> The keyboard modifiers to scroll horizontally using the mouse wheel in the main view.</li>
294
    <li><b>Copy to clipboard</b> The keyboard modifiers to copy texts or images from a page to the clipboard.</li>
295
    <li><b>Add annotation</b> The keyboard modifiers to add annotations to a page.</li>
1730 by Adam Reichold
Expose the new modifiers setting in the settings dialog and adjust the help file accordingly.
296
    <li><b>Zoom to selection</b> The keyboard modifiers to zoom to a slection on a page.</li>
630 by Adam Reichold
updated online help to correspond to settings dialog layout
297
</ul>
298
370 by Adam Reichold
added online help
299
</body>
300
301
</html>