root/tags/pdfcube-0.0.3/README

Revision 29, 2.1 KB (checked in by mirko, 3 years ago)

Updated readme

Line 
1= PDFCube 0.0.3 =
2
3PDFCube renders PDF presentations with special 3D effects. It adds
4eye-candy to your PDF presentations, specially Latex, Beamer and
5Prosper ones.
6
7Please see the man page for usage information.
8
9You'll need an OpenGL DRI enabled Xorg. GPL ATI 9250 driver is OK,
10i've not tested other cards but had feedback from many users on the
11net about a wide range of cards.
12
13This is alpha software (and right now it's a quick hack too), but once
14you manage to get it working it's fairly stable and usable.
15
16If you want to hack on the code feel free to contact me at
17<mirko.maischberger@gmail.com> either via mail or via jabber.
18
19== BUGS ==
20
21This program is intended to present landscape PDF files on 4:3
22projection screen, it is not suited to view generic PDF files. If you
23try to view portrait files you'll see only the top of each page. This
24is not so strange since this program is not intended as a generic PDF
25viewer but as a specific presentation tool.
26
27There is a little glitch in the animation when going back with cube
28animation. I hope is not too annoying.
29
30If you experience other glitches it's probably due to some compositing
31software (KDE Kwin, Compiz or others) this is a limitation in Xorg and
32the graphic drivers: you can only have one OpenGL accelerated
33application at a time. Try disabling the wm effects.
34
35With some older versions of libpoppler there are some rendering
36errors, this should be solved by recent poppler releases.
37
38== Conditional compilation macros and Dependencies ==
39
40You can define NDEBUG to get rid of debug output. You can try
41ENABLE_FOG if you like, the default is to have it off.
42
43 * Linux/BSD with Xorg
44 * Poppler (>=0.5.4 recommended) (Debian/Ubuntu package:
45   libpoppler-dev libpoppler-glib-dev)
46 * GtkGlExt (Debian/Ubuntu package: libgtkglext1-dev)
47 * OpenGL (freeglut3-dev)
48 * Boost C++ Program Option Library
49
50== Contact information ==
51
52Feel free to write to <mirko.maischberger@gmail.com>
53
54== Word of Mouth ==
55
56If you like this project please support by voting on this sites or blogging it:
57 * http://freshmeat.net/projects/pdfcube
58 * http://www.gnomefiles.org/app.php/PDF_Cube
59
60Happy Hacking
61- Mirko Maischberger
Note: See TracBrowser for help on using the browser.