gliv.1

   1 .TH "gliv" "1" "1.7" "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 gdk\-pixbuf to load images and OpenGL to render them.
   8 It allows to do some moving, rotating, zooming and slide show.
   9 .SH "OPTIONS"
  10 The options are first set to their default value, then read from ~/.glivrc and finally read from the command line.
  11 .br
  12 To disable an option activated by default just specify it, in order to toggle its value.
  13
  14 .TP
  15 \fB\-h, \-\-help\fR
  16 Print help and exit.
  17 .TP
  18 \fB\-V, \-\-version\fR
  19 Print version and exit.
  20 .TP
  21 \fB\-s, \-\-shuffle\fR
  22 Show images in random order. The images list will be shuffled before the slide show.
  23 .TP
  24 \fB\-S, \-\-sort\fR
  25 Show images in sorted order. The images list will be sorted before the slide show.
  26 .TP
  27 \fB\-R, \-\-recursive\fR
  28 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.
  29 .TP
  30 \fB\-f, \-\-fullscreen\fR
  31 Start in full screen mode (default=off). You can still go back to windowed mode by pressing 'f' or using the menu.
  32 .TP
  33 \fB\-l, \-\-scale\-down\fR
  34 Reduce the image to the window (default=off). Make the image fit window if the image need to be reduced. It implies \-f and is like typing 'l' with every image.
  35 .TP
  36 \fB\-M, \-\-maximize\fR
  37 Maximize the image to the window (default=off). Make the image fit window if the image need to be enlarged. It implies \-f and is like typing 'M' with every image.
  38 .TP
  39 \fB\-m, \-\-make\-fit\fR
  40 Make the image fit the window (default=off). Make the image fit the window wathever the image size, this is the equivalent of \-l and \-M. It is like typing 'm' with every image.
  41 .TP
  42 \fB\-z, \-\-zoom\-pointer\fR
  43 Zoom centered on pointer (default=off). By default the zoom is centered on the window center, with this option, it is on the mouse pointer.
  44 .TP
  45 \fB\-t, \-\-dither\fR
  46 Enable dithering (default=off). Use this option if you are on a low colors display, that is with a depth of 8 or 16 bits, and the image quality does not satisfy you.
  47 .br
  48 Note that it makes loading slower.
  49 .TP
  50 \fB\-F, \-\-force\-load\fR
  51 Try to load every file (default=off). When loading a file, the loader is chosen according to the filename extension in order to optimize the loading time. If the extension is unknown, the file is ignored, with this option \fIgliv\fR will always try to load the file.
  52 .TP
  53 \fB\-p, \-\-mipmap\fR
  54 Build mipmaps (default=off). Mipmaps are good on a not so fast graphics board, to speed up drawing large images zoomed out. On the other hand, it makes loading slower.
  55 .TP
  56 \fB\-e, \-\-build\-menus\fR
  57 Build images menu at startup (default=off). Disabling the images menus creation at startup makes it faster, especially with many files on the command line.
  58 .TP
  59 \fB\-n, \-\-mnemonics\fR
  60 Make mnemonics for images menus (default=off). When this option is disabled the images menus are built much more quickly.
  61 .TP
  62 \fB\-w, \-\-slide\-show\fR
  63 Start the slide show immediately (default=off). This way you will not have to start the slide show from the menu.
  64 .TP
  65 \fB\-L, \-\-loop\fR
  66 Make the slide show loop at the end (default=off). When the last image is displayed, asking for the next one will show the first one.
  67 .TP
  68 \fB\-b, \-\-menu\fR
  69 Display the menu bar (default=on). Use it to display the currently minimal menubar, you can also use the 'b' key.
  70 .TP
  71 \fB\-i, \-\-info\fR
  72 Show infos about displayed image (default=on). With this option, \fIgliv\fR will by default print the info line you can obtain by typing 'i'.
  73 .TP
  74 \fB\-o, \-\-scrollbars\fR
  75 Display scrollbars (default=on). Enable or disable the scrollbars on the borders.
  76 .TP
  77 \fB\-g, \-\-glivrc\fR
  78 Load ~/.glivrc (default=on). Specify it once to disable loading of the rc file. It can be used to make finding which argument to put on the command line easier.
  79 .TP
  80 \fB\-c, \-\-alpha\-checks\fR
  81 Alpha checks in the background (default=on). Use it to have a checker background when the image has an alpha channel. This may cause slowdown when redrawing images with an alpha channel. You can also use the 'a' key.
  82 .TP
  83 \fB\-dINT, \-\-delay=INT\fR
  84 Delay before hiding the cursor. If you use this option with a strictly positive number t as argument, \fIgliv\fR will wait for t milliseconds of mouse inactivity and then hide the cursor. It reappears when you move the mouse.
  85 .TP
  86 \fB\-uINT, \-\-history=INT\fR
  87 Length of history. The maximum number of items in the history. Use 0 to disable the history, and \-1 to make it unlimited.
  88 The default is 1000 but the suggested value is \-1, because the size of an item is 44 bytes (on a 32 bits system) which won't fill your memory.
  89 .TP
  90 \fB\-aINT, \-\-duration=INT\fR
  91 Delay between each image. This is the minimal time to wait between each image during the slide show. It does not include the time load the image, and is exprimed in seconds.
  92 .SH "CONTROLS"
  93
  94 ESC, q : Quit
  95 .br
  96 f      : Full-screen/window
  97 .br
  98 +/=/-  : Zoom in/in/out
  99 .br
 100 n/p    : Next/previous image
 101 .br
 102 l      : Reduce the image to the window
 103 .br
 104 M      : Maximize the image to the window
 105 .br
 106 m      : Make the image fit the window
 107 .br
 108 r      : Reset position and size
 109 .br
 110 b      : Toggle display of the menu bar
 111 .br
 112 i      : Toggle display of the info bar
 113 .br
 114 s      : Toggle display of the scrollbars
 115 .br
 116 a      : Toggle display of the alpha checks
 117 .br
 118 h      : Toggle display of the help box
 119 .br
 120 o      : Display the open dialog
 121 .br
 122 t      : Display the options dialog
 123 .br
 124 d      : Hide the cursor
 125 .br
 126 u      : Undo
 127 .br
 128 y      : Redo
 129 .br
 130 c      : Clear the history
 131 .br
 132 x      : Delete the current file
 133 .br
 134 C-up   : Rotate by +45 degrees
 135 .br
 136 C-down : Rotate by -45 degrees
 137 .br
 138 C-left : Rotate by +0.1 degree
 139 .br
 140 C-right: Rotate by -0.1 degree
 141 .br
 142 z      : Horizontal flip
 143 .br
 144 e      : Vertical flip
 145 .br
 146
 147 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.
 148 .br
 149
 150 Your mouse wheel (if supported) will zoom the image and switch it when you press the button.
 151 .br
 152
 153 You can also zoom by dragging the mouse vertically while holding Shift and the first button.
 154 .br
 155
 156 Space and Backspace act like n and p.
 157 .br
 158
 159 Draw a rectangle with the third button and gliv will zoom in it.
 160 .br
 161
 162 .SH "FILE"
 163 \fB~/.glivrc\fR \- This file is absolutely not mandatory.
 164 .SH "AUTHOR"
 165 Guillaume Chazarain <gfc@altern.org>
 166 .br
 167 See http://gliv.tuxfamily.org.