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.
Heimen Stoffels cca8e07b91 Translated using Weblate (Dutch) 1 week ago
admin @ 68f23556e6 Reset submodule main/applications/ksquirrel/admin to latest HEAD 7 months ago
cmake @ 5121b9a41d Reset submodule main/applications/ksquirrel/cmake to latest HEAD 3 months ago
doc Fix invalid headers in PNG files and optimize for size 3 years ago
ksquirrel Adjusted to new normalized device icon names in tdelibs. 2 months ago
pics Fix invalid headers in PNG files and optimize for size 3 years ago
po Translated using Weblate (Dutch) 1 week ago
.gitmodules Added common directories 7 years ago
AUTHORS Added KDE3 version of ksquirrel photo manager 9 years ago
CMakeL10n.txt Add CMakeL10n rules. 8 months ago
COPYING Added KDE3 version of ksquirrel photo manager 9 years ago
ChangeLog Fix a few remaining references to kio_ 6 years ago
Doxyfile Additional renaming of kde to tde 7 years ago
INSTALL Additional renaming of kde to tde 7 years ago
LICENSE Fixed images 9 years ago
LICENSE.GFDL Added KDE3 version of ksquirrel photo manager 9 years ago
LICENSE.LGPL Added KDE3 version of ksquirrel photo manager 9 years ago
Makefile.am Additional renaming of kde to tde 7 years ago
Makefile.dist Added KDE3 version of ksquirrel photo manager 9 years ago
README Fix a few remaining references to kio_ 6 years ago
TODO Added KDE3 version of ksquirrel photo manager 9 years ago
acinclude.m4 Replaced _BSD_SOURCE, _SVID_SOURCE with _DEFAULT_SOURCE. Removed AC_CHECK_GNU_EXTENSIONS. 11 months ago
aclocal.m4 Added KDE3 version of ksquirrel photo manager 9 years ago
builddeb Convert remaining references to kde3 (e.g. in paths) to trinity 8 years ago
config.guess Added KDE3 version of ksquirrel photo manager 9 years ago
config.h.in Added KDE3 version of ksquirrel photo manager 9 years ago
config.sub Added KDE3 version of ksquirrel photo manager 9 years ago
configure.files Added KDE3 version of ksquirrel photo manager 9 years ago
configure.gnu Added KDE3 version of ksquirrel photo manager 9 years ago
configure.in KDE_USE_QT* -> KDE_USE_TQT* conversion 11 months ago
configure.in.bot Added KDE3 version of ksquirrel photo manager 9 years ago
configure.in.in Add automake support for --enable-gcc-hidden-visibility. 6 years ago
control Added KDE3 version of ksquirrel photo manager 9 years ago
description-pak Added KDE3 version of ksquirrel photo manager 9 years ago
fmt_filters_README Added KDE3 version of ksquirrel photo manager 9 years ago
ksquirrel.kdevprj LIB_QT -> LIB_TQT conversion to align to updated admin module 1 year ago
ksquirrel.kdevses Added KDE3 version of ksquirrel photo manager 9 years ago
reconfigure Added KDE3 version of ksquirrel photo manager 9 years ago
required-etch Added KDE3 version of ksquirrel photo manager 9 years ago
stamp-h.in Added KDE3 version of ksquirrel photo manager 9 years ago
start Added KDE3 version of ksquirrel photo manager 9 years ago
subdirs Added KDE3 version of ksquirrel photo manager 9 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