KSquirrel – powerful image viewer
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Slávek Banko ec4f4e8fff
Update final HTML install path so all modules are consistent.
12 years ago
admin@dcb06c9359 Update final HTML install path so all modules are consistent. 12 years ago
cmake@43ef41ffd6 Update final HTML install path so all modules are consistent. 12 years ago
doc Fixed images 14 years ago
ksquirrel Fix FTBFS 12 years ago
pics Fixed images 14 years ago
po Added KDE3 version of ksquirrel photo manager 14 years ago
.gitmodules Add common directories 12 years ago
AUTHORS Added KDE3 version of ksquirrel photo manager 14 years ago
COPYING Added KDE3 version of ksquirrel photo manager 14 years ago
ChangeLog Added KDE3 version of ksquirrel photo manager 14 years ago
Doxyfile Added KDE3 version of ksquirrel photo manager 14 years ago
INSTALL Added KDE3 version of ksquirrel photo manager 14 years ago
LICENSE Fixed images 14 years ago
LICENSE.GFDL Added KDE3 version of ksquirrel photo manager 14 years ago
LICENSE.LGPL Added KDE3 version of ksquirrel photo manager 14 years ago
Makefile.am Added KDE3 version of ksquirrel photo manager 14 years ago
Makefile.dist Added KDE3 version of ksquirrel photo manager 14 years ago
README Added KDE3 version of ksquirrel photo manager 14 years ago
TODO Added KDE3 version of ksquirrel photo manager 14 years ago
acinclude.m4 Update HTML install path references. 12 years ago
aclocal.m4 Added KDE3 version of ksquirrel photo manager 14 years ago
builddeb Convert remaining references to kde3 (e.g. in paths) to trinity 13 years ago
config.guess Added KDE3 version of ksquirrel photo manager 14 years ago
config.h.in Added KDE3 version of ksquirrel photo manager 14 years ago
config.log Convert remaining references to kde3 (e.g. in paths) to trinity 13 years ago
config.sub Added KDE3 version of ksquirrel photo manager 14 years ago
configure.files Added KDE3 version of ksquirrel photo manager 14 years ago
configure.gnu Added KDE3 version of ksquirrel photo manager 14 years ago
configure.in Added KDE3 version of ksquirrel photo manager 14 years ago
configure.in.bot Added KDE3 version of ksquirrel photo manager 14 years ago
configure.in.in Automake fixes 14 years ago
control Added KDE3 version of ksquirrel photo manager 14 years ago
description-pak Added KDE3 version of ksquirrel photo manager 14 years ago
fmt_filters_README Added KDE3 version of ksquirrel photo manager 14 years ago
ksquirrel.kdevprj Added KDE3 version of ksquirrel photo manager 14 years ago
ksquirrel.kdevses Added KDE3 version of ksquirrel photo manager 14 years ago
ksquirrel.lsm Added KDE3 version of ksquirrel photo manager 14 years ago
reconfigure Added KDE3 version of ksquirrel photo manager 14 years ago
required-etch Added KDE3 version of ksquirrel photo manager 14 years ago
stamp-h.in Added KDE3 version of ksquirrel photo manager 14 years ago
start Added KDE3 version of ksquirrel photo manager 14 years ago
subdirs Added KDE3 version of ksquirrel photo manager 14 years ago

README

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