pdfcube(1) · carta

Usage

pdfcube [FILE] [--help] [--bgcolor f:f:f] [--top-color f:f:f] [--no-fullscreen] [--demo] [--program n:x:n:x: ...]

Overview

pdfcube(1) is a tiny (about 30KiB) viewer for Portable Document Format (PDF) files that adds spinning cube transition effect to your PDF presentation files. It can also zoom on 5 predefined areas with a smooth zooming effect. This program is suited only for landscape PDF files, mostly presentations done with LaTeX (Beamer, Prosper, etc.) or OpenOffice.org Impress.

If FILE is not given a file-open dialog box is shown to the user.

pdfcube(1) is an open source, low-effort, spare-time, money-less project. Your help is welcome!

Options

-h [ --help ]: This help message.

-v [ --version ]: Version information

`-b [ --bgcolor ] arg`	Background color is 'r:g:b' with real values between 0.0 and 1.0, no spaces.
`-t [ --top-color ] arg`	Cube top color in 'r:g:b' format again with reals in [0,1].

-n [ --no-fullscreen ]: Don't activate full-screen mode by default.

--demo Automatically auto-advance presentation based on the: frame duration PDF attribute (\transduration when using Latex Beamer) or the specified program (see the --program option).

--program A program in the form: n:x:n:x:n:x... where n are durations in seconds and "x" can be either "c" for cube transition and "p" for plain transition. (e.g. --program 5:c:3:p). The last program is used for all remaining slides.

Notes

The first (and only) non-option string is treated as the input file.

Interactive control

`c, a`	Will display the next/previous page with a cube transition effect.
`SPACE, PG-DOWN`	Will switch to the next page with the programmed effect.
`h, j, k, l, z`	Will zoom into the predefined areas.
`g`	Will undo any zoom.
`ESC, Ctrl-q`	Will exit pdfcube immediately.
`PG-UP, Left-Arrow`	Will quick-switch to the previous page.
`Right-Arrow`	Will quick-switch to the next page.
`f`	Will toggle full-screen mode.
`t`	Will toggle auto-advance (demo) mode.
`Ctrl-l`	Will redraw the screen.
`Ctrl-1, Ctrl-2, ..., Ctrl-9`	Will jump to the page corresponding to the n-th programmed transition (if any).
`1, 2, ..., 9`	Will jump to page 5*(n-1).

Configuration file

If the ~/.pdfcuberc file exists, it is used as a configuration file. The configuration file uses the same options as the command line (using the boost program options syntax). e.g.

demo=true
bgcolor=0:0:0
program=5:p

Examples

pdfcube foo.pdf: Will display 'foo.pdf' in full-screen.

pdfcube --demo --program 5:c foo.pdf: Will display 'foo.pdf' in full-screen and will do a cube transition every 5 seconds.

pdfcube foo.pdf --bgcolor 0:0:0 --top-color 0.6:0.2:0.2: Will display 'foo.pdf' with custom background and cube color.

Resources

Main web site: http://code.100allora.it/pdfcube/

Thanks

I'd like to thank the LILiK laboratory in Florence, Italy for having teached me the value of open-source and open-culture.

Copying

This manpage is available under the same GPL v2 or later license as the main program, the original manpage was written by Alexander Wirt <mailto:[email protected]> for the Debian distribution. The 0.0.5 version is Copyright (C) 2008-2012 Mirko Maischberger.

Releases

8 releases since Debian 5.0 (Lenny); the text changed 2 times.

--help since Debian 7 (Wheezy); --no-fullscreen since Debian 7 (Wheezy); --version since Debian 7 (Wheezy); -h since Debian 7 (Wheezy); -n since Debian 7 (Wheezy); -v since Debian 7 (Wheezy).

--transitions until Debian 7 (Wheezy); -c until Debian 7 (Wheezy).