Content-type: text/html Manpage of qiv

qiv

Section: X Tools (1)
Updated: 14 Jan 2003
Index Return to Main Contents

NAME

qiv - a fast gdk/imlib image viewer for X. Version: 2.0, released on 22.05.2004 by Adam Kopacz / KLOGRAFX.DE Network http://www.klografx.net/qiv/ - adam.k@klografx.de

SYNOPSIS

qiv [options] file ...

DESCRIPTION

qiv is an image viewer developed with gdk/imlib. As a result, qiv is faster than traditional image viewers such as xv or xli.

OPTIONS

-h, --help: Print out a brief help message.
--display disp: Open qiv window on display disp.
-F, --file file: Read file names from file, 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.
-e, --center: Disable window centering.
-w, --fixed_width x: Window with fixed width x.
-W, --fixed_zoom x.: Window with fixed zoom factor (percentage x).
-x, --root file: Set file as the current desktop background (centered) and exit.
-y, --root_t file: Set file as the current desktop background (tiled) and exit.
-z, --root_s file: Set file as the current desktop background (stretched) and exit.
-m, --maxpect: Expand image(s) to fit screen size while preserving aspect ratio.
-t, --scale_down: Shrink image(s) which are larger than screen size to fit.
-b, --brightness x: Set brightness to x (-32..32).
-c, --contrast x: Set contrast to x (-32..32).
-g, --gamma x: Set gamma to x (-32..32).
-n, --no_filter: Disable filtering of images by extension.
-i, --no_statusbar: Disable statusbar.
-I, --statusbar: Enable statusbar.
-p, --transparency: Enable transparency for transparent images.
-a, --do_grab: Grab the pointer in windowed mode.
-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 envoked from. Use with caution!
-v, --version: Print version information.
-o, --bg_color x: Set root background color to named color x or 24 bit hex RGB triple in the format #RRGGBB.
-s, --slide: Start slideshow immediately.
-r, --random: Randomize slideshow.
-R, --readonly: Disable the deletion feature.
-S, --shuffle: Shuffle images (random order with next/previous functionality).
-d, --delay x: Set slideshow delay to x seconds.
-f, --fullscreen: Use fullscreen window on start-up.
-P, --ignore_path_sort: Sort all the image files by just their filename, ignoring the path.
-M, --merged_case_sort: Sort all the image files in merged-case order (AaBbCc...).
-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).
-T, --watch: Reload the image if it has changed on disk.

EXAMPLES

qiv -atsd2 *.jpg
qiv --maxpect --root image.png
qiv --maxpect --slide --random --delay=2 *
qiv --maxpect --scale_down --slide --delay=2 `find / *`
qiv --bg_color 0000FF --root image.png
qiv --bg_color blue --root image.png

KEYS

space/left mouse/wheel down        next picture
backspace/right mouse/wheel up     previous picture
PgDn                               5 pictures forward
PgUp                               5 pictures backward
q/ESC/middle mouse                 exit

0-9                run 'qiv-command <key> <current-img>'
?/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)
u                  undelete the previously trashed image
+/=                zoom in (10%)
-                  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
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
arrow keys                 move image (in fullscreen mode)
arrow keys+Shift           move image faster (in fullscreen mode)
NumPad-arrow keys+NumLock  move image faster (in fullscreen mode)
h                  flip horizontal
v                  flip vertical
k                  rotate right
l                  rotate left
jtx<return>        jump to image number x
jfx<return>        jump forward x images
jbx<return>        jump backward x images
enter/return       reset zoom and color settings
i                  statusbar 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

MOUSE CONTROLS

Button 1                            next picture
Button 1 (hold down) & Mouse-Move   moving picture
Button 2                            quit
Button 3                            previous picture
Wheel Up                            next picture
Wheel Dn                            previous picture

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.

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 : "qiv"
@Exclude

USER-DEFINED KEYBOARD ACTIONS

Keys 0-9 will invoke qiv-command with the key pressed as the first argument and the current image filename as the second argument. 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):

#!/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

XSCREENSAVER SUPPORT

To use qiv with xscreensaver, either type "make install-xscreensaver" or add the following to your ~/.Xresources:

xscreensaver.programs: \
   /usr/bin/qiv -srfid 5 your_pix/\* \n\
   /usr/bin/qiv -srfid 5 your_other_pix/\* \n\

AUTHORS

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)

MISC

qiv homepage: http://www.klografx.net/qiv/ Mail bug, reports and comments to Adam Kopacz <adam.k@klografx.de> Sending a SIGUSR1 to qiv will cause the program to flip to next picture. SIGUSR2 will move to previous. This program is covered by the GNU GPL; see the file COPYING for details.

This document was created by man2html, using the manual pages.
Time: 09:32:37 GMT, August 10, 2006