MAN page from RedHat Other xpdf-0.80-decrypt-1.i386.rpm

xpdf

Section: User Commands (1)
Updated: 27 Nov 1998
Index

NAME

xpdf - Portable Document Format (PDF) file viewer for X (version 0.80)

SYNOPSIS

xpdf[options][PDF-file[page]]

DESCRIPTION

Xpdfis a viewer for Portable Document Format (PDF) files. (These are alsosometimes also called 'Acrobat' files, from the name of Adobe's PDFsoftware.) Xpdf runs under the X Window System on UNIX, VMS, andOS/2.

To run xpdf, simply type:

: xpdf file.pdf

wherefile.pdfis your PDF file. The file name can be followed by a numberspecifying the page which should be displayed first, e.g.:

: xpdf file.pdf 18

You can also start xpdf without opening any files:

: xpdf

OPTIONS

X resources are listed in square brackets with the correspondingoption.

-err: Send error messages to /dev/tty instead of stderr (useful if xpdf isstarted from another application, e.g., netscape which otherwise popsup an annoying little window for every error).
-z number: Set the initial zoom factor (-5 .. 5).[xpdf.initialZoom]
-g geometry: Set the initial window geometry.(-geometryis equivalent.)[xpdf.geometry]
-remote name: Start/contact xpdf remote server with specified name (see theREMOTE SERVER MODEsection below).
-raise: Raise xpdf remote server window (with -remote only).
-quit: Kill xpdf remote server (with -remote only).
-cmap: Install a private colormap. This is ignored on TrueColor visuals.[xpdf.installCmap]
-rgb number: Set the size of largest RGB cube xpdf will try to allocate. Thedefault is 5 (for a 5x5x5 cube); set to a smaller number to conservecolor table entries. This is ignored with private colormaps and onTrueColor visuals.
-papercolor color: Set the "paper color", i.e., the background of the page display. Thiswill not work too well with PDF files that do things like filling inwhite behind the text.[xpdf.paperColor]
-ps PS-file: Set the default file name for PostScript output. This can also be ofthe form '|command' to pipe the PostScript through a command.[xpdf.psFile]
-paperw size: Set the paper width, in points.[xpdf.psPaperWidth]
-paperh size: Set the paper height, in points.[xpdf.psPaperHeight]
-level1: Generate Level 1 PostScript. The resulting PostScript files will besignificantly larger (if they contain images), but will print on Level1 printers. This also converts all images to black and white.[xpdf.psLevel1]
-cmd: Print commands as they're executed (useful for debugging).
-h: Print usage information.(-helpis equivalent.)

Several other standard X options and resources will work as expected:

-display display: [xpdf.display]
-fg color: (-foregroundis equivalent.)[xpdf.foreground]
-bg color: (-backgroundis equivalent.)[xpdf.background]
-font font: (-fnis equivalent.)[xpdf.font]

The color and font options only affect the user interface elements,not the PDF display (the 'paper').

The following X resources do not have command line option equivalents:

xpdf.urlCommand: Set the command executed when you click on a URL link. See theWEB BROWSERSsection below for details.

CONTROLS

On-screen controls, at the bottom of the xpdf window

left/right arrow buttons: Move to the previous/next page.
double left/right arrow buttons: Move backward or forward by ten pages.
'Page' entry box: Move to a specific page number. Click in the box to activate it, typethe page number, then hit return.
magnifying glass buttons: Increase and decrease the resolution, i.e., zoom in and zoom out.
binoculars button: Find a text string.
print button: Bring up a dialog for generating a PostScript file. The dialog hasoptions to set the pages to be printed and the PostScript file name.The file name can be '-' for stdout or '|command' to pipe thePostScript through a command, e.g., '|lpr'.
'?' button: Bring up the 'about xpdf' window.
link info: The space between the '?' and 'Quit' buttons is used to show the URLor external file name when the mouse is over a link.
'Quit' button: Quit xpdf.

Open...: Open a new PDF file via a file requester.
Save PDF...: Save the current file via a file requester.
Rotate left: Rotate the page 90 degrees counterclockwise.
Rotate right: Rotate the page 90 degrees clockwise. The two rotate commands areintended primarily for PDF files where the rotation isn't correctlyspecified in the file, but they're also useful if your X serverdoesn't support font rotation.
Quit: Quit xpdf.

Text selection

Dragging the mouse with the left button held down will highlight anarbitrary rectangle. Any text inside this rectangle will be copied tothe X selection buffer.

Links

Clicking on a hyperlink will jump to the link's destination. A linkto another PDF document will make xpdf load that document. A'launch' link to an executable program will display a dialog, and ifyou click 'ok', execute the program. URL links call an externalcommand (see theWEB BROWSERSsection below).

Panning

Dragging the mouse with the middle button held down pans the window.

Key bindings

o: Open a new PDF file via a file requester.
f: Find a text string.
n: Move to the next page.
p: Move to the previous page.
<Space> or <PageDown> or <Next>: Scroll down on the current page; if already at bottom, move to nextpage.
<Backspace> or <Delete> or <PageUp> or <Previous>: Scroll up on the current page; if already at top, move to previouspage.
<Home>: Scroll to top of current page.
<End>: Scroll to bottom of current page.
arrows: Scroll the current page.
control-L: Redraw the current page.
q: Quit xpdf.

WEB BROWSERS

If you want to run xpdf automatically from netscape or mosaic (andprobably other browsers) when you click on a link to a PDF file, youneed to edit (or create) the files.mime.typesand.mailcapin your home directory. In.mime.typesadd the line:

: application/pdf pdf

In.mailcapadd the lines:

: # Use xpdf to view PDF files.

: application/pdf; xpdf -err %s

Make sure that xpdf is on your executable search path.

When you click on a URL link in a PDF file, xpdf will execute thecommand specified by the xpdf.urlCommand resource, replacing anoccurrence of '%s' with the URL. For example, to call netscape withthe URL, use this resource setting:

: xpdf.urlCommand: netscape -remote 'openURL(%s)'

REMOTE SERVER MODE

Xpdf can be started in remote server mode by specifying a server name(in addition to the file name and page number). For example:

: xpdf -remote myServer file.pdf

If there is currently no xpdf running in server mode with the name'myServer', a new xpdf window will be opened. If another command:

: xpdf -remote myServer another.pdf 9

is issued, a new copy of xpdf will not be started. Instead, the firstxpdf (the server) will loadanother.pdfand display page nine. If the file name is the same:

: xpdf -remote myServer another.pdf 4

the xpdf server will simply display the specified page.

The -raise option tells the server to raise its window; it can bespecified with or without a file name and page number.

The -quit option tells the server to close its window and exit.

CONFIGURATION FILE

Xpdf will read a file called.xpdfrcfrom your home directory (if it exists). This file can contain twotypes of entries.

fontpath directory: Look for Type 1 fonts indirectory.Xpdf uses this only to get the font encoding. For display, the fontmust also be mapped with afontmapentry.
fontmap PDF-font X-font: MapPDF-font(as referenced in a PDF file) toX-font,which should be a standard X font descriptor with '%s' in the pixelsize position.

For example, use:

: fontmap TimesCE-Roman -*-times-medium-r-*-*-%s-*-*-*-*-*-iso8859-2

to map the Central European (Latin-2) version of the Times-Romanfont. This assumes that you've installed the appropriate X fonts (seemkfontdir(1)).Xpdf knows about the ISO8859-2 encoding, so you don't need afontpathentry for these fonts.To use the Bakoma Type 1 fonts, do this:

: fontpath /home/derekn/fonts/bakoma
fontmap cmb10 -bakoma-cmb10-medium-r-normal--%s-*-*-*-p-*-adobe-fontspecific
fontmap cmbsy10 -bakoma-cmbsy10-medium-r-normal--%s-*-*-*-p-*-adobe-fontspecific
etc...

This assumes that the Type 1 font files are available in the directory/home/derekn/fonts/bakoma.