Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
xpdf(1)
Edit
PageHistory
Diff
Info
LikePages
xpdf !!!xpdf NAME SYNOPSIS DESCRIPTION CONFIGURATION FILE OPTIONS CONTROLS WEB BROWSERS REMOTE SERVER MODE BUGS AUTHOR SEE ALSO ---- !!NAME xpdf - Portable Document Format (PDF) file viewer for X (version 1.00) !!SYNOPSIS __xpdf__ [[options] [[''PDF-file'' [[''page'' | +''dest'']] !!DESCRIPTION __Xpdf__ is a viewer for Portable Document Format (PDF) files. (These are also sometimes also called Acrobat' files, from the name of Adobe's PDF software.) Xpdf runs under the X Window System on UNIX, VMS, and OS/2. To run xpdf, simply type: xpdf file.pdf where ''file.pdf'' is your PDF file. The file name can be followed by a number specifying the page which should be displayed first, e.g.: xpdf file.pdf 18 You can also give a named destination, prefixed with +' in place of the page number. You can also start xpdf without opening any files: xpdf !!CONFIGURATION FILE Xpdf reads a configuration file at startup. It first tries to find the user's private config file, ~/.xpdfrc. If that doesn't exist, it looks for a system-wide config file, typically /usr/local/etc/xpdfrc (but this location can be changed when xpdf is built). See the xpdfrc(5) man page for details. !!OPTIONS Many of the following options can be set with configuration file commands or X resources. These are listed in square brackets with the description of the corresponding command line option. __-g__ ''geometry'' Set the initial window geometry. (__-geometry__ is equivalent.) [[X resource: __xpdf.geometry__] __-title__ ''title'' Set the window title. By default, the title will be xpdf.title__] __-cmap__ Install a private colormap. This is ignored on !TrueColor visuals. [[X resource: __xpdf.installCmap__] __-rgb__ ''number'' Set the size of largest RGB cube xpdf will try to allocate. The default is 5 (for a 5x5x5 cube); set to a smaller number to conserve color table entries. This is ignored with private colormaps and on !TrueColor visuals. [[X resource: __xpdf.rgbCubeSize__] __-papercolor__ ''color'' Set the xpdf.paperColor__] __-z__ ''zoom'' Set the initial zoom factor. A number (-5 .. 5) specifies a zoom factor, where 0 means 72 dpi. You may also specify page', to fit the page to the window size, or width', to fit the page width to the window width. [[X resource: __xpdf.initialZoom__] __-t1lib__ ''font-type'' Set the type of font rendering for t1lib (the Type 1 rasterizer) to use. Options are none' (don't use t1lib at all), plain' (use non-anti-aliased fonts), low' or high' (use low-level or high-level anti-aliased fonts). [[config file: __t1libControl__] __-freetype__ ''font-type'' Set the type of font rendering for !FreeType (the !TrueType rasterizer) to use. Options are none' (don't use !FreeType at all), plain' (use non-anti-aliased fonts), or aa' (use anti-aliased fonts). [[config file: __freetypeControl__] __-ps__ ''PS-file'' Set the default file name for !PostScript output. This can also be of the form |command' to pipe the !PostScript through a command. [[config file: __psFile__] __-paper__ ''size'' Set the paper size to one of psPaperSize__] __-paperw__ ''size'' Set the paper width, in points. [[config file: __psPaperSize__] __-paperh__ ''size'' Set the paper height, in points. [[config file: __psPaperSize__] __-level1__ Generate Level 1 !PostScript. The resulting !PostScript files will be significantly larger (if they contain images), but will print on Level 1 printers. This also converts all images to black and white. [[config file: __psLevel__] __-enc__ ''encoding-name'' Sets the encoding to use for text output. The ''encoding-name'' must be defined with the unicodeMap command (see xpdfrc(5)). This defaults to __textEncoding__] __-eol__ ''unix | dos | mac'' Sets the end-of-line convention to use for text output. [[config file: __textEOL__] __-opw__ ''password'' Specify the owner password for the PDF file. Providing this will bypass all security restrictions. __-upw__ ''password'' Specify the user password for the PDF file. __-fullscreen__ Open xpdf in a full-screen mode, useful for presentations. You may also want to specify '-bg black' (or similar) with this. (There is currently no way to switch between window and full-screen modes on the fly.) __-remote__ ''name'' Start/contact xpdf remote server with specified name (see the __REMOTE SERVER MODE__ section below). __-raise__ Raise xpdf remote server window (with -remote only). __-quit__ Kill xpdf remote server (with -remote only). __-cmd__ Print commands as they're executed (useful for debugging). __-q__ Don't print any messages or errors. [[config file: __errQuiet__] __-cfg__ ''config-file'' Read ''config-file'' in place of ~/.xpdfrc or the system-wide config file. __-v__ Print copyright and version information. __-h__ Print usage information. (__-help__ and __--help__ are equivalent.) Several other standard X options and resources will work as expected: __-display__ ''display'' [[X resource: __xpdf.display__] __-fg__ ''color'' (__-foreground__ is equivalent.) [[X resource: __xpdf.foreground__] __-bg__ ''color'' (__-background__ is equivalent.) [[X resource: __xpdf.background__] __-font__ ''font'' (__-fn__ is equivalent.) [[X resource: __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.viKeys__ Enables the h', l', k' and j' keys for left, right, up, and down scrolling. !!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. __dashed left/right arrow buttons__ Move backward or forward along the history path. __Page' entry box__ Move to a specific page number. Click in the box to activate it, type the page number, then hit return. __zoom popup menu__ Change the zoom factor (see the description of the -z option above). __binoculars button__ Find a text string. __print button__ Bring up a dialog for generating a !PostScript file. The dialog has options to set the pages to be printed and the !PostScript file name. The file name can be -' for stdout or |command' to pipe the !PostScript 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 URL or external file name when the mouse is over a link. __Quit' button__ Quit xpdf. __Menu__ Pressing the right mouse button will post a popup menu with the following commands: __Open...__ Open a new PDF file via a file requester. __Reload__ Reload the current PDF file. Note that Xpdf will reload the file automatically (on a page change or redraw) if it has changed since it was last loaded. __Save as...__ Save the current file via a file requester. __Rotate counterclockwise__ Rotate the page 90 degrees counterclockwise. __Rotate clockwise__ Rotate the page 90 degrees clockwise. The two rotate commands are intended primarily for PDF files where the rotation isn't correctly specified in the file, but they're also useful if your X server doesn't support font rotation. __Quit__ Quit xpdf. __Text selection__ Dragging the mouse with the left button held down will highlight an arbitrary rectangle. Any text inside this rectangle will be copied to the X selection buffer. __Links__ Clicking on a hyperlink will jump to the link's destination. A link to another PDF document will make xpdf load that document. A launch' link to an executable program will display a dialog, and if you click ok', execute the program. URL links call an external command (see the __WEB BROWSERS__ section 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. __r__ Reload the current PDF file. Note that Xpdf will reload the file automatically (on a page change or redraw) if it has changed since it was last loaded. __f__ Find a text string. __n__ Move to the next page. Scrolls to the top of the page, unless scroll lock is turned on. __p__ Move to the previous page. Scrolls to the top of the page, unless scroll lock is turned on. ____ or ____ or ____ Scroll down on the current page; if already at bottom, move to next page. ____ or ____ or ____ or ____ Scroll up on the current page; if already at top, move to previous page. __v__ Move forward along the history path. __b__ Move backward along the history path. ____ Scroll to top of current page. ____ Scroll to bottom of current page. __arrows__ Scroll the current page. __0__ Set the zoom factor to zero (72 dpi). __+__ Zoom in (increment the zoom factor by 1). __-__ Zoom out (decrement the zoom factor by 1). __z__ Set the zoom factor to 'page' (fit page to window). __w__ Set the zoom factor to 'width' (fit page width to window). __control-L__ Redraw the current page. __q__ Quit xpdf. !!WEB BROWSERS If you want to run xpdf automatically from netscape or mosaic (and probably other browsers) when you click on a link to a PDF file, you need to edit (or create) the files ''.mime.types'' and ''.mailcap'' in your home directory. In ''.mime.types'' add the line: application/pdf pdf In ''.mailcap'' add the lines: # Use xpdf to view PDF files. application/pdf; xpdf -q %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 the command specified by the urlCommand config file option, replacing an occurrence of %s' with the URL. For example, to call netscape with the URL, add this line to your config file: urlCommand !!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 first xpdf (the server) will load ''another.pdf'' and 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 be specified with or without a file name and page number. The -quit option tells the server to close its window and exit. !!BUGS No support for Type 3 fonts. !!AUTHOR The xpdf software and documentation are copyright 1996-2002 Derek B. Noonburg (derekn@foolabs.com). !!SEE ALSO pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1), pdftopbm(1), pdfimages(1), xpdfrc(5)__ http://www.foolabs.com/xpdf/__ ----
11 pages link to
xpdf(1)
:
pdftotext(1)
AdobeAcrobat
pdffonts(1)
pdftops(1)
xpdfrc(5)
Man1x
pdfimages(1)
pdfinfo(1)
pdftopbm(1)
update-xpdfrc(8)
PDF
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
