Quick Image Viewer (qiv) http://qiv.spiegl.de/ http://qiv.spiegl.de/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

374 lines
13 KiB

.\" @(#)qiv.1 -*- nroff -*-
.de EX
.ne 5
.if n .sp .5
.if t .sp .5
.nf
..
.de EE
.fi
.if n .sp .5
.if t .sp .5
..
.TH qiv 1 "qiv" "fast image viewer for X" "X Tools"
.SH NAME
qiv \- a fast gdk/imlib image viewer for X.
.br
.br
Version: 2.3.2, released on 2017-11-03
.br
by Andy Spiegl - http://qiv.spiegl.de/ - qiv.andy@spiegl.de
.br
originally by Adam Kopacz / KLOGRAFX.DE Network
.br
http://www.klografx.net/qiv/ - adam.k@klografx.de
.SH SYNOPSIS
.B qiv
[options] file ...
.SH DESCRIPTION
.I qiv
is an image viewer developed with gdk/imlib. As a result,
.I qiv
is faster than traditional image viewers such as
\fIxv\fR or \fIxli\fR.
.SH OPTIONS
.TP
.B \-h, \-\-help
Print out a brief help message.
.TP
.B \-\-display \fIdisp\fB
Open qiv window on display \fIdisp\fR.
.TP
.B \-F, \-\-file \fIfile | stdin\fB
Read file names from \fIfile\fR or \fIstdin\fR, one name per line. This option can be
specified multiple times to read from several files, and will not
affect other file names passed on the command-line.
.TP
.B \-u, \-\-recursivedir
Change the behavior of qiv to recursively descend into the directories given
on the command line.
.TP
.B \-L, \-\-followlinks
With \-\-recursivedir, this allows a symlink to point to a directory. This
is useful for organizing photo dirs into categories, but it is up to you to
ensure that there are no symlink loops that would cause an infinite scan.
.TP
.B \-e, \-\-center
Disable window centering.
.TP
.B \-w, \-\-fixed_width \fIx\fB
Window with fixed width \fIx\fR.
.TP
.B \-W, \-\-fixed_zoom \fIx\fB.
Window with fixed zoom factor (percentage \fIx\fR).
.TP
.B \-x, \-\-root \fIfile\fB
Set \fIfile\fR as the current desktop background (centered) and exit.
.TP
.B \-y, \-\-root_t \fIfile\fB
Set \fIfile\fR as the current desktop background (tiled) and exit.
.TP
.B \-z, \-\-root_s \fIfile\fB
Set \fIfile\fR as the current desktop background (stretched) and exit.
.TP
.B \-m, \-\-maxpect
Expand image(s) to fit screen size while preserving aspect ratio.
.TP
.B \-t, \-\-scale_down
Shrink image(s) which are larger than screen size to fit.
.TP
.B \-b, \-\-brightness \fIx\fB
Set brightness to \fIx\fR (-32..32).
.TP
.B \-c, \-\-contrast \fIx\fB
Set contrast to \fIx\fR (-32..32).
.TP
.B \-g, \-\-gamma \fIx\fB
Set gamma to \fIx\fR (-32..32).
.TP
.B \-n, \-\-no_filter
Disable filtering of images by extension. Normally, qiv
will only load images with an image extension such as .jpg, .png, .gif ...
This option lets you load any file as an image.
.TP
.B \-i, \-\-no_statusbar
Disable statusbar.
.TP
.B \-I, \-\-statusbar
Enable statusbar.
.TP
.B \-J, \-\-showJPEGcomments
Enable display of comment lines (in JPEG images).
.TP
.B \-p, \-\-transparency
Enable transparency for transparent images.
.TP
.B \-a, \-\-do_grab
Grab the pointer in windowed mode.
.TP
.B \-G, \-\-disable_grab
Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g. if
qiv displays images on a display other than where it was invoked
from. Use with caution!
.TP
.B \-v, \-\-version
Print version information.
.TP
.B \-o, \-\-bg_color \fIx\fB
Set root background color to named color \fIx\fR or 24 bit hex RGB triple
in the format \fI#RRGGBB\fR.
.TP
.B \-C, \-\-cycle
Change cycle behaviour. qiv will exit after last picture has been shown.
.TP
.B \-s, \-\-slide
Start slideshow immediately. This can also be used for the desktop
background (x/y/z).
.TP
.B \-r, \-\-random
Randomize slideshow.
.TP
.B \-R, \-\-readonly
Disable the deletion feature.
.TP
.B \-S, \-\-shuffle
Shuffle images (random order with next/previous functionality).
.TP
.B \-d, \-\-delay \fIx\fB
Set slideshow delay to \fIx\fR seconds.
.TP
.B \-f, \-\-fullscreen
Use fullscreen window on start-up.
.TP
.B \-P, \-\-ignore_path_sort
Sort all the image files by just their filename, ignoring the path.
.TP
.B \-M, \-\-merged_case_sort
Sort all the image files in merged-case order (AaBbCc...).
.TP
.B \-K, \-\-mtime_sort
Sort files by their modification time
.TP
.B \-N, \-\-numeric_sort
A "smart" numeric sort that attempts to sort filenames with numbers in
a logical manner. For instance: 2.jpg sorts before 10.jpg; 1foo.jpg
through 10foo.jpg sorts after 1bar.jpg through 15bar.jpg (because "foo"
comes after "bar"); and baz0001.jpg through baz0010.jpg sorts after
baz01.jpg through baz99.jpg (because the longer group of zero-padded
digits indicates that they shouldn't be intermingled).
.TP
.B \-D, \-\-no_sort
Do not apply any sorting to the list of files.
.TP
.B \-T, \-\-watch
Reload the image if it has changed on disk.
.TP
.B \-A, \-\-select_dir \fIdir\fB
Store the selected files in \fIdir\fR (default is .qiv-select).
.TP
.B \-q, \-\-rotate \fIx\fB
Rotate each image 90(x=1),180(x=2),270(x=3) degrees clockwise.
If x=11 or x=13, the 90 or 270 degree rotation is conditional on the
image fitting better if rotated. e.g. if the display is wide and
a tall image is too tall to fit on the screen, it will be rotated.
.TP
.B \-l, \-\-autorotate
Do NOT autorotate JPEGs according to EXIF rotation tag. Default is ON.
.TP
.B \-X, \-\-xineramascreen \fIx\fB
Use monitor \fIx\fR as preferred screen
.TP
.B \-Y, \-\-source_profile \fIx\fB
Use color profile file x as source profile for all images
.TP
.B \-Z, \-\-display_profile \fIx\fB
Use color profile file x as display profile for all images
.TP
.B \-B, \-\-browse
This option is useful when configuring qiv to be used with a file manager.
qiv will scan the directory of the clicked image and allow you to scroll
through those images.
.TP
.B \-\-trashbin
Use users trash bin instead of .qiv-trash. Undeleting an image will not
work, open the trash bin and restore the image instead.
.TP
.B \-\-vikeys
Enable movement with h/j/k/l, vi-style (HJKL will do what hjkl previously did)
.SH EXAMPLES
qiv \-atsd2 *.jpg
.br
qiv \-\-maxpect \-\-root image.png
.br
qiv \-\-maxpect \-\-slide \-\-random \-\-delay=2 *
.br
qiv \-\-maxpect \-\-scale_down \-\-slide \-\-delay=2 `find / *`
.br
qiv \-\-bg_color 0000FF \-\-root image.png
.br
qiv \-\-bg_color blue \-\-root image.png
.SH KEYS
.EX
space/left mouse/wheel right next picture
backspace/right mouse/wheel left previous picture
PgDn/wheel down 5 pictures forward
PgUp/wheel up 5 pictures backward
q/ESC/middle mouse exit
0-9 run 'qiv-command <key> <current-img>'
^\fI...\fR<return> run 'qiv-command ^\fI...\fR <current-img>' where \fI...\fR can be any string
?/F1 show keys
F11/F12 in/decrease slideshow delay (1 second)
a/A copy picture to .qiv-select
d/D/del move picture to .qiv-trash (-R disables this feature)
(if started with --trashbin picture is moved to users trash bin)
u undelete the previously trashed image (not working if --trashbin is used)
+/=/mouse btn 9 zoom in (+10% / +50% if above 100%)
-/mouse btn 8 zoom out (10%)
e center mode on/off
f fullscreen mode on/off
m scale to screen size on/off
t scale down on/off
X cycle through monitors
s slide show on/off
p transparency on/off
r random order on/off
b - brightness
B + brightness
c - contrast
C + contrast
g - gamma
G + gamma
o reset brightness, contrast, gamma
h flip horizontally
v flip vertically
k rotate right
l rotate left
jt\fIx\fR<return> jump to image number \fIx\fR
jf\fIx\fR<return> jump forward \fIx\fR images
jb\fIx\fR<return> jump backward \fIx\fR images
enter/return reset zoom, rotation and color settings
E display Exif information
i statusbar on/off
J JPEG comments on/off
I iconify window
w watch file on/off
x center image on background
y tile image on background
z stretch image on background
, grab on/off
< turn on/off magnifying window
arrow keys/wheel move image (in fullscreen mode)
arrow keys/wheel+Shift move image faster (in fullscreen mode)
NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
.EE
.SH MOUSE CONTROLS
.EX
Button 1 next picture
Button 1 (hold down) & Mouse-Move moving picture
Button 2 quit
Button 3 previous picture
Wheel Up/Dn move image vertically
Wheel Left/Right move image horizontally
Extra mouse buttons (8,9) zoom out/in (10%)
.EE
.SH DELETING
qiv doesn't actually delete files. It creates a directory named ".qiv-trash"
and moves the images to that directory. qiv maintains the directory
structure of your "deleted" images. You can also undelete the most
recently trashed images in reverse order, which moves each file back
into its original directory. There is a limit to how many deletions
can be undone, but it should be pretty large (currently 1024 items).
Sometimes this feature might be unwanted. To prevent accidents you can
specify the "-R" option to disable this feature. If the "--trashbin" option
is used qiv will move the deleted pictures to the users trash bin. In that
case undeleting with pressing "u" will not work. Open the trash bin and
restore the image instead.
.SH IMWHEEL SUPPORT
With XFree86 3.3.2+ server, using the wheel is seen as button 4 and
5 pressed. You only have to use "IMPS/2" or "Intellimouse" for
protocol and add "ZAxisMapping 4 5 " in the "Pointer" section of
XF86Config. If imwheel (a program used to emulate key pressed when
wheel is used for program not supporting wheel), the following two
lines must be add to imwheel config file :
.P
"qiv"
.br
@Exclude
.SH USER-DEFINED KEYBOARD ACTIONS
Keys 0-9 will invoke
.B qiv-command
with the key pressed as the first argument and the current image filename
as the second argument.
.B qiv-command
is not distributed with qiv; it is to be supplied by the user. Thus, this
feature could be enabled by placing a simple shell script such as the following in
the command search path (for example, in the user's ~/bin directory):
.P
.EX
#!/bin/sh
# Argument sanity checking eliminated for brevity
case $1 in
0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
*) echo "unrecognized command"; exit ;;
esac
.EE
.P
If the first line of the output is like "NEWNAME=xxxxxxx" then qiv
thinks that the filename of the currently displayed image has
changed to this new name and updates its internal filelist.
This is very useful when using qiv-command to rename files.
.P
Please also see the example that came together with qiv.
.EE
.SH AUTHORS
.EX
Adam Kopacz <adam.k@klografx.de>
Andy Spiegl <qiv.andy@spiegl.de>
Darren Smith <darren.smith@juno.com>
Pavel Andreev <paxvel@vumsoft.cz>
Decklin Foster <decklin@red-bean.com>
Holger Mueller <hmueller@hrzpub.tu-darmstadt.de>
Scott Sams <sbsams@eos.ncsu.edu>
Serge Winitzki <winitzki@geocities.com>
Frederic Crozat <fcrozat@mail.dotcom.fr>
Rutger Nijlunsing <rutger@wingding.demon.nl>
John Knottenbelt <jak97@doc.ic.ac.uk>
Danny <dannys@mail.com>
Tomas Ogren <stric@ing.umu.se>
Erik Jacobsen <erik@openix.com>
Alfred Weyers <alfred@otto.gia.RWTH-Aachen.DE>
Daniel <danad157@student.liu.se>
Henning Kulander <hennikul@ifi.uio.no>
Ask Bjoern Hansen <ask@valueclick.com>
Adrian Lopez <adrian2@caribe.net>
Y Furuhashi <y_furuhashi@ot.olympus.co.jp>
Wayne Davison <wayned@users.sourceforge.net>
Johannes Stezenbach <js@convergence.de>
OEyvind Kolaas <pippin@users.sourceforge.net>
Matthieu Castet <castet.matthieu@free.fr>
Geoffrey T. Dairik <dairiki@dairiki.org>
Leopoldo Cerbaro <redbliss@aliceposta.it>
Heikki Lehvaslaiho <heikki@sanbi.ac.za>
Larry Doolittle <ldoolitt@boa.org>
S. Dobrev <sdobrev@sistechnology.com>
Thomas Wiegner <wiegner@gmx.de>
Barry deFreese <bdefreese@debian.org>
Peter deWachter <pdewacht@gmail.com>
Akos Pasztory <akos.pasztory@gmail.com>
.EE
.SH MISC
.P
qiv homepage: http://qiv.spiegl.de/
.P
homepage of original author Adam Kopacz <adam.k@klografx.de>
http://www.klografx.net/qiv/
.P
Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
.P
Sending a SIGUSR1 to qiv will cause the program to flip to next picture.
SIGUSR2 will move to previous.
.P
This program is covered by the GNU GPL; see the file COPYING for
details.