gliv(1)

NAME
gliv - An OpenGL Image Viewer

SYNOPSIS
gliv [OPTIONS]... [FILES]...

DESCRIPTION
gliv uses gdk-pixbuf to load images and OpenGL to render them. It allows to do some moving, rotating, zooming and slideshow.

OPTIONS
The options are first set to their default value, then read from ~/.glivrc and finally read from the command line.
To disable an option activated by default just specify it, in order to toggle its value.

-h, --help
    Print help and exit.

-V, --version
    Print version and exit.

-f, --fullscreen
    Start in full screen mode (default=off). You can still go back to windowed mode by pressing 'f' or using the menu.

-s, --shuffle
    Show images in random order (default=off). Switching images will preserve the order but you cannot go back to normal order.

-R, --recursive
    Processe directories recursively (default=off). If you specify a directory in the command line gliv will open every image in this directory and its subdirectories.

-l, --scale-down
    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.

-M, --maximize
    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.

-m, --make-fit
    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.

-z, --zoom-pointer
    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.

-t, --dither
    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.
    Note that it makes loading slower.

-F, --force-load
    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 gliv will always try to load the file.

-b, --menu
    Display the menu bar (default=on). Use it to display the currently minimal menubar, you can also use the 'b' key.

-i, --info
    Show infos about displayed image (default=on). With this option, gliv will by default print the info line you can obtain by typing 'i'.

-o, --scrollbars
    Display scrollbars (default=on). Enable or disable the scrollbars on the borders.

-g, --glivrc
    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.

-c, --alpha-checks
    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.

-e, --build-menus
    Build images menu at startup (default=on). Disabling the images menus creation at startup makes it faster, especially with many files on the command line.

-dINT, --delay=INT
    Delay before hiding the cursor. If you use this option with a strictly positive number t as argument, gliv will wait for t milliseconds of mouse inactivity and then hide the cursor. It reappears when you move the mouse or exit gliv.

-uINT, --history=INT
    Length of history. The maximum number of items in the history. Use 0 to disable the history, and -1 to make it unlimited. The default is 1000 but the suggested value is -1, because the size of an item is 76 bytes (on a 32 bits system) which won't fill your memory.

CONTROLS
ESC, q : Quit.
f : Full-screen/window.
+/=/- : zoom in/in/out.
n/p : Next/Previous image.
l : reduce the image to the window.
M : Maximize the image to the window.
m : Make the image fit the window.
r : Reset position and size.
b : toggle display of the menuBar.
i : toggle display of the Info bar.
s : toggle display of the Scrollbars.
h : toggle display of the Help box.
o : display the Open dialog.
t : display the opTions dialog.
d : hiDe the curosr.
u : Undo.
y : redo.
c : Clear the history.
C-up : Rotate by +45 degrees.
C-down : Rotate by -45 degrees.
C-left : Rotate by +0.1 degree.
C-right : Rotate by -0.1 degree.
z : horiZontal flip.
e : vErtical flip.
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.
Your mouse wheel (if supported) will zoom the image and switch it when you press the button.
You can also zoom by dragging the mouse vertically while holding Shift and the first button.
Space and Backspace act like n and p.
Draw a rectangle with the third button and gliv will zoom in it.

FILE
~/.glivrc - This file is absolutely not mandatory.

AUTHOR
Guillaume Chazarain <gfc@altern.org>
See http://gliv.tuxfamily.org.