1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194
|
.\" @(#)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 "12 May 1999" "qiv version 1.1" "X Tools"
.SH NAME
qiv \- a fast gdk/imlib image viewer for X
.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 \-w, \-\-wm \fIx\fB
Window manager handling (0-2) for the first window.
Play with this if it is not centered right on your desktop.
This can also be hardcoded into qiv (edit Makefile).
.TP
.B \-e, \-\-center
Disable window centering. Use this if no -w x works.
.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.
.TP
.B \-i, \-\-no_statusbar
Disable statusbar in fullscreen_mode.
.TP
.B \-p, \-\-transparency
Enable transparency for transparent images.
.TP
.B \-a, \-\-do_grab
Grab the pointer in windowed mode.
.TP
.B \-v, \-\-version
Print version information.
.TP
.B \-o, \-\-bg_color \fIx\fB
Set root background color to 24 bit hex RGB triple \fIx\fR.
.TP
.B \-s, \-\-slide
Start slideshow immediately.
.TP
.B \-r, \-\-random
Randomize slideshow.
.TP
.B \-d, \-\-delay \fIx\fB
Set slideshow delay to \fIx\fR seconds.
.TP
.B \-f, \-\-fullscreen
Use fullscreen window on start-up.
.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/PgDn next picture
Del/PgUp previous picture
d/D/delete move picture to .qiv-trash (*)
+/= zoom_in (10%)
- zoom_out (10%)
f fullscreen mode on/off
t scale_down on/off
s slide show on/off
r random order (slideshow) on/off
b - brightness
B + brightness
c - contrast
C + contrast
g - gamma
G + gamma
h/H flip horizontal
v/V flip vertical
right rotate right
left rotate left
jtx<enter> jump to image number x
jfx<enter> jump forward x images
jbx<enter> jump backward x images
return reset zoom and color settings
i statusbar on/off
x center image on background
y tile image on background
z stretch image on background
q/ESC exit
.EE
.SH MOUSE CONTROLS
.EX
Button 1 next picture
Button 2 quit
Button 3 previous picture
Wheel Up next picture
Wheel Dn previous picture
.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.
.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 XSCREENSAVER SUPPORT
To use qiv with xscreensaver, either type "make install-xscreensaver"
or add the following to your ~/.Xresources:
.P
.EX
xscreensaver.programs: \\
/usr/bin/qiv -srfid 5 your_pix/\\* \\n\\
/usr/bin/qiv -srfid 5 your_other_pix/\\* \\n\\
.EE
.SH AUTHORS
.EX
Adam Kopacz / kLoGraFX <Adam.K@klografx.de>
Devious <devious@verinet.com>
Pavel Andreev <paxvel@vumsoft.cz>
.EE
.SH OTHER
.EX
Frederic Crozat <fcrozat@mail.dotcom.fr>
John Knottenbelt <jak97@doc.ic.ac.uk>
Holger Mueller <hmueller@hrzpub.tu-darmstadt.de>
Rutger Nijlunsing <rutger@null.net>
Scott Sams <sbsams@eos.ncsu.edu>
Serge Winitzki <winitzki@geocities.com>
Danny <dannys@mail.com>
Tomas Ogren <stric@ing.umu.se>
Decklin Foster <decklin@home.com>
.EE
.SH MISC
.P
qiv homepage: http://www.klografx.de/
.P
Mail bug, reports and comments to Adam Kopacz <Adam.K@klografx.de>
.P
This program is covered by the GNU GPL; see the file COPYING for
details.
|