Quick Image Viewer (qiv) version 1.1 [released on: 12.05.1999]
==============================================================


Installation (Linux/Solaris/FreeBSD):
-------------------------------------

 first read the "CENTER PROBLEM" section below... Various
 compile-time options are in the Makefile; be sure to at least read
 over them before typing "make test ; make install"... :)

 if you get errors like this: "/bin/sh: imlib-config: command not
 found" then your Imlib is to old.. this mean you don't have the
 script imlib-config..  you should update Imlib (see "Links" below) or
 replace the `imlib-config` calls in the Makefile:

 `imlib-config --cflags-gdk` -->
 -I/usr/X11R6/include -I/usr/local/lib/glib/include -I/usr/local/include \
 -I/usr/local/include -I/usr/X11R6/include

 `imlib-config --libs-gdk` -->
 -L/usr/local/lib -lgdk_imlib -L/usr/local/lib -L/usr/X11R6/lib -lgtk-1.1 \
 -lgdk-1.1 -rdynamic -lgmodule-1.1 -lglib-1.1 -ldl -lXi -lXext -lX11 -lm \
 -ljpeg -ltiff -lgif -lpng -lz -lm


 If you want to use qiv as a screensaver so please type 
 "make install-xscreensaver"
 

Other OSes:
----------

 Try the Linux/Solaris/FreeBSD stuff.. it would be nice if you could drop 
 me some lines if qiv work also on other systems (HP-UX, FreeBSD?) ...
	

Authors:
--------

  Adam Kopacz / kLoGraFX  <Adam.K@klografx.de>
  Devious                 <devious@verinet.com>
  Pavel Andreev           <paxvel@vumsoft.cz>   
  Decklin Foster          <decklin@home.com>

  Other contributors:
  
  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@null.net>
  John Knottenbelt       <jak97@doc.ic.ac.uk>
  Danny                  <dannys@mail.com>
  Tomas Ogren            <stric@ing.umu.se>


Homepage:   
---------

  http://www.klografx.de/


Misc:
-----

  Thanx to all programers, Owen Taylor and Rasterman (@REDHAT)
  for helping with patches and their knowledge :-)

  type "man qiv" for more information.
  See the Makefile if you have problems compiling.

  qiv is designed to work with gtk/gdk 1.0.x and 1.1.x, it also
  should work with ANY version of Imlib of Linux (Intel/Mac),
  Solaris (SunOS) and FreeBSD.


Center Problem:
---------------
  
  we use only GDK with qiv and no GTK.. so there is a big problem with
  centering windows on screen and each Window Manager handles this
  stuff by it own way :-( but we try to show the windows centered on
  screen..

  Window Mager/Enlightenment/fvwm2 etc. :
      You don't need to do anything.. (Makefile: WM_HANDLE=0 or "-w
      0")

  Kwm(KDE)/SCWM etc. :
      You must set "-DWM_HANDLE=1" in the Makefile or start qiv with
      "-w 1"..  but this don't works 100% :-(

  Other:
      Please use "--center, -e" for disabling centering...
            
  ps:  you see the center problem only on the first image..
  pps: if you use FVWM2, WM_HANDLE=0 and --do_grab/-a then you will
       see the window jump again.. the damm WM sucks <g>.. only the
       newest like Enlightenment or Window Mager seems to handle the
       stuff right..  ...but i use still my fvwm2 ;)


Thumbnails:
-----------

  i don't plan on adding a thumbnail function.  sorry, but qiv is a
  QUICK image VIEWER and nothing more.  if you want more features
  (with Imlib) then try Electric Eyes or gqview ...

  
Image caching:
--------------

  if you want image_caching then comment out the
  gdk_imlib_kill_image(im); line in main.c, but don't forget to set
  you cache sizes with imlib_config !  this stuff don't work right
  here (imlib 1.8 cvs) and on a imlib 1.6 system so i have disabled
  this nice Imlib feature by killing the images from the buffer.


Links:
------

  ImLib   : http://www.labs.redhat.com/imlib/
  gtk/gdk : http://www.gtk.org/


Contact:
--------

  Mail bug, reports and comments to Adam Kopacz <Adam.K@klografx.de>
