Introduction

Glview is a image viewer for large collections of images, allowing seamless panning and zooming over images.

Demo video

(or download the high-res AVI video)

Download

Latest version is glview-20100710.tgz

README

Introduction
============

Glview is an image viewer using OpenGL to allow seamless panning and zooming
over a lot if pictures. Textures are rescaled on the fly when zooming in and
out.

Glview is known to compile and run on GNU/Linux and Mac OS X.

Compilation
===========

Glview requires at least the following libs and their header files:

- OpengL
- SDL
- Glut
- Imlib2

Glview uses the optional 'extract' tool to gather info about images.

Make sure all above dependencies are met, and compile by running 'make'


Installation
============

Copy the resulting binary somewhere into your path or run from the local
directory as ./glview


Usage
=====

usage: glview [options] 

available options:
  -f         Start fullscreen
  -h         Show help
  -p N       Use N parallel loader processes (2)
  -r         Recursively find all images from the given path
  -V         Show version

For example, to browse all images found in the directory ~/pics and all of its
subdirectories, run

   glview -r ~/pics


Mouse controls:

 - left mouse click: zoom in to clicked image
 - right mouse click: zoom out to show all images
 - left mouse drag: pan
 - right mouse drag: zoom in/out
 - mouse wheel: prev/next image

Keyboard controls:

 - + / -: zoom in / zoom out
 - p: previous image
 - n: next image
 - arrow keys: move around 1 image
 - f: toggle fullscreen
 - i: show info about selected image
 - l: switch layout between grid / hilbert mapping


Notes
=====

* Glview makes good use of multiple CPU's by forking multiple child processes to
  do the image decodeing. By default two loader processes are started, this
  number can be configured with the '-p' flag.

* Glview caches quite heavily to disk, temporary files are stored into the directory
  .glview in the users home directory. 

* Performance depends greatly on the video hardware available. The developer
  has good results browsing up to 4000 imgages using a Nvidia Quadro NVS 140M
  on a Intel Core2 Duo notebook.


Todo / whishlist
================

* Use texture compression to reduce cache size and video memory usage

* Add PDF/Postscript reader backend


Copyright
=========

Copyright (c) 2008 Ico Doornekamp 

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.

CHANGELOG

2009-01-18	new - Implemented cache cleanup
		fix - cache also depends on file inode, mtime and size