Added KDE3 version of ksquirrel photo manager

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/ksquirrel@1094446 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 157 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..a7635e0
--- /dev/null
+++ b/README
@@ -0,0 +1,157 @@
+KSquirrel is a new image viewer for KDE, simple and convenient in usage.
+
+While all others use another's decoders, in KSquirrel image decoding is based on own decoders
+(ksquirrel-libs) which format is very simple. If support of certain format FMT is necessary
+for you, you can write the decoder for KSquirrel, compile and copy it in /usr/lib/ksquirrel-libs.
+At desire you can use ksquirrel-libs in other image viewer. Since 0.6.0 ksquireel-libs has
+documentation and simple examples.
+
+Due to usage OpenGL show and a manipulation the image is characterized by extreme speed :).
+Also in the program customized filters, external programs, tree, thumbnails,
+extended thumbnails with the information on the image, flexible options, KIPI support,
+archives support are available.
+
+Here is some history :)
+In November 2003, testing long time other programs on my collection of images,
+I've found an awful thing - any of programs could not show ALL images.
+There was no support 32-bit BMP, TGA, animated GIF, PSD, etc. Any of them does not use the
+most advanced libraries for decoding images, and use either imlib, or QImage::load().
+Having become dissapointed, I've decided to write the image viewer with the flexible
+architecture. Birthday for KSquirrel - on December 10, 2003. 
+
+KSquirrel is the first viewer for KDE widely supporting such a quantity of image formats,
+including Photoshop PSD, X cursors, animated GIF, FLI Animation, WMF, SVG, TTF, APNG, MNG ...
+
+The detailed information, format of libraries with examples and screenshots you can find
+visiting page http://ksquirrel.sourceforge.net/
+
+***********************************************************************************
+
+Notes
+-----
+
+* OpenGL drivers are required to run KSquirrel successfully
+* To let KSquirrel unpack RAR archives please install kio_rar
+* To let KSquirrel unpack 7Z  archives please install kio_p7zip
+
+***********************************************************************************
+
+Copyrights
+----------
+
+see COPYING
+
+***********************************************************************************
+
+Keyboard shortcuts
+------------------
+
+Image window understands many hotkeys. You can invoke help window with either pressing
+"/" in image window, or selecting "Hotkeys" from context menu.
+
+***********************************************************************************
+
+Slideshow
+---------
+
+Use the following keys in slideshow:
+
+     *  Return, Escape  = stop slideshow
+     *  Pause, Space    = pause/unpause slideshow
+     *  Page Up         = previous image
+     *  Page Down       = next image
+     *  M               = enable/disable onscreen messages
+
+***********************************************************************************
+
+DCOP interface
+--------------
+
+Since 0.6.0-pre5 you can use DCOP interface to manipulate KSquirrel. Just run
+
+# dcop ksquirrel ksquirrel control <param>
+
+Here is a list of avaliable parameters:
+
+----------------------------------------------------------------------------
+
+Parameter                     Action                    Comments
+----------------------------------------------------------------------------
+image_animation_toggle        toggle animation          wrapper for A
+image_delete                  delete image              wrapper for Delete
+image_first                   first image               wrapper for Home
+image_last                    last image                wrapper for End
+image_next                    next image                wrapper for PageDown
+image_previous                previous image            wrapper for PageUp
+image_information             image information         wrapper for I
+image_page_first              first page                wrapper for F1
+image_page_last               last page                 wrapper for F4
+image_page_next               next page                 wrapper for F3
+image_page_previous           previous page             wrapper for F2
+image_reset                   reset                     wrapper for R
+image_window_close            close image window        wrapper for X
+image_window_fullscreen       toggle fullscreen mode    wrapper for F
+image_window_help             help                      wrapper for /
+image_window_quickbrowser     toggle quickbrowser       wrapper for Q
+zoom_1                        zoom 100%                 wrapper for 1
+zoom_2                        zoom 200%                 wrapper for 2
+zoom_3                        zoom 300%                 wrapper for 3
+zoom_4                        zoom 400%                 wrapper for 4
+zoom_5                        zoom 500%                 wrapper for 5
+zoom_6                        zoom 600%                 wrapper for 6
+zoom_7                        zoom 700%                 wrapper for 7
+zoom_8                        zoom 800%                 wrapper for 8
+zoom_9                        zoom 900%                 wrapper for 9
+zoom_10                       zoom 1000%                wrapper for 0
+zoom_minus                    zoom minus                wrapper for -
+zoom_plus                     zoom plus                 wrapper for +
+
+New parameters since 0.6.0-pre8:
+--------------------------------
+
+- load specified image/directory
+# dcop ksquirrel ksquirrel load <path_to_file_or_directory>
+
+- activate window
+# dcop ksquirrel ksquirrel activate
+
+----------------------------------------------------------------------------
+
+New parameters since 0.7.0:
+--------------------------------
+
+- go to the next file in file manager
+# dcop ksquirrel ksquirrel navigator next
+
+- go to the previous file in file manager
+# dcop ksquirrel ksquirrel navigator previous
+
+- execute current file in file manager (as if user pressed Enter)
+# dcop ksquirrel ksquirrel navigator execute
+
+- activate image window
+# dcop ksquirrel ksquirrel activate_image_window
+
+
+----------------------------------------------------------------------------
+
+Examples
+--------
+
+* let's zoom currently loaded image:
+[me@localhost /]$ dcop ksquirrel ksquirrel control zoom_plus
+
+* let's load next image in current directory:
+[me@localhost /]$ dcop ksquirrel ksquirrel control image_next
+
+***********************************************************************************
+
+Since 0.6.0-pre1 KSquirrel has edit tools:
+- convert tool
+
+Since 0.6.0-pre7 KSquirrel has additional edit tools:
+- filter tool with many filters
+
+***********************************************************************************
+
+See ChangeLog for more