| 1 |
Quick Image Viewer (qiv) by Andy Spiegl |
| 2 |
http://qiv.spiegl.de/ - [email protected] |
| 3 |
--------------------------------------------------------------------------- |
| 4 |
Original author: Adam Kopacz / KLOGRAFX.DE Network |
| 5 |
http://www.klografx.net/qiv/ - [email protected] |
| 6 |
=========================================================================== |
| 7 |
|
| 8 |
|
| 9 |
Installation (Linux/Solaris/FreeBSD): |
| 10 |
------------------------------------- |
| 11 |
|
| 12 |
If you are using Debian/GNU Linux (or a derivative thereof) just type: |
| 13 |
dpkg-buildpackage -uc -B -m"[email protected]" -rfakeroot |
| 14 |
|
| 15 |
Various compile-time options are in the Makefile; be sure to at least |
| 16 |
read over them before typing "make install"... :) |
| 17 |
|
| 18 |
qiv-command |
| 19 |
----------- |
| 20 |
Rename "qiv-command.example" to "qiv-command" and copy it in your path if |
| 21 |
you want to launch other programs within qiv. This is very nice for stuff |
| 22 |
like "metacam", "jhead", "exiftool" etc. to show the EXIF-infos of digital photos. |
| 23 |
|
| 24 |
If you get errors like this: "/bin/sh: pkg-config: command not |
| 25 |
found" then your Imlib is too old.. this means you don't have the |
| 26 |
program pkg-config. You should install pkg-config or replace |
| 27 |
the `pkg-config` calls in the Makefile: |
| 28 |
|
| 29 |
`pkg-config --cflags gdk-2.0 imlib2` --> |
| 30 |
-I/usr/include/gtk-2.0 -I/usr/lib/gtk-2.0/include -I/usr/include/pango-1.0 \ |
| 31 |
-I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/cairo \ |
| 32 |
-I/usr/include/pixman-1 -I/usr/include/freetype2 -I/usr/include/libpng12 |
| 33 |
|
| 34 |
|
| 35 |
`pkg-config --libs gdk-2.0 imlib2` --> |
| 36 |
-lgdk-x11-2.0 -lgdk_pixbuf-2.0 -lm -lpangocairo-1.0 -lgio-2.0 -lpango-1.0 \ |
| 37 |
-lcairo -lgobject-2.0 -lgmodule-2.0 -lglib-2.0 -lImlib2 |
| 38 |
|
| 39 |
Solaris Users: please try "Makefile.Solaris" instead of "Makefile" |
| 40 |
if the default Makefile doesn't work for you. |
| 41 |
|
| 42 |
|
| 43 |
Other OSes: |
| 44 |
---------- |
| 45 |
|
| 46 |
Try the Linux/Solaris/FreeBSD stuff... it would be nice if you could drop |
| 47 |
me some lines if qiv works also on other systems (HP-UX?) ... |
| 48 |
|
| 49 |
|
| 50 |
Authors: |
| 51 |
-------- |
| 52 |
|
| 53 |
Adam Kopacz <[email protected]> |
| 54 |
Andy Spiegl <[email protected]> |
| 55 |
Thomas Wiegner <[email protected]> |
| 56 |
...and many more (see Changelog and/or Homepage) |
| 57 |
|
| 58 |
|
| 59 |
Homepage: |
| 60 |
--------- |
| 61 |
|
| 62 |
http://qiv.spiegl.de/ |
| 63 |
|
| 64 |
|
| 65 |
Homepage of original author: |
| 66 |
---------------------------- |
| 67 |
|
| 68 |
http://www.klografx.net/qiv/ |
| 69 |
|
| 70 |
|
| 71 |
Misc: |
| 72 |
----- |
| 73 |
|
| 74 |
Thanx to all programers, Owen Taylor and Rasterman (@REDHAT) |
| 75 |
for helping with patches and their knowledge :-) |
| 76 |
|
| 77 |
type "man qiv" for more information. |
| 78 |
See the Makefile if you have problems compiling. |
| 79 |
|
| 80 |
qiv is designed to work with ANY gtk/gdk, it also |
| 81 |
should work with ANY version of Imlib of Linux (Intel/Mac), |
| 82 |
Solaris (SunOS) and FreeBSD. |
| 83 |
As of version 2.2 imlib2 and gdk-2.0 are required, as imlib1 |
| 84 |
and gtk-1.2 are basically obsolete. To use autorotation based |
| 85 |
on exif information gdk >= 2.12 is required. |
| 86 |
|
| 87 |
Up to release 1.3 of imlib2 there is a problem with the includes. |
| 88 |
Imlib2.h does not load Xlib.h. |
| 89 |
Workaround: to add the following (as very first line) to qiv.h: |
| 90 |
#include <X11/Xlib.h> |
| 91 |
|
| 92 |
|
| 93 |
Centering: |
| 94 |
---------- |
| 95 |
|
| 96 |
As of version 1.7, qiv centers images by applying the correct window |
| 97 |
position and setting the window gravity to Static, so that window |
| 98 |
managers don't move the window when adding borders. If you come |
| 99 |
across a window manager that does mess up our centering, or has |
| 100 |
other problems with qiv, email Decklin ([email protected]) and |
| 101 |
he'll quickly send off a patch to whoever maintains that WM. ;-) |
| 102 |
|
| 103 |
|
| 104 |
Thumbnails: |
| 105 |
----------- |
| 106 |
|
| 107 |
we don't plan on adding a thumbnail function. sorry, but qiv is a |
| 108 |
QUICK image VIEWER and nothing more. if you want more features |
| 109 |
(with Imlib) then try Electric Eyes or gqview or feh ... |
| 110 |
|
| 111 |
|
| 112 |
Links: |
| 113 |
------ |
| 114 |
|
| 115 |
ImLib2 : http://freshmeat.net/projects/imlib2/ |
| 116 |
gtk/gdk : http://www.gtk.org/ |
| 117 |
qiv-orig : http://www.klografx.net/qiv/ |
| 118 |
qiv : http://qiv.spiegl.de/ |
| 119 |
git-repo : https://codeberg.org/ciberandy/qiv.git |
| 120 |
|
| 121 |
Contact: |
| 122 |
-------- |
| 123 |
|
| 124 |
Mail bug, reports and comments to Andy Spiegl <[email protected]> |
| 125 |
|