168 lines
3.6 KiB
Groff
168 lines
3.6 KiB
Groff
.Dd December 30, 2015
|
|
.Dt IMV 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm imv
|
|
.Nd view images
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl adfhlrSsux
|
|
.Op Fl b Ar color
|
|
.Op Fl e Ar font:size
|
|
.Op Fl n Ar position
|
|
.Op Fl t Ar seconds
|
|
.Op Ar
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is an image viewer for
|
|
.Xr X 7
|
|
and Wayland, aimed at users of tiling window managers.
|
|
It supports a wide variety of image file formats, including animated gif files.
|
|
.Nm
|
|
reloads the current image if it detects changes to the file.
|
|
.Pp
|
|
.Nm
|
|
accepts following flags:
|
|
.Bl -tag -width Ds
|
|
.It Fl a
|
|
.Dq actual size
|
|
mode: show images at actual size.
|
|
.It Fl b Ar color
|
|
Set the background color.
|
|
Either
|
|
.Ar checks
|
|
or a hex color value.
|
|
Defaults to
|
|
.Ar 000000 .
|
|
.It Fl e Ar font:size
|
|
Set the font used by the overlay.
|
|
.Ar font
|
|
can be any valid system font, such as FreeSans, FreeMono, etc.
|
|
Defaults to
|
|
.Ar Monospace:24 ,
|
|
which is the default monospace font, as configured in
|
|
.Xr fonts.conf 5 .
|
|
.It Fl d
|
|
Show textual overlay.
|
|
.It Fl f
|
|
Start in full screen mode.
|
|
.It Fl h
|
|
Print help message.
|
|
.It Fl l
|
|
List open files on exit.
|
|
.It Fl n Ar position
|
|
Start at specific position in image list.
|
|
.Ar position
|
|
may be expressed as a number or as a path of an image.
|
|
.It Fl r
|
|
Recursively search input paths for files.
|
|
.It Fl S
|
|
.Dq perfect fit
|
|
mode: upscale or downscale image to fit window.
|
|
This is the default.
|
|
.It Fl s
|
|
.Dq best fit
|
|
mode: downscale image to fit window.
|
|
Images that are smaller then window are shown in actual size.
|
|
.It Fl t Ar seconds
|
|
Set the slideshow delay in seconds.
|
|
Fractional numbers are accepted.
|
|
Setting this to zero disables slideshow mode, which is the default.
|
|
.It Fl u
|
|
Use nearest neighbour resampling.
|
|
Recommended for pixel art.
|
|
.It Fl x
|
|
Exit when reaching end of file list.
|
|
.El
|
|
.Ss Reading from standard input
|
|
When run with argument
|
|
.Sq - ,
|
|
.Nm
|
|
reads image from standard input.
|
|
Argument
|
|
.Sq -
|
|
may occur among other arguments, but only once.
|
|
.Pp
|
|
If no arguments supplied, reads list of files from standard input.
|
|
.Pp
|
|
.Sh CONTROLS
|
|
.Bl -tag -width Ds
|
|
.It Aq Cm left mouse button
|
|
Pan relative to mouse motion.
|
|
.It Aq Cm mouse wheel
|
|
Zoom in and out.
|
|
.It Cm q
|
|
Quit.
|
|
.It Ao Cm left Ac | Cm \&[
|
|
Change to previous image.
|
|
.It Ao Cm right Ac | Cm \&]
|
|
Change to next image.
|
|
.It Cm i | Cm + | Aq Cm up
|
|
Zoom in.
|
|
.It Cm o | Cm - | Aq Cm down
|
|
Zoom out.
|
|
.It Cm r
|
|
Reset view
|
|
.It Cm a
|
|
View image at actual size.
|
|
.It Cm c
|
|
Center image in window.
|
|
.It Cm h
|
|
Pan left.
|
|
.It Cm j
|
|
Pan down.
|
|
.It Cm k
|
|
Pan up.
|
|
.It Cm l
|
|
Pan right.
|
|
.It Cm x
|
|
Close current image.
|
|
.It Cm X
|
|
Close current image and remove it from disk.
|
|
.It Cm d
|
|
Toggle display of textual overlay.
|
|
.It Cm f
|
|
Toggle fullscreen.
|
|
.It Cm SPACE
|
|
Toggle gif playback.
|
|
.It Cm .
|
|
Step forward one frame (when playing gifs).
|
|
.It Cm p
|
|
Print current image path to stdout
|
|
.It Cm s
|
|
Switch scaling mode.
|
|
Available modes are:
|
|
.Dq actual size
|
|
.Pq don't scale images ,
|
|
.Dq best fit
|
|
.Pq downscale images to fit window, but don't scale smaller images ,
|
|
.Dq perfect fit
|
|
.Pq upscale or downscale images to fit window
|
|
.Pq default ,
|
|
in this order.
|
|
.It Cm t
|
|
Increase slideshow delay by one second
|
|
.It Cm T
|
|
Decrease slideshow delay by one second.
|
|
When delay is zero, slideshow mode is disabled.
|
|
.Sh EXAMPLES
|
|
Load all files from directory
|
|
.Pa dir :
|
|
.Pp
|
|
.Dl $ ls dir | imv
|
|
or
|
|
.Dl $ ls dir | xargs imv
|
|
.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.
|
|
.Pp
|
|
This software uses the FreeImage open source image library.
|
|
See
|
|
.Lk http://freeimage.sourceforge.net
|
|
for details.
|
|
FreeImage is used under the GNU GPLv2.
|
|
.Sh AUTHOR
|
|
.An Harry Jeffery
|