Ian Jauslin
summaryrefslogtreecommitdiff
blob: e8d599ce518f26359cbffb2b178576323c18e4c7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.Dd $Mdocdate: April 13 2015 $
.Dt pdfPresentation 2.0.2
.Os
.Sh NAME
.Nm pdfPresentation
.Nd Displays PDF presentations on multiple screens
.Sh SYNOPSIS
.Nm
[-t 
.Sx duration
] [-s
.Sx slidelist
] 
.Sx pdf_file
.Sh DESCRIPTION
.Nm
displays presentations written in the PDF format.
.Pp
.Nm
is meant to be used with two screens, one of which is shown to the audience (called the projector), and the other is to be seen by the speaker alone (called the monitor).
.Pp
.Nm
opens a window on both the projector and the monitor. The window on the projector is automatically set to fullscreen mode, and only displays the PDF file, one page at a time. The window on the monitor can be fullscreen or not, and displays the PDF file as well as a progress bar which indicates how much time has elapsed since the beginning of the presentation and how much is left. In addition, the monitor displays the page following the one on the projector, so that the speaker can anticipate the next page that will be shown to the audience.
.Sh COMMAND-LINE ARGUMENTS
.Bl -tag -width Ds
.It Fl t Ar duration
The total duration of the presentation in minutes (defaults to 15 minutes).
.It Fl s Ar slidelist
In some cases, the page number may not match the slide number (for example if the presentation was written using the "beamer" LaTeX class with overlays (i.e. with '\\onslide' or '\\only' commands)). In order to be able to scroll through the presentation one slide at a time (instead of one page at a time), a file called the 'slidelist' can be passed to
.Nm
via this option. The slidelist should contain the page number of each slide, separated by a newline character.
.Pp
For beamer presentations, the slidelist can be generated automatically during compilation by redefining the '\\begin{frame}' command to write the page number to a file (see the 'slidelist.sty' file shipped with the source code)
.El
.Sh KEYSTROKES
.Nm
recognizes the following keystrokes (as of version 2.0.2, the only way of customizing keystrokes is to edit the source file 'mainwindow.cpp' and change the 'MainWindow::keyPressEvent' method)
.Bl -tag -width Ds
.It Sy right arrow
next page
.It Sy left arrow
previous page
.It Sy down arrow
next slide (if a slidelist was specified on the command line)
.It Sy up arrow
previous slide (if a slidelist was specified on the command line)
.It Sy f
make monitor window fullscreen
.It Sy s
start/stop timer
.It Sy r
reset timer
.It Sy t
show/hide timer progress bar
.It Sy x
exchange monitor and projector (useful if
.Nm
has mistaken the computer screen for the projector screen)
.It Sy q
quit
.El
.Sh LICENSE
.Nm
is licensed under the apache 2.0 license, see
.Pp
.D1 http://www.apache.org/licenses/LICENSE-2.0
.Pp
for details.
.Pp
.Nm
uses the Qt toolchain, which is licensed under the GNU Lesser General Public License version 3, and is linked against the poppler library which is licensed under the GNU General Public License version 3. Both licenses are provided with the source code.
.Sh AUTHORS
.Nm
was written by Ian Jauslin
.Pp
.Pp
.Sy copyright 2015 Ian Jauslin