a08087af7a
fixes #43
131 lines
2.4 KiB
Groff
131 lines
2.4 KiB
Groff
.TH IMV 1 "" "" "multimedia"
|
|
.SH NAME
|
|
imv \- image viewer
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fBimv\fP [-rfaudlh] [-n <NUM|PATH>] [-b COLOR] [-e FONT:SIZE] [-t SECONDS] [images...]
|
|
.fi
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBimv\fP is a X11/Wayland image viewer aimed at users of tiling window managers.
|
|
It supports a wide variety of image file formats, including animated gif files.
|
|
.SH FLAGS
|
|
.TP
|
|
.B -
|
|
Read paths from stdin. One path per line.
|
|
.TP
|
|
.B -r
|
|
Recursively search input paths for files.
|
|
.TP
|
|
.B -f
|
|
Start in full screen mode
|
|
.TP
|
|
.B -a
|
|
Default to showing images at actual size.
|
|
.TP
|
|
.B -u
|
|
Use nearest neighbour resampling. Recommended for pixel art.
|
|
.TP
|
|
.B -d
|
|
Show overlay.
|
|
.TP
|
|
.B -l
|
|
List open files on exit.
|
|
.TP
|
|
.B -h
|
|
Print help.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI "-n " <NUM|PATH>
|
|
Start at image number NUM, or the image with the path PATH.
|
|
.TP
|
|
.BI "-b " BG
|
|
Set the background color. Either 'checks' or a hex color value.
|
|
.TP
|
|
.BI "-e " FONT:SIZE
|
|
Set the font used by the overlay. FONT can be any valid system font, such as
|
|
FreeSans, FreeMono, etc. Defaults to FreeMono:24.
|
|
.TP
|
|
.BI "-t " SECONDS
|
|
Set the slideshow delay in seconds. Setting this to zero disables slideshow
|
|
mode, which is the default.
|
|
.SH CONTROLS
|
|
.sp
|
|
imv can be controlled using the mouse or keyboard.
|
|
.TP
|
|
.B Drag + Left Mouse Button
|
|
Pan.
|
|
.TP
|
|
.B MouseWheel
|
|
Zoom in and out.
|
|
.TP
|
|
.B q
|
|
Quit.
|
|
.TP
|
|
.B LEFT and [
|
|
Change to previous image.
|
|
.TP
|
|
.B RIGHT and ]
|
|
Change to next image.
|
|
.TP
|
|
.B i and \&+ and UP
|
|
Zoom in.
|
|
.TP
|
|
.B o and \- and DOWN
|
|
Zoom out.
|
|
.TP
|
|
.B r
|
|
Reset view.
|
|
.TP
|
|
.B a
|
|
View image at actual size.
|
|
.TP
|
|
.B c
|
|
Center image in window.
|
|
.TP
|
|
.B h
|
|
Pan left.
|
|
.TP
|
|
.B j
|
|
Pan down.
|
|
.TP
|
|
.B k
|
|
Pan up.
|
|
.TP
|
|
.B l
|
|
Pan right.
|
|
.TP
|
|
.B x
|
|
Close current image.
|
|
.TP
|
|
.B f
|
|
Toggle fullscreen.
|
|
.TP
|
|
.B SPACE
|
|
Pause gif playback (pressing again unpauses).
|
|
.TP
|
|
.B \&.
|
|
Step forward one frame (when playing gifs).
|
|
.TP
|
|
.B p
|
|
Print current image path to stdout
|
|
.TP
|
|
.B t
|
|
Increase slideshow delay by one second
|
|
.TP
|
|
.B T
|
|
Decrease slideshow delay by one second. When delay is zero, slideshow mode is
|
|
disabled.
|
|
.SH LEGAL
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License
|
|
as published by the Free Software Foundation; either version 2
|
|
of the License, or (at your option) any later version.
|
|
.LP
|
|
This software uses the FreeImage open source image library.
|
|
See http://freeimage.sourceforge.net for details.
|
|
FreeImage is used under the GNU GPLv2.
|
|
.SH AUTHOR
|
|
Harry Jeffery
|