Fix some more build warnings
[gliv.git] / README
blob46f5d27907294e4a9c88c2e2798f4eafdee72582
1 o GLiv
2 ~~~~~~
4 GLiv is an OpenGL image viewer, image loading
5 is done via Gdk-pixbuf bundled with GTK+-2.6,
6 rendering  with OpenGL and the graphical user
7 interface uses GTK+ with GtkGLExt.
8 GLiv  is  very  fast  and smooth at rotating,
9 panning  and  zooming  if  you have an OpenGL
10 accelerated graphics board.
13 o Requirements
14 ~~~~~~~~~~~~~~
16 - OpenGL
17 - GTK+ >= 2.6
18 - GtkGLExt >= 0.7.0
21 o Compilation
22 ~~~~~~~~~~~~~
24 The usual
26 $ ./configure
27 with your prefix path, then
29 $ make
31 If  you  are using the Nvidia OpenGL drivers,
32 be  sure they are actually used: once GLiv is
33 compiled,
35 $ ldd src/gliv | grep 'libGL\.so'
37 should show the path of the libGL.so from the
38 Nvidia drivers.
41 o Installation
42 ~~~~~~~~~~~~~~
44 A  'make  install'  as root will install gliv
45 in /usr/local or in your prefix path.
48 o Controls
49 ~~~~~~~~~~
51 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52 ESC, q : Quit
53 f      : Full-screen/window
54 +/=/-  : Zoom in/in/out
55 n/p    : Next/previous image
56 Pause  : Start/stop the slide show
57 l      : Reduce the image to the window
58 M      : Maximize the image to the window
59 m      : Make the image fit the window
60 r      : Reset position and size
61 b      : Toggle display of the menu bar
62 i      : Toggle display of the info bar
63 s      : Toggle display of the scrollbars
64 a      : Toggle display of the alpha checks
65 h      : Toggle display of the help box
66 w      : Toggle display of floating windows
67 o      : Display the open dialog
68 g      : Display the image selector
69 t      : Display the options dialog
70 d      : Hide the cursor
71 u      : Undo
72 y      : Redo
73 c      : Clear the history
74 Delete : Delete the current file
75 C-up   : Rotate by +90 degrees
76 C-down : Rotate by -90 degrees
77 C-left : Rotate by +0.1 degree
78 C-right: Rotate by -0.1 degree
79 z      : Horizontal flip
80 e      : Vertical flip
82 The  first  mouse  button  and the arrow keys
83 will move the image unless the Control key is
84 pressed.  In  which  case  the  image will be
85 rotated around the window center.
87 The mouse wheel zooms the image, and when you
88 hold  its  button pressed at the same time it
89 switches to the neighbouring image.
91 You  can  also  zoom  by  dragging  the mouse
92 vertically  while holding Shift and the first
93 button.
95 Space and Backspace act like n and p.
97 Draw  a  rectangle  with the third button and
98 gliv will zoom in it.
100 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
102 The  help  box contains the above text, maybe
103 translated.
105 Further  informations  can  be  found  in the
106 manual page.
110 Guillaume Chazarain <guichaz@gmail.com>
111 http://guichaz.free.fr/gliv