README

   1 GLiv
   2 ----
   3
   4 GLiv  is  an  OpenGL  image  viewer,  image
   5 loading    is   done   through   Gdk-pixbuf
   6 (standalone  or  bundled  with GTK+-1.3.x),
   7 rendering  through OpenGL and the graphical
   8 user interface uses GTK+ with the GtkGLArea
   9 widget.
  10 If  Gdk-pixbuf  cannot  load your image, it
  11 uses ImageMagick to convert it to PNG.
  12 GLiv  is  very fast and smooth at rotating,
  13 panning  and  zooming if you have an OpenGL
  14 accelerated board.
  15
  16
  17 Requirements
  18 ------------
  19
  20 - OpenGL
  21 - GdkPixbuf
  22 - GTK+
  23 - GtkGLArea
  24 - ImageMagick (optional)
  25
  26
  27 Compilation
  28 -----------
  29
  30 Compilation options:
  31
  32 --disable-gtk2: Use it if you installed the
  33 development  version of GTK and do not want
  34 to use it with GLiv.
  35
  36 --disable-magick: Use  it  if you installed
  37 ImageMagick but do not want to use it.
  38
  39 And the usual...
  40
  41 > ./configure --disable-dependency-tracking
  42 with your prefix path, then
  43 > make
  44
  45 If you are using the Nvidia OpenGL drivers,
  46 be  sure they are actually used : once GLiv
  47 is compiled,
  48 > ldd src/gliv | grep 'libGL\.so'
  49 should  show  the path of the libGL.so from
  50 the Nvidia drivers.
  51
  52
  53 Installation
  54 ------------
  55
  56 A 'make install-strip' as root will install
  57 gliv in /usr/local or in your prefix path.
  58
  59
  60 Controls
  61 --------
  62
  63 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  64 ESC, q : Quit.
  65 f      : Full-screen/window.
  66 +/-    : zoom in/out.
  67 n/p    : Next/Previous image.
  68 l      : reduce the image to the window.
  69 M      : Maximize the image to the window.
  70 m      : Make the image fit the window.
  71 r      : Reset position and size.
  72 b      : toggle display of the menuBar.
  73 i      : toggle display of the Info bar.
  74 h      : toggle display of the Help box.
  75 o      : display the Open dialog.
  76 t      : display the opTions dialog.
  77 d      : hiDe the curosr.
  78 u      : Undo.
  79 y      : redo.
  80 c      : Clear the history.
  81
  82 The  first  mouse button and the arrow keys
  83 will  move the image unless the Control key
  84 is pressed. In which case the image will be
  85 rotated around the window center.
  86
  87 Your  mouse  wheel (if supported) will zoom
  88 the  image and switch it when you press the
  89 button.
  90
  91 Space and Backspace act like n and p.
  92
  93 Draw  a rectangle with the third button and
  94 gliv will zoom in it.
  95 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  96
  97 The help box contains the above text, maybe
  98 translated.
  99
 100 Further  informations  can  be found in the
 101 manual page.
 102
 103
 104 TODO
 105 ----
 106
 107 - Manual mipmapping.
 108
 109
 110 Guillaume Chazarain <booh@altern.org>