GLiv
----

GLiv  is  an  OpenGL  image  viewer,  image
loading    is   done   through   Gdk-pixbuf
(standalone   or   bundled   with  GTK+-2),
rendering  through OpenGL and the graphical
user interface uses GTK+ with the GtkGLArea
widget.
If  Gdk-pixbuf  cannot  load your image, it
uses ImageMagick to convert it to PNG.
GLiv  is  very fast and smooth at rotating,
panning  and  zooming if you have an OpenGL
accelerated board.


Requirements
------------

- OpenGL
- GdkPixbuf
- GTK+
- GtkGLArea
- ImageMagick (optional)


Compilation
-----------

Compilation options:

--disable-gtk2: Use  it  if  you  installed
GTK+-2 and do not want to use it with GLiv.

--disable-magick: Use  it  if you installed
ImageMagick but do not want to use it.

And the usual...

> ./configure --disable-dependency-tracking
with your prefix path, then
> make

If you are using the Nvidia OpenGL drivers,
be  sure they are actually used : once GLiv
is compiled,
> ldd src/gliv | grep 'libGL\.so'
should  show  the path of the libGL.so from
the Nvidia drivers.


Installation
------------

A 'make install-strip' as root will install
gliv in /usr/local or in your prefix path.


Controls
--------

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ESC, q  : Quit.
f       : Full-screen/window.
+/-     : zoom in/out.
n/p     : Next/Previous image.
l       : reduce the image to the window.
M       : Maximize the image to the window.
m       : Make the image fit the window.
r       : Reset position and size.
b       : toggle display of the menuBar.
i       : toggle display of the Info bar.
h       : toggle display of the Help box.
o       : display the Open dialog.
t       : display the opTions dialog.
d       : hiDe the curosr.
u       : Undo.
y       : redo.
c       : Clear the history.
C-up    : Rotate by +45 degrees.
C-down  : Rotate by -45 degrees.
C-left  : Rotate by +0.1 degree.
C-right : Rotate by -0.1 degree.
z       : horiZontal flip.
e       : vErtical flip.

The  first  mouse button and the arrow keys
will  move the image unless the Control key
is pressed. In which case the image will be
rotated around the window center.

Your  mouse  wheel (if supported) will zoom
the  image and switch it when you press the
button.

Space and Backspace act like n and p.

Draw  a rectangle with the third button and
gliv will zoom in it.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The help box contains the above text, maybe
translated.

Further  informations  can  be found in the
manual page.


TODO
----

- Some translations.
- Manual mipmapping.


Guillaume Chazarain <booh@altern.org>
