= PDFCube 0.0.2 =

Welcome to PDFCube home page.

PDFCube renders PDF presentations with special 3D effects (the
omnipresent rotating cube and 5 predefined zoom animations). It adds
eye-candy to your PDF presentations, even Latex, Beamer and Prosper
ones.


Right now you get a 3D cube transition pressing "c" and you can zoom
on 5 areas with "h", "j", "k", "l" and "z" keys or simply switching
pages with double buffering (no redrawing is visible) and with full
anti-alias.

If you want to program your cube transitions in advance give the page
you want the transition at on the command line this way (0 means
between page 1 and page 2, rudimental but will change soon):

 $ pdfcube file.pdf 0 5 10

Rotating cube transition is of great effect when put on a big
projection screen, so be moderate! One or two cube transitions done
when changing argument can help understanding that you are switching
to a new part of the presentation. On the other hand using cube
transition on every page can give seasickness to your audience ;)

You'll need an OpenGL DRI enabled Xorg. GPL ATI 9250 driver is OK,
i've not tested other cards.

This is alpha software (and right now it's a quick hack too), but once
you manage to get it working it's fairly stable and usable.

If you want to hack on the code feel free to contact me at
<mirko.maischberger@gmail.com> either via mail or via jabber.

== Future Plans ==

 * Use the strategy pattern to clearly uncouple animations from cube logic.

 * Add more animations.

 * Have a language so we can program presentations (cube animations,
   zooming, other transitions).

 * Read transitions effects from PDF file.

== Dependencies ==

 * Linux with Xorg
 * Poppler (>=0.5.4 recommended) (Debian/Ubuntu package:
   libpoppler-dev libpoppler-glib-dev)
 * GtkGlExt (Debian/Ubuntu package: libgtkglext1-dev)
 * OpenGL (freeglut3-dev)

== Contact information ==

Feel free to write to <mirko.maischberger@gmail.com>

== Word of Mouth ==

If you like this project please support by voting on this sites or blogging it:
 * http://digg.com/linux_unix/100allora_released_PDF_Cube_a_PDF_viewer_on_a_cube
 * http://freshmeat.net/projects/pdfcube
 * http://slashdot.org/bookmark.pl?url='http%3A%2F%2Fcode.100allora.it%2Fpdfcube'&title='PDF%20Cube'
 * http://www.gnomefiles.org/app.php/PDF_Cube


- Mirko Maischberger
