~adamreichold/qpdfview/trunk

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

-->

<html>

<head>

<title>Помуч</title>

</head>

<body>

<h2><a name="top">Помуч</a></h2>

<h4>Оглавленя</h4>

<ol>

<li><a href="#mainmenu">Чоловоє меню</a></li>

<ol>

<li><a href="#edit">Переміна</a></li>

<li><a href="#tabs">Закладка</a></li>

<li><a href="#bookmarks">Марча</a></li>

<li><a href="#help">Помуч</a></li>

</ol>

<li><a href="#auxiliaryviews">Auxiliary views</a></li>

<li><a href="#settings">Settings</a></li>

<ol>

<li><a href="#behaviorsettings">Behavior settings</a></li>

<li><a href="#graphicssettings">Graphics settings</a></li>

<li><a href="#interfacesettings">Interface settings</a></li>

<li><a href="#shortcutsettings">Shortcut settings</a></li>

<li><a href="#modifiersettings">Modifier settings</a></li>

</ol>

<h4>Introduction</h4>

qpdfview 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.

Please refer to the manual page for information on command-line options and

configuration files.

<ul>

<li>Open... 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>

<li>Open in new tab... Opens a dialog to choose files to open in new

tabs.</li>

<li>Recently used Contains a list of the most recently used files (if

enabled in the settings).</li>

<li>Refresh Reloads the file displayed in the current tab.</li>

<li>Save Saves changes to annotations and form fields to the file

displayed in the current tab.</li>

<li>Save as... Opens a dialog to save the file displayed in the current

tab including changes to annotations and form fields.</li>

<li>Save copy... Opens a dialog to save an umodified copy of the file

displayed in the current tab.</li>

<li>Print... Opens a dialog to print the file displayed in the current

tab.</li>

<li>Exit Closes all tabs and ends the program.</li>

</ul>

<ul>

<li>Next/Previous/First/Last page Skips to the next/previous/first/last

page of the document.</li>

<li>Jump to page... Opens a dialog to enter a page to display in the

100

current tab.</li>

101

<li>Jump backward/forward Jumps backward/forward in the history of

102

displayed page.</li>

103

<li>Search... Opens the search dock below the main view. The search

104

automatically starts two seconds after the last change of the search term or

105

is manually started by pressing the return key. If the Shift modifier is

106

held when the return key is pressed, the search starts in all tabs instead

107

of just the current tab. (This effect is reversed if the extended search

108

dock is enabled in the settings.)</li>

109

<li>Find previous/next Jumps to the previous/next occurrence of the

110

search term in the document.</li>

111

<li>Cancel search Cancels the currently running search and closes the

112

search dock.</li>

113

<li>Copy to clipboard If checked, the program will wait for a frame to be

114

dragged to copy texts or images.</li>

115

<li>Add annotation If checked, the program will wait for a frame to be

116

dragged to add annotations.</li>

117

<li>Settings... Opens the settings dialog. The button labeled 'Defaults'

118

will revert all settings on all tabs to their default values. The button

119

labeled 'Defaults on current tab' will revert only the settings on the

120

current tab to their default values.</li>

121

</ul>

122

123

The current page can be changed by entering the desired page into

124

the text field in the edit tool bar, which can be focused using Ctrl+K, and

125

pressing the return key.

126

127

128

129

<ul>

130

<li>Continuous Determines whether all rows of the page layout are visible

131

at once.</li>

132

<li>Two pages Determines whether the page layout uses two columns.</li>

133

<li>Two pages with cover page Determines whether the page layout uses two

134

columns with a break after the cover page.</li>

135

<li>Multiple pages Determines whether the page layout uses multiple

136

columns. The number of columns can be changed in the settings dialog.</li>

137

<li>Right to left Determines how pages are arranged in layouts with

138

multiple pages per row.</li>

139

<li>Zoom in Increases the scale factor by 10 percent. The maximum scale

140

factor is 5000 percent.</li>

141

<li>Zoom out Decreases the scale factor by 10 percent. The minimum scale

142

factor is 10 percent.</li>

143

<li>Original size Resets the scale factor to 100 percent.</li>

144

<li>Fit to page width Determines the scale factor such that all pages

145

fully fit into the main view horizontally.</li>

146

<li>Fit to page size Determines the scale factor such that all pages

147

fully fit into the main view horizontally and vertically.</li>

148

<li>Rotate left Rotates the pages left/counterclockwise by 90 degrees.</li>

149

<li>Rotate right Rotates the pages right/clockwise by 90 degrees.</li>

150

<li>Invert colors Determines whether pages are rendered with inverted

151

colors.</li>

152

<li>Convert to grayscale Determines whether pages are converted to

153

grayscale after rendering.</li>

154

<li>Trim margins Enables the removal of empty page margins after

155

rendering.</li>

156

<li>Composition Enables the composition of the rendered page with the

157

paper color to adjust the background of scanned documents.</li>

158

<li>Tool bars This menu contains a list of available tool bars for

159

accessing frequently used actions.</li>

160

<li>Docks This menu contains a list of available docks for displaying

161

supplementary information.</li>

162

<li>Fonts... Opens a dialog listing the fonts used in the document.</li>

163

<li>Fullscreen Toggles the fullscreen mode, i.e. the window is shown

164

maximized and without decoration.</li>

165

<li>Presentation... Enters presentation mode which can be left by

166

pressing F12 or escape. The home/end key is used to display the first/last

167

page. Arrow keys right and down, space and the page down key jump to the

168

next page. Arrow keys left and up, backspace and the page up key jump to the

169

previous page. Pressing control and return jumps back to the page before the

170

last jump.</li>

171

</ul>

172

173

The scale factor can be changed by entering the desired percentage

174

into the text field in the view tool bar, which can be focused using Ctrl+L,

175

and pressing the return key.

176

177

178

179

<ul>

180

<li>Previous/Next tab Makes the previous/next tab the current tab. Cycles

181

to the last/first tab if the first/last tab is the current tab.</li>

182

<li>Close tab Closes the current tab.</li>

183

<li>Close all tabs Closes all tabs.</li>

184

<li>Close all tabs but current tab Closes all tabs except for the current

185

tab.</li>

186

<li>Recently closed Contains a list of the most recently closed tabs (if

187

enabled in the settings).</li>

188

</ul>

189

190

This menu contains a list of all tabs which can be made the current tab by

191

clicking on the corresponding menu item. Tabs can also be closed by

192

middle-clicking. The first nine tabs can also be activated by holding the

193

Alt modifier and pressing keys one to nine.

194

195

<h4><a name="bookmarks">Bookmarks</a> <a href="#top">↑</a></h4>

196

197

<ul>

198

<li>Previous bookmark Jumps to the closest bookmark before the current

199

page.</li>

200

<li>Next bookmark Jumps to the closest bookmark after the current page.</li>

201

<li>Add bookmark Adds a bookmark for the current file and page.</li>

202

<li>Remove bookmark Removes the bookmark for the current file and page.</li>

203

<li>Remove all bookmarks Removes all bookmarks.</li>

204

<li>Open Opens the corresponding file in the current tab. If there is no

205

tab, the file is opened in a new tab.</li>

206

<li>Open in new tab Opens the corresponding file in a new tab.</li>

207

<li>Jump to page Jumps to the corresponding page if the corresponding

208

file is already open. Otherwise the corresponding file is opened in a new

209

tab.</li>

210

</ul>

211

212

213

214

<ul>

215

<li>Contents Displays this document.</li>

216

<li>About Displays the program version.</li>

217

</ul>

218

219

220

221

The backspace/space key skips to the previous/next page. The home/end key

222

skips to the first/last page. The arrow, page up and page down keys scroll

223

the viewport. Pressing control and return jumps to the page before the last

224

jump.

225

226

Using the mouse wheel scrolls up and down. Holding ALT while using

227

the mouse wheel scrolls left and right. Holding CTRL while using the

228

mouse wheel scales the document. Holding SHIFT while using the mouse

229

wheel rotates the document. (Keyboard modifiers can be changed in the

230

settings dialog.) Click and hold the middle mouse button to select a

231

rectangle to zoom to.

232

233

Links are highlighted by red frames (if enabled in the settings). Left-click

234

on a link to show the linked page or open the linked URL in the default

235

browser (if enabled in the settings). Middle-click on a link to show the

236

linked page in a new tab. Hovering over a link displays its destination as a

237

tool tip.

238

239

Form fields are highlighted by blue frames (if enabled in the

240

settings). Left-click on a form field to edit its contents. Hovering over a

241

form field displays its name as a tool tip.

242

243

The source of a position in the document can be opened in the source editor

244

using the context menu which optionally contains an item for the first

245

matching SyncTeX node.

246

247

To copy texts or images, hold SHIFT, click and hold the left

248

mouse button to drag a frame around the area to copy. Once the mouse button

249

is released, a pop-up menu is displayed to select whether to copy texts or

250

images into the clipboard.

251

252

To add annotations, hold CTRL, click and hold the left mouse

253

button to drag a frame around the region to annotate. Once the mouse button

254

is released, a pop-up menu is displayed to select whether to add text or

255

highlight annotations. Left-click to edit annotations. Right-click

256

to remove annotations. (Adding and removing annotations requires

257

version 0.20.1 or higher of the Poppler library.) Hovering over an

258

annotation displays its contents as a tool tip.

259

260

To zoom to a selection, hold SHIFT and CTRL, click

261

and hold the left mouse button to drag a frame around region to zoom into.

262

263

The visibility of the tool and menu bars can be toggled using

264

configurable keyboard shortcuts whose default values are "Shift+Alt+T" and

265

"Shift+Alt+M".

266

267

<h3><a name="auxiliaryviews">Auxiliary views</a> <a href="#top">↑</a></h3>

268

269

The outline view displays an overview of the contents of the

270

document. A left click on an entry jumps to the respective page in the main

271

view. The context menu can be used to expand/collapse all items below the

272

selected item.

273

274

The outline view can also be navigated using the keyboard and the mouse

275

wheel. Holding Shift and using the Up/Down keys will scroll the

276

view. Holding Shift and using the Left/Right keys will collapse/expand one

277

level of items below the selected item. Holding Control and using the

278

Left/Right keys will completely collapse/expand the selected item and its

279

children. Holding Shift and using the mousel wheel will change the selected

280

item. Holding Control and using the mouse wheel will expand/collapse the

281

selected item.

282

283

The properties view displays additional information contained in

284

the document.

285

286

The thumbnails view displays smaller versions of the pages of the

287

document. A left click on an entry jumps to the respective page in the main

288

view.

289

290

The bookmarks view shows the bookmarks related to the document

291

displayed in the current tab. The context menu contains entries to jump to

292

the previous/next boookmark or to add bookmarks. The context menu of each

293

entry also contains entries to edit and delete bookmarks.

294

295

If enabled in the settings, the extended search dock shows an

296

overview containing the results of all searches being performed in all

297

tabs. It also shows the text surrounding a result with the search term being

298

emphasized. Clicking on a result opens the corresponding tab and jumps to

299

its position.

300

301

<h3><a name="settings">Settings</a> <a href="#top">↑</a></h3>

302

303

<h4><a name="behaviorsettings">Behavior settings</a> <a href="#top">↑</a></h4>

304

305

<ul>

306

<li>Open URL Determines whether links to URL are opened in the default

307

browser.</li>

308

<li>Auto-refresh Determines whether files are automatically reloaded if

309

changed on disk.</li>

310

<li>Track recently used If enabled, a recently used menu is available and

311

lists as many recently used files as set in the "Recently used count"

312

option. (Effective after restart.)</li>

313

<li>Keep recently closed If enabled, a recently closed menu is available

314

and lists as many recently closed tabs as set in the "Recently closed count"

315

option. Keeping the tabs available could increase memory usage

316

considerably. (Effective after restart.)</li>

317

<li>Restore tabs If enabled, tabs and their properties are saved on

318

ending the program and restored on restart.</li>

319

<li>Restore bookmarks If enabled, bookmarks are saved on ending the

320

program and restored on restart.</li>

321

<li>Restore per-file settings If enabled, per-file settings are

322

saved/restored on opening/closing tabs.</li>

323

<li>Save database interval The interval after which tabs, bookmarks or

324

per-file settings are saved to the database.</li>

325

<li>Synchronize presentation If enabled, the main view can be used to

326

control the presentation view.</li>

327

<li>Presentation screen The index of the screen to display the

328

presentation view on.</li>

329

<li>Synchronize outline view If enabled, the outline view will highlight

330

the first entry pointing to the current page whenever the current page

331

changes.</li>

332

<li>Relative jumps If enable, the view port will keep its position

333

relative to the visible page when jumping to another page.</li>

334

<li>Minimal scrolling If enabled, the view port will only be scrolled if

335

the target position is not yet visible.</li>

336

<li>Zoom factor The number by which the scale factor is multiplied

337

resp. divided upon zooming in resp. out.</li>

338

<li>Highlight color Determines the color of highlights.</li>

339

<li>Highlight duration Determines the duration of temporary highlights.</li>

340

<li>Annotation color The color of annotations added by the program using

341

SVG color keywords or hexadecimal notation '#rrggbb'.</li>

342

<li>Source editor The program which is started to edit sources. '%1' is

343

replaced by the absolute file path. '%2' resp. '%3' is replaced by line

344

resp. column number.</li>

345

</ul>

346

347

<h4><a name="graphicssettings">Graphics settings</a> <a href="#top">↑</a></h4>

348

349

<ul>

350

<li>Use tiling Pages will be divided into tiles before rendering and

351

caching to reduce memory usage.</li>

352

<li>Keep obsolete pixmaps If enabled, then upon change of the zoom

353

factor, cached pixmaps will be used to draw approximations of final pixmaps

354

until these are available at the cost of increased memory usage.</li>

355

<li>Use device pixel ratio If enabled, the highest available device pixel

356

ratio is used to render at physical and display at logical resolution.</li>

357

<li>Use logical DPI If enabled, the horizontal and vertical resolution of

358

the monitor as reported by the operating system is used to define a scale

359

factor of 100%.</li>

360

<li>Decorate pages Determines whether pages are set apart from the

361

background.</li>

362

<li>Decorate links Determines whether links are highlighted by red

363

frames.</li>

364

<li>Decorate form fields Determines whether form fields are highlighted

365

by blue frames.</li>

366

<li>Background color Determines the color of the background using SVG

367

color keywords or hexadecimal notation '#rrggbb'.</li>

368

<li>Paper color Determines the color of pages using SVG color keywords or

369

hexadecimal notation '#rrggbb'.</li>

370

<li>Presentation background color Overrides the paper color in the

371

computation of the background color of the presentation view and is defined

372

using SVG color keywords or hexadecimal notation '#rrggbb'.</li>

373

<li>Pages per row Number of pages per row in the 'multiple pages' layout

374

mode.</li>

375

<li>Page spacing Determines both vertical and horizontal space displayed

376

between pages.</li>

377

<li>Thumbnail spacing Determines both vertical and horizontal space

378

displayed between thumbnails.</li>

379

<li>Thumbnail size Determines the size of the thumbnails.</li>

380

<li>Cache size The program will try to cache rendered pages within this

381

limit increasing rendering speed at the cost of increased memory usage.</li>

382

<li>Prefetch The program will try to render pages that are not yet

383

visible increasing rendering speed at the cost of increased cache usage.</li>

384

<li>Prefetch distance The number of rows beyond the current row and twice

385

the number of rows before the current row that are prefetched.</li>

386

<li>PDF settings

387

<ul>

388

<li>Antialiasing Improves display quality at the cost of performance</li>

389

<li>Text antialiasing Improves text display quality at the cost of

390

performance</li>

391

<li>Text hinting May improve text display quality for certain fonts.</li>

392

<li>Overprint preview If enabled, a preview of printing one layer of ink

393

on top of another is displayed.</li>

394

<li>Thin line mode Chooses the optimization used to draw thin lines.</li>

395

<li>Backend Chooses the backend used to render pages.</li>

396

</ul>

397

</li>

398

<li>PS settings

399

<ul>

400

<li>Graphics antialias bits Determines the amount of antialiasing for

401

graphics.</li>

402

<li>Text antialias bits Determines the amount of antialiasing for text.</li>

403

</ul>

404

</li>

405

</ul>

406

407

<h4><a name="interfacesettings">Interface settings</a> <a href="#top">↑</a></h4>

408

409

<ul>

410

<li>Extended search dock If enabled, the default search dock is extended

411

by an overview showing the results of all tabs. (Effective after restart.)</li>

412

<li>Annotation overlay If enabled, all annotations on a page will be

413

displayed as an interactive overlay. Otherwise each annotation will be

414

handled as a separate pop-up window.</li>

415

<li>Form field overlay If enabled, all form fields on a page will be

416

displayed as an interactive overlay. Otherwise each form field will be

417

handled as a separate pop-up window.</li>

418

<li>Tab position Defines at which edge of the main view tabs will be

419

displayed.</li>

420

<li>Tab visibility Determines whether tabs will be displayed if less than

421

two documents are opened.</li>

422

<li>Spread tabs Determines if tabs will be spread out evenly over the

423

whole tab bar.</li>

424

<li>New tab next to current tab If enabled, new tabs are opened to the

425

right of the active tab.</li>

426

<li>Exit after last tab If enabled, the application exits after the last

427

tab is closed.</li>

428

<li>Recently used count Sets the number of files that are listed in the

429

recently used menu, if "Track recently used" is enabled. (Effective after

430

restart.)</li>

431

<li>Recently closed count Sets the number of tabs that are listed in the

432

recently closed menu, if "Keep recently closed" is enabled. (Effective after

433

restart.)</li>

434

<li>File tool bar Defines which actions are visible in the file tool

435

bar. Available actions are openInNewTab, open, refresh, saveCopy, saveAs,

436

print and separator. (Effective after restart.)</li>

437

<li>Edit tool bar Defines which actions are visible in the edit tool

438

bar. Available actions are currentPage, previousPage, nextPage, firstPage,

439

lastPage, jumpToPage, jumpBackward, jumpForward, search,

440

copyToClipboardMode, addAnnotationMode and separator. (Effective after

441

restart.)</li>

442

<li>View tool bar Defines which actions are visible in the view tool

443

bar. Available actions are scaleFactor, zoomIn, zoomOut, continuousMode,

444

twoPagesMode, twoPagesWithCoverPageMode, multiplePagesMode, originalSize,

445

fitToPageWidthMode, fitToPageSizeMode, rotateLeft, rotateRight, fullscreen,

446

presentation and separator. (Effective after restart.)</li>

447

<li>Document context menu Defines which actions are visible in the

448

document's context menu. Available actions are openCopyInNewTab,

449

openCopyInNewWindow, openContainingFolder, moveToInstance, previousPage,

450

nextPage, firstPage, lastPage, jumpToPage, jumpBackward, jumpForward,

451

setFirstPage, findPrevious, findNext, cancelSearch and separator.</li>

452

<li>Tab context menu Defines which actions are visible in a tab's context

453

menu. Available actions are openCopyInNewTab, openCopyInNewWindow,

454

openContainingFolder, moveToInstance, copyFilePath, selectFilePath,

455

closeAllTabs, closeAllTabsButThisOne, closeAllTabsToTheLeft,

456

closeAllTabsToTheRight and separator.</li>

457

<li>Scrollable menus Will override the default style so that pop-up menus

458

scroll instead being laid-out in mutliple columns if they are larger than

459

the available screen space. (Effective after restart.)</li>

460

<li>Searchable menus Extends the default keyboard navigation of the tabs

461

and bookmarks menus by a search-as-you-type mechanism.</li>

462

<li>Toggle tool and menu bars with fullscreen Always toggles the

463

visibility of the tool and menu bars when toggling fullscreen mode.</li>

464

<li>Use page label Determines if document-supplied page label will be

465

used instead of page numbers when available.</li>

466

<li>Document title as tab title Determines if the tab title as derived

467

from the meta-data instead of the file name.</li>

468

<li>Current page in window title If enabled, the current page and number

469

of pages of the document in the active tab are displayed in the window

470

title.</li>

471

<li>Instance name in window title If enabled and the current instance is

472

named, its name is displayed in the window title.</li>

473

<li>Highlight current thumbnail If enabled, the current page is

474

highlighted in the thumbnails view.</li>

475

<li>Limit thumbnails to results If this option is enabled and a search is

476

conducted, only the pages where the search term is found are displayed in

477

the thumbnails view.</li>

478

</ul>

479

480

<h4><a name="shortcutsettings">Shortcut settings</a> <a href="#top">↑</a></h4>

481

482

The shortcut settings allows the adjustment of keyboard shortcuts to

483

personal preference. Shortcuts are changed by double-clicking on the

484

shortcut to edit it and entering the new shortcut. Each action can have

485

several shortcuts by entering a semicolon-separated list of them. Names of

486

keys that are not single letters are written out explicitly (e.g. "Alt",

487

"Ctrl", "PgDown"), where the matching is not case sensitive. If the shortcut

488

contains modifier keys, the names of the keys are joined by a plus sign and

489

modifier keys must be listed first, e.g. "Ctrl+A" or "Ctrl++".

490

491

<h4><a name="modifiersettings">Modifier settings</a> <a href="#top">↑</a></h4>

492

493

<ul>

494

<li>Zoom The keyboard modifiers to zoom using the mouse wheel in the main

495

view.</li>

496

<li>Rotate The keyboard modifiers to rotate using the mouse wheel in the

497

main view.</li>

498

<li>Scroll The keyboard modifiers to scroll horizontally using the mouse

499

wheel in the main view.</li>

500

<li>Copy to clipboard The keyboard modifiers to copy texts or images from

501

a page to the clipboard.</li>

502

<li>Add annotation The keyboard modifiers to add annotations to a page.</li>

503

<li>Zoom to selection The keyboard modifiers to zoom to a slection on a

504

page.</li>

505

</ul>

506

507

</body>

508

509

</html>

Older »