Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse Search

Direc­tory tex-archive/support/xpdfopen

---------------------------------------------------------------------------
xpdfopen 0.85 - Send open/close commands to Acrobat Reader, xpdf and evince
---------------------------------------------------------------------------

This is a Linux (X11) implementation of Fabrice Popineau's pdfclose/
pdfopen commands to control Acrobat Reader, xpdf and evince.

The libX code was borrowed from Reinhard Fobbe's Sendx library for 
Tcl/Tk, and the programs use the same license, copied below. 

Version 0.3 adds support for Adobe Reader 7.0 for Linux.
            (different window titles and key shortcuts)

Version 0.4 uses autoconf

Version 0.5 fixes an incorrect autoconf variable, supports building
            under X11R5, handles pathnames on the command-line, and
            fixes a bug where pdfopen did not exit correctly after
            (automatically) starting acroread.

Version 0.51 uses the strrchr() function instead of rindex() 
             to allow compilation on non-BSD derived unix platforms.

Version 0.61 attempts to do something useful with Adobe Reader 8,
             even though it is impossible to restore the viewport.

Version 0.80 adds an implementation for AR 9 and xpdf.

Version 0.81 adds an implementation for evince.

Version 0.82 adds a man page and -v/--version options for pdfopen.

Version 0.83 adds the -r/-reset_focus option for pdfopen.

Version 0.84 adds 'load at given page' support (-p option) for Adobe
             Reader 9, evince (at least 3.12, maybe earlier) and xpdf.

Version 0.85 adds 'load at named destination' support (-g/--goto option)
             for xpdf, evince and (supposedly) AR9.  The AR9 man page
             claims it should work, but it doesn't for me.  I left
             the allegedly-correct code there anyway, in case it works
             for other people in other places.
             Also add aliases for option names to make ms-windows
             users feel at home.

Version 0.86 fixes 'load at named destination' for AR9.


The AR command lines do not behave precisely the same as under Windows, 
because the Linux Reader behaves somewhat differently: it is not 
scriptable, but it is possible to 'fake' key-presses.


pdfopen has the following call sequence:
	pdfopen [-r|-reset_focus] \
		[-viewer/--viewer <ar9|ar9-tab|ar8|ar7|ar5|xpdf|evince>] \
                [-p/--page <page number>] \
                [-g/--goto <named destination>] \
                [--file] <pdf file name>

The "ar9" version uses AR9's "-openInNewInstance" option, the "ar9-tab"
version does not (so if there is already an AR9 window open, a new tab
will be opened in that window).


pdfclose has the following call sequence:
	pdfclose [--file] <pdf file name>
This program closes an existing AR5, AR7, AR8, AR9, xpdf or evince window
displaying the given PDF file.


Version 0.85 compiles on Linux (Slackware64 14.1, anyway) with
the following command:
	gcc -Wall pdfopen.c sendx.c utils.c -o pdfopen -lX11 -s
	gcc -Wall pdfclose.c sendx.c utils.c -o pdfclose -lX11 -s
should you not want to go through the process of creating and running
a configure program.


Taco Hoekwater <taco@metatex.org> (Version(s) up to 0.61)
Dordrecht, The Netherlands, December 2008.

Jim Diamond <jim.diamond@acadiau.ca> (Version 0.80 through 0.84)
Acadia University, Wolfville, Nova Scotia, Canada; May 2014.




License terms:
--------------
The following terms apply to all files associated with the software
unless explicitly disclaimed in individual files.

The authors hereby grant permission to use, copy, modify, distribute,
and license this software and its documentation for any purpose,
provided that existing copyright notices are retained in all copies
and that this notice is included verbatim in any distributions. No
written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by
their authors and need not follow the licensing terms described here,
provided that the new terms are clearly indicated on the first page of
each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND
THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

Files

Name Size Date Notes
ChangeLog 5053 2014-05-24 15:56
Makefile.am 616 2014-05-17 00:46
Makefile.in 18087 2010-04-12 01:24
README 4758 2014-05-24 15:53
aclocal.m4 32230 2010-04-12 01:24
configure 179753 2010-04-12 01:24
configure.ac 426 2014-05-24 15:54
externs.h 517 2014-05-17 00:44
pdfclose.c 1551 2014-05-22 17:35
pdfopen.1 5992 2014-05-24 15:55
pdfopen.c 19328 2014-05-24 15:59
pdfopen.pdf 16795 2014-05-24 16:03
sendx.c 9411 2012-01-28 01:39
sendx.h 657 2010-05-03 23:27
utils.c 1207 2014-05-16 22:48
utils.h 306 2014-05-16 23:12
xpdfopen.h 1205 2014-05-24 15:56

Down­load the con­tents of this pack­age in one zip archive (82.6k).

xpdfopen – Com­mands to con­trol PDF read­ers, un­der X11

The com­mand-line pro­grams pdfopen and pdf­close al­low you to con­trol the X Win­dow Sys­tem ver­sion of Adobe's Acro­bat Reader from the com­mand line or from within a (shell) script. The pro­grams work with Acro­bat Reader 5, 7, 8 and 9 for Linux, xpdf and evince.

This ver­sion de­rives from one writ­ten by Fabrice Popineau for Mi­crosoft op­er­at­ing sys­tems.

Pack­age De­tailsxpdfopen
Ver­sion0.86
Li­censePublic Do­main Soft­ware
Main­tainerFabrice Popineau (in­ac­tive)
Jim Di­a­mond
Taco Hoek­wa­ter (in­ac­tive)
Con­tained inTeXlive as pdftools
Topics ap­pli­ca­tion for view­ing a type­set doc­u­ment on screen
Guest Book Sitemap Contact