summaryrefslogtreecommitdiffstats
path: root/man/inkview.pod.in
diff options
context:
space:
mode:
Diffstat (limited to 'man/inkview.pod.in')
-rw-r--r--man/inkview.pod.in136
1 files changed, 136 insertions, 0 deletions
diff --git a/man/inkview.pod.in b/man/inkview.pod.in
new file mode 100644
index 0000000..628d679
--- /dev/null
+++ b/man/inkview.pod.in
@@ -0,0 +1,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-2023 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$