summaryrefslogtreecommitdiffstats
path: root/man/inkview.pod.in
blob: af3c5e356c866a238b830d6d798df82e37a06a9c (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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
  ************************************************************
  * NOTE: Please do not edit this file directly.             *
  *                                                          *
  * Changes should be applied to the source file at          *
  * https://gitlab.com/inkscape/inkscape-docs/documentation/ *
  ************************************************************

=encoding UTF-8

=head1 NAME

Inkview - an SVG viewer and slideshow program.

=head1 SYNOPSIS

C<inkview [options] [filename ...]>

options:

    -h, --help
    -V, --version

    -f, --fullscreen
    -r, --recursive
    -t, --timer=NUMBER
    -s, --scale=NUMBER
    -p, --preload

=head1 DESCRIPTION

B<Inkview> is an B<Scalable Vector Graphics (SVG)> viewer that can also be
used for slideshows or presentations. One or more B<FILES> or B<FOLDERS> can
be specified on the command-line for opening. Inkview will display all SVG
files in the given order. Folders will be expanded to a list of contained SVG
files.

You can also launch Inkview without any command-line arguments, which will
bring up a file chooser that allows to select files and folders via a
graphical user interface.

=head1 OPTIONS

=over 8

=item B<-?>, B<--help>

Show help options

=item B<-V>, B<--version>

Print Inkview version and build date (this is usually matches the Inkscape version).

=item B<-f>, B<--fullscreen>

Launch Inkview in fullscreen mode.

=item B<-r>, B<--recursive>

Search folders specified on the command line recursively for SVG files.
This means all SVG files in all subfolders of the specified folder will be opened.

=item B<-t>, B<--timer=NUMBER>

Change to the next image every NUMBER seconds

=item B<-s>, B<--scale=NUMBER>

Show image scaled by a factor of NUMBER instead of using the file's native size.

=item B<-p>, B<--preload>

Preloads all SVG files. Inkview still needs to render images upon showing,
however this option ensures all SVG files are already parsed and loaded into
memory. This option can also be used to verify if all files can be opened
properly, without having to cycle through all files manually.

=back

=head1 KEYBINDINGS

=over 8

=item * Left, Page Up, or Backspace: show previous image

=item * Right, Page Down, or Space: show next image

=item * Up, or Home: go to first image

=item * Down, or End: go to last image

=back

=over 8

=item * Return: show control window

=item * F11: toggle fullscreen mode

=item * Escape or Q: quit

=back

=head1 EXAMPLES

Open two SVG files for viewing:

    inkview file1.svg file2.svg

Open all SVG files in the examples folder shipped with Inkscape:

    inkview B<${CMAKE_INSTALL_PREFIX}/${SHARE_INSTALL}>/inkscape/examples

Launch a fullscreen slideshow that automatically changes to the next image every 5 seconds:

    inkview --fullscreen --timer=5 [files/folders ...]

=head1 SEE ALSO

L<inkscape>

L<http://www.inkscape.org/>

=head1 AUTHORS

See L<inkscape(1)>

=head1 COPYRIGHT AND LICENSE

B<Copyright (C)> 1999-2020 by Authors.

B<Inkscape> is free software; you can redistribute it and/or modify it
under the terms of the GPL version 3 or later.


=for comment
$Date$