++==============++
|| Image Viewer ||
++==============++

Disclaimer
==========
How you decide to use this application is up to you and I will take no reponsibility for
your actions.


Description:
============
Image Viwer is application written in Java (J2SE) language. It is meant to be used for
image viewing.

I decided to code my own image viewing application beacause I'm dissatisfied
with Gwenview that has very slow image rendering and moreover it often doesn't work on my
system (Arch Linux) after major upgrades due to libraries incompatibility (which is not
fault of Gwenview but of Arch Linux packages maintainers). The goal to be faster (opening,
image rendering) was accomplished. I personally will use this program so there is pretty
high chance of further program improvemnents.

Program has these functions - image viewing (next, previous, firt, last image), open image,
fullscreen. If you think it's not enough functions of tool of that kind you may be right.
But I've never used any other function with Gwenview, so I find it useless (for me) to
implement then in my program. To be honest I sometimes used zoom in/out function so these may
be implemented in next version of this tool.

Application supports common image formats (jpg, png, gif).


Running
===========
Go to the bin/ folder and ran application jar file via command
$ java -jar ImageViewer.jar

But better way in my opinion is to make simple script like this:

file:ImageViewer
----------------------------------------
#/bin/bash

java -jar /path/to/app/ImageViewer.jar $@

----------------------------------------

Then put it in directory within $PATH and you can the run program via

$ ImageViewer my_photo.jpg


Usage:
======
Program can be controled via several keys

Right arrow, Space - next image
Left arrow         - previous image
Home               - first image
End                - last image
F                  - enable/disable fullscreen
Ctrl+O             - open image


License:
========
This heap of bytes is released under GNU GPL license

Author:
=======
Stoyan, 2009