gliv.1

   1 .TH "gliv" "1" "1.1" "Guillaume Chazarain" "Image viewer"
   2 .SH "NAME"
   3 gliv \- An OpenGL image viewer
   4 .SH "SYNOPSIS"
   5 \fBgliv\fR [OPTIONS]... [FILES]...
   6 .SH "DESCRIPTION"
   7 \fIgliv\fR uses the Imlib2 to open images and OpenGL to render them.
   8 It allows to do some moving, zooming, slideshow.
   9 .SH "OPTIONS"
  10 The options are used in such a way that if you specify twice the same one, the option will not be activated.
  11 Thus, to disable an option activated by default just specify it.
  12
  13 .TP
  14 \fB\-h, \-\-help\fR
  15 Print help and exit.
  16 .TP
  17 \fB\-V, \-\-version\fR
  18 Print version and exit.
  19 .TP
  20 \fB\-f, \-\-fullscreen\fR
  21 Start in full screen mode (default=off). You can still go back to windowed mode.
  22 .TP
  23 \fB\-s, \-\-shuffle\fR
  24 Show images in random order (default=off). Switching images will preserve the order but you cannot go back to normal order.
  25 .TP
  26 \fB\-R, \-\-recursive\fR
  27 Processe directories recursively (default=off). If you specify a directory in the command line \fIgliv\fR will open every image in this directory and its subdirectories.
  28 .TP
  29 \fB\-i, \-\-info\fR
  30 Show infos about displayed image (default=off). With this option, \fIgliv\fR will by default print the info line you can obtain by typing 'i'.
  31 .TP
  32 \fB\-m, \-\-maximize\fR
  33 Maximize image to fit window (default=off). This option implies \-f and is like typing 'm' with every image.
  34 .TP
  35 \fB\-dINT, \-\-delay=INT\fR
  36 Delay before hiding the cursor. If you use this option with a strictly positive number t as argument, \fIgliv\fR will wait for t seconds of mouse inactivity and then hide the cursor. It reappears when you move the mouse or exit \fIgliv\fR.
  37 .TP
  38 \fB\-b, \-\-menu\fR
  39 Display the menu bar. Use it to display the currently minimal menubar, you can also use the 'b' key.
  40 .SH "CONTROLS"
  41 ESC, q : Quit.
  42 .br
  43 f/w    : Full\-screen/Window.
  44 .br
  45 +/\-    : zoom in/out.
  46 .br
  47 n/p    : Next/Previous image.
  48 .br
  49 m      : Maximize image to fit window.
  50 .br
  51 r      : Reset position and size.
  52 .br
  53 b      : toggle display of menuBar.
  54 .br
  55 i      : toggle display of Info.
  56 .br
  57 h      : toggle display of Help.
  58 .br
  59 o      : toggle display of Open dialog.
  60 .br
  61
  62 .br
  63 Move  the  image with the mouse or the arrow keys.  Your  mouse wheel (if supported) will zoom images and switch between them when the button is pressed.
  64 .br
  65
  66 .br
  67 Space and Backspace act like n and p.
  68 .br
  69
  70 .br
  71 Draw  a  rectangle with the right button and gliv will zoom in it.
  72 .SH "PROBLEMS"
  73 With OpenGL, texture sizes are limited and this limit depends on your graphic board. So when a large image is opened \fIgliv\fR subdivides it in smaller ones, and when you zoom in, these small images are filtered individually. That's why you can see the separation of small squares when zooming in.
  74 This problem is now partially fixed.
  75 .SH "AUTHOR"
  76 Guillaume Chazarain <booh@altern.org>
  77 .br
  78 See http://gliv.tuxfamily.org.