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
Michele Calgaro f71f7a065a
Removed explicit usage of the 'register' keyword.
4 years ago
admin@68f23556e6 Reset submodule main/applications/ksquirrel/admin to latest HEAD 5 years ago
cmake@8668335711 Reset submodule main/applications/ksquirrel/cmake to latest HEAD 4 years ago
doc Fix invalid headers in PNG files and optimize for size 8 years ago
ksquirrel Removed explicit usage of the 'register' keyword. 4 years ago
pics Fix invalid headers in PNG files and optimize for size 8 years ago
po Translated using Weblate (Russian) 4 years ago
.gitmodules Switch all submodules to https. 4 years ago
AUTHORS Added KDE3 version of ksquirrel photo manager 14 years ago
CMakeL10n.txt Add CMakeL10n rules. 5 years ago
COPYING Added KDE3 version of ksquirrel photo manager 14 years ago
ChangeLog Fix a few remaining references to kio_ 11 years ago
Doxyfile Additional renaming of kde to tde 13 years ago
INSTALL Additional renaming of kde to tde 13 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 Additional renaming of kde to tde 13 years ago
Makefile.dist Added KDE3 version of ksquirrel photo manager 14 years ago
README Fix a few remaining references to kio_ 11 years ago
TODO Added KDE3 version of ksquirrel photo manager 14 years ago
acinclude.m4 Replaced _BSD_SOURCE, _SVID_SOURCE with _DEFAULT_SOURCE. Removed AC_CHECK_GNU_EXTENSIONS. 6 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.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 KDE_USE_QT* -> KDE_USE_TQT* conversion 6 years ago
configure.in.bot Added KDE3 version of ksquirrel photo manager 14 years ago
configure.in.in Add automake support for --enable-gcc-hidden-visibility. 12 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 LIB_QT -> LIB_TQT conversion to align to updated admin module 6 years ago
ksquirrel.kdevses 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 tdeio_rar
* To let KSquirrel unpack 7Z  archives please install tdeio_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