New command line options handling.
[gliv.git] / README
blob66d6833df52c883348e2f24dd3d5ae876226c9d8
1 o GLiv
2 ~~~~~~
4 GLiv is an OpenGL image viewer, image loading
5 is done via Gdk-pixbuf bundled with GTK+-2.2,
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.2
18 - GtkGLExt >= 0.7.0
21 o Compilation
22 ~~~~~~~~~~~~~
24 The usual
26 $ ./configure   --disable-dependency-tracking
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-strip'  as root will install
45 gliv 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 l      : Reduce the image to the window
57 M      : Maximize the image to the window
58 m      : Make the image fit the window
59 r      : Reset position and size
60 b      : Toggle display of the menu bar
61 i      : Toggle display of the info bar
62 s      : Toggle display of the scrollbars
63 a      : Toggle display of the alpha checks
64 h      : Toggle display of the help box
65 o      : Display the open dialog
66 t      : Display the options dialog
67 d      : Hide the cursor
68 u      : Undo
69 y      : Redo
70 c      : Clear the history
71 x      : Delete the current file
72 C-up   : Rotate by +45 degrees
73 C-down : Rotate by -45 degrees
74 C-left : Rotate by +0.1 degree
75 C-right: Rotate by -0.1 degree
76 z      : Horizontal flip
77 e      : Vertical flip
79 The  first  mouse  button  and the arrow keys
80 will move the image unless the Control key is
81 pressed.  In  which  case  the  image will be
82 rotated around the window center.
84 Your mouse wheel (if supported) will zoom the
85 image  and  switch  it  when  you  press  the
86 button.
88 You  can  also  zoom  by  dragging  the mouse
89 vertically  while holding Shift and the first
90 button.
92 Space and Backspace act like n and p.
94 Draw  a  rectangle  with the third button and
95 gliv will zoom in it.
97 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
99 The  help  box contains the above text, maybe
100 translated.
102 Further  informations  can  be  found  in the
103 manual page.
107 Guillaume Chazarain <guichaz@yahoo.fr>
108 http://gliv.tuxfamily.org