83
83
Set the matte color, i.e., the color used for back-
84
ground outside the actual page area. [X resource:
84
ground outside the actual page area. (There is a
85
separate setting, xpdf.fullScreenMatteColor, for
86
full-screen mode.) [X resource: xpdf.matteColor]
88
Set the initial zoom factor. A number specifies a
89
zoom percentage, where 100 means 72 dpi.You may
90
also specify 'page', to fit the page to the window
89
Set the initial zoom factor. A number specifies a
90
zoom percentage, where 100 means 72 dpi.You may
91
also specify 'page', to fit the page to the window
91
92
size, or 'width', to fit the page width to the win-
92
dow width. [config file: initialZoom; or X
93
dow width. [config file: initialZoom; or X
93
94
resource: xpdf.initialZoom]
95
-cont Start in continuous view mode, i.e., with one ver-
96
tical scroll bar for the whole document. [config
96
-cont Start in continuous view mode, i.e., with one ver-
97
tical scroll bar for the whole document. [config
97
98
file: continuousView]
177
184
-quit Kill xpdf remote server (with -remote only).
179
-cmd Print commands as they're executed (useful for
186
-cmd Print commands as they're executed (useful for
180
187
debugging). [config file: printCommands]
182
-q Don't print any messages or errors. [config file:
189
-q Don't print any messages or errors. [config file:
186
Read config-file in place of ~/.xpdfrc or the sys-
193
Read config-file in place of ~/.xpdfrc or the sys-
187
194
tem-wide config file.
189
196
-v Print copyright and version information.
191
-h Print usage information. (-help and --help are
198
-h Print usage information. (-help and --help are
194
Several other standard X options and resources will work
201
Several other standard X options and resources will work
198
205
[X resource: xpdf.display]
201
(-foreground is equivalent.) [X resource:
208
(-foreground is equivalent.) [X resource:
205
(-background is equivalent.) [X resource:
212
(-background is equivalent.) [X resource:
209
216
(-fn is equivalent.) [X resource: xpdf*fontList]
211
The color and font options only affect the user interface
218
The color and font options only affect the user interface
212
219
elements, not the PDF display (the 'paper').
214
The following X resources do not have command line option
221
The following X resources do not have command line option
218
Enables the 'h', 'l', 'k' and 'j' keys for left,
219
right, up, and down scrolling.
221
224
xpdf.toolTipEnable
222
225
Enables (if set to true) or disables (if set to
223
226
false) the tool-tips on the toolbar buttons.
228
xpdf.fullScreenMatteColor
229
Sets the matte color to be used in full-screen
230
mode. The default setting is "black".
226
233
On-screen controls, at the bottom of the xpdf window
227
234
left/right arrow buttons
268
Pressing the right mouse button will post a popup menu
275
Pressing the right mouse button will post a popup menu
269
276
with the following commands:
272
279
Open a new PDF file via a file requester.
274
281
Open in new window...
275
Create a new window and open a new PDF file via a
282
Create a new window and open a new PDF file via a
278
Reload Reload the current PDF file. Note that Xpdf will
279
reload the file automatically (on a page change or
285
Reload Reload the current PDF file. Note that Xpdf will
286
reload the file automatically (on a page change or
280
287
redraw) if it has changed since it was last loaded.
283
290
Save the current file via a file requester.
286
Toggles between single page and continuous view
293
Toggles between single page and continuous view
289
296
Rotate counterclockwise
290
297
Rotate the page 90 degrees counterclockwise.
293
Rotate the page 90 degrees clockwise. The two
294
rotate commands are intended primarily for PDF
295
files where the rotation isn't correctly specified
300
Rotate the page 90 degrees clockwise. The two
301
rotate commands are intended primarily for PDF
302
files where the rotation isn't correctly specified
306
Zoom in to the currently selected rectangle.
298
308
Close Close the current window. If this is the only open
299
window, the document is closed, but the window is
300
left open (i.e., this menu command won't quit
309
window, the document is closed, but the window is
310
left open (i.e., this menu command won't quit
307
If the PDF contains an outline (a.k.a., bookmarks), there
308
will be an outline pane on the left side of the window.
309
The width of the outline pane is adjustable with a verti-
317
If the PDF contains an outline (a.k.a., bookmarks), there
318
will be an outline pane on the left side of the window.
319
The width of the outline pane is adjustable with a verti-
310
320
cal split bar via the knob near its bottom end.
314
Dragging the mouse with the left button held down will
315
highlight an arbitrary rectangle. Any text inside this
324
Dragging the mouse with the left button held down will
325
highlight an arbitrary rectangle. Any text inside this
316
326
rectangle will be copied to the X selection buffer.
320
Clicking on a hyperlink will jump to the link's destina-
321
tion. A link to another PDF document will make xpdf load
322
that document. A 'launch' link to an executable program
323
will display a dialog, and if you click 'ok', execute the
324
program. URL links call an external command (see the WEB
325
BROWSERS section below).
330
Clicking on a hyperlink will jump to the link's
331
destination. A link to another PDF document will make
332
xpdf load that document. A 'launch' link to an executable
333
program will display a dialog, and if you click 'ok', exe-
334
cute the program. URL links call an external command (see
335
the WEB BROWSERS section below).
329
Dragging the mouse with the middle button held down pans
339
Dragging the mouse with the middle button held down pans
334
344
o Open a new PDF file via a file requester.
336
r Reload the current PDF file. Note that Xpdf will
337
reload the file automatically (on a page change or
346
r Reload the current PDF file. Note that Xpdf will
347
reload the file automatically (on a page change or
338
348
redraw) if it has changed since it was last loaded.
414
426
Make sure that xpdf is on your executable search path.
416
428
When you click on a URL link in a PDF file, xpdf will exe-
417
cute the command specified by the urlCommand config file
429
cute the command specified by the urlCommand config file
418
430
option, replacing an occurrence of '%s' with the URL. For
419
example, to call netscape with the URL, add this line to
431
example, to call netscape with the URL, add this line to
420
432
your config file:
422
434
urlCommand "netscape -remote 'openURL(%s)'"
437
Xpdf's key and mouse bindings are user-configurable, using
438
the bind and unbind options in the config file (see
439
xpdfrc(5)). The bind command allows you to bind a key or
440
mouse button to a sequence of one or more commands.
443
The following commands are supported:
446
Go to the specified page.
448
gotoPageNoScroll(page)
449
Go to the specified page, with the current relative
453
Go to a named destination.
456
Go to the last page in the PDF file.
459
Go to the last page in the PDF file, with the cur-
460
rent relative scroll position.
466
Go to the next page, with the current relative
470
Go to the previous page.
473
Go to the previous page, with the current relative
476
pageUp Scroll up by one screenful.
479
Scroll down by one screenful.
482
Scroll left by n pixels.
485
Scroll right by n pixels.
488
Scroll up by n pixels.
491
Scroll down by n pixels.
494
Scroll up by n pixels, moving to the previous page
497
scrollDownPrevPage(n)
498
Scroll down by n pixels, moving to the next page if
502
Scroll to the top edge of the current page, with no
506
Scroll to the bottom edge of the current page, with
507
no horizontal movement.
510
Scroll to the left edge of the current page, with
511
no vertical movement.
514
Scroll to the right edge of the current page, with
515
no vertical movement.
518
Scroll to the top-left corner of the current page.
521
Scroll to the bottom-right corner of the current
525
Move forward along the history path.
528
Move backward along the history path.
531
Set the zoom factor to z%.
534
Set the zoom factor to fit-page.
537
Set the zoom factor to fit-width.
539
zoomIn Zoom in - go to the next higher zoom factor.
542
Zoom out - go the next lower zoom factor.
545
Go to continuous view mode.
548
Go to single-page view mode.
551
Toggle between continuous and single page view
555
Go to full-screen mode.
558
Go to window (non-full-screen) mode.
561
Toggle between full-screen and window modes.
563
open Open a PDF file in this window, using the open dia-
567
Open a PDF file in a new window, using the open
571
Open a specified PDF file in this window.
573
openFileInNewWin(file)
574
Open a specified PDF file in a new window.
576
openFileAtDest(file,dest)
577
Open a specified PDF file in this window and go to
580
openFileAtDestInNewWin(file,dest)
581
Open a specified PDF file in a new window and go to
584
reload Reload the current PDF file.
586
redraw Redraw the window.
588
raise Raise the window to the front.
593
run(external-command-string)
594
Run an external command. The following escapes are
595
allowed in the command string:
597
%f => PDF file name (or an empty string if no
599
%b => PDF file base name, i.e., file name minus
600
the extension (or an empty string if no
602
%u => link URL (or an empty string if not over
604
%x => selection upper-left x coordinate
605
(or 0 if there is no selection)
606
%y => selection upper-left y coordinate
607
(or 0 if there is no selection)
608
%X => selection lower-right x coordinate
609
(or 0 if there is no selection)
610
%Y => selection lower-right y coordinate
611
(or 0 if there is no selection)
616
Open the outline pane.
619
Close the outline pane.
622
Toggle the outline pane between open and closed.
625
Scroll the outline down by n increments.
628
Scroll the outline up by n increments.
631
Set the keyboard focus to the main document window.
634
Set the keyboard focus to the page number text box.
636
find Open the 'find' dialog.
639
Finds the next occurrence of the search string (no
642
print Open the 'print' dialog.
644
about Open the 'about' dialog.
648
The following commands depend on the current mouse posi-
652
Start a selection, which will be extended as the
659
Start a pan, which will scroll the document as the
665
Display the popup menu.
668
Follow a hyperlink (does nothing if the mouse is
672
Follow a hyperlink, opening PDF files in a new win-
673
dow (does nothing if the mouse is not over a link).
674
For links to non-PDF files, this command is identi-
678
Same as followLink, but does nothing if there is a
679
non-empty selection. (This is useful as a mouse
682
followLinkInNewWinNoSel
683
Same as followLinkInNewWin, but does nothing if
684
there is a non-empty selection. (This is useful as
685
a mouse button binding.)
688
The default mouse bindings are as follows:
690
bind mousePress1 any startSelection
691
bind mouseRelease1 any endSelection followLinkNoSel
692
bind mousePress2 any startPan
693
bind mouseRelease2 any endPan
694
bind mousePress3 any postPopupMenu
695
bind mousePress4 any scrollUpPrevPage(16)
696
bind mousePress5 any scrollDownNextPage(16)
697
bind mousePress6 any scrollLeft(16)
698
bind mousePress7 any scrollRight(16)
700
The default key bindings are as follows:
702
bind ctrl-home any gotoPage(1)
703
bind home any scrollToTopLeft
704
bind ctrl-end any gotoLastPage
705
bind end any scrollToBottomRight
707
bind backspace any pageUp
708
bind delete any pageUp
709
bind pgdn any pageDown
710
bind space any pageDown
711
bind left any scrollLeft(16)
712
bind right any scrollRight(16)
713
bind up any scrollUp(16)
714
bind down any scrollDown(16)
722
bind ctrl-g any findNext
723
bind ctrl-p any print
724
bind n scrLockOff nextPage
725
bind N scrLockOff nextPage
726
bind n scrLockOn nextPageNoScroll
727
bind N scrLockOn nextPageNoScroll
728
bind p scrLockOff prevPage
729
bind P scrLockOff prevPage
730
bind p scrLockOn prevPageNoScroll
731
bind P scrLockOn prevPageNoScroll
733
bind b any goBackward
734
bind g any focusToPageNum
735
bind 0 any zoomPercent(125)
738
bind z any zoomFitPage
739
bind w any zoomFitWidth
740
bind alt-f any toggleFullScreenMode
741
bind ctrl-l any redraw
742
bind ctrl-w any closeWindow
747
Previous versions of xpdf included a "viKeys" X resource.
748
It is no longer available, but the following bindings are
751
bind h any scrollLeft(16)
752
bind l any scrollRight(16)
753
bind k any scrollUp(16)
754
bind j any scrollDown(16)
424
757
REMOTE SERVER MODE
425
758
Xpdf can be started in remote server mode by specifying a
426
759
server name (in addition to the file name and page num-