ggipdf

This project aims to create a GGI front end for Xpdf.

Project Plan

Milestone 1	Milestone 2	Milestone 3
Minimal user interface. Zoom In/Out support. Based on SplashOutputDev class.	Continuous view mode. Paper color support. Based on PDFCore class. Forward/backward text search support. Jump to page n support. Goto start/end of file. Goto last page in history. Merge with xpdf source tree.	Mouse cursor support. Cross reference support. Catalog support. Text selection and save support. Image selection and save support.

Download

Milestone 1
- 3 Sep 2005, Release 1: Patch against xpdf-3.01 xpdf-3.01 can be obtained here.
- 4 Sep 2005, Release 2: Patch against xpdf-3.01 xpdf-3.01 can be obtained here.

Changelog

Milestone 1, Release 2
- Fixed a typo in 'make install', that caused ggipdf not to install.
- Fixed missing call to 'ggiFlush()', which is required since we are using async mode.

Installation/Usage

Patching xpdf

Download the appropriate version of Xpdf from Xpdf's FTP site. Apply the patch file using the following commands

$ wget ftp://ftp.foolabs.com/pub/xpdf/xpdf-x.xx.tar.gz
$ wget http://www.bravegnu.org/xpdf/xpdf-x.xx-ggix.x-patch.gz
$ tar --gunzip -x -f xpdf-x.xx.tar.gz
$ gunzip xpdf-x.xx-ggix.x-patch.gz
$ cd xpdf-x.xx
$ patch -p1 < ../xpdf-x.xx-ggix.x-patch

Installation

Before installing make sure you have a fairly recent version of GGI and GII installed. In most cases you should be able to get away with

$ cd xpdf-x.xx
$ ./configure
$ make
# make install

If you have installed GGI and GII in a non-standard location you can use the following configure options to specify the location of the GGI and GII library files and include files.

    --with-ggi-library=PATH 
    --with-ggi-includes=DIR 
    --with-gii-library=PATH 
    --with-gii-includes=DIR

Usage

To view a PDF file

$ ggipdf filename.pdf

For more options type

$ ggipdf -h

These options are similar to other xpdf programs.

Once within the pdf viewer the following key strokes can be used

q to quit

z zoom out

Z zoom in

Arrow keys scroll through a page

Pg Up previous page

Pg Down next page

Credits

Vijay Kumar, initial GGI patch.
Christoph Egger, for bug reports and fixes.

Reporting Bugs

If you find a bug in ggipdf, please send a detailed description of the bug to vijaykumar AT bravegnu DOT org.

License

ggipdf is distributed under the GNU GPL -- as it should be.

Goto: Home

Vijay Kumar

Last modified: Sat Jul 7 16:52:36 IST 2007

q	to quit
z	zoom out
Z	zoom in
Arrow keys	scroll through a page
Pg Up	previous page
Pg Down	next page