From 6afd9d8dddbe9e450690e05d498a503c00333a5e Mon Sep 17 00:00:00 2001 From: tpearson Date: Mon, 22 Feb 2010 19:31:25 +0000 Subject: 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 --- doc/Makefile.am | 7 +++ doc/ksquirrel.1 | 68 +++++++++++++++++++++ doc/ru/Makefile.am | 2 + doc/ru/credits.docbook | 30 +++++++++ doc/ru/imagewindow.docbook | 26 ++++++++ doc/ru/imagewindow.html | 4 ++ doc/ru/index.docbook | 138 ++++++++++++++++++++++++++++++++++++++++++ doc/ru/index.html | 6 ++ doc/ru/install-binary.html | 4 ++ doc/ru/installation.html | 32 ++++++++++ doc/ru/interface-menu.html | 4 ++ doc/ru/interface-sidebar.html | 15 +++++ doc/ru/interface.docbook | 109 +++++++++++++++++++++++++++++++++ doc/ru/interface.html | 10 +++ doc/ru/internals-libs.html | 12 ++++ doc/ru/internals.docbook | 71 ++++++++++++++++++++++ doc/ru/internals.html | 2 + doc/ru/intro.docbook | 39 ++++++++++++ doc/ru/intro.html | 11 ++++ doc/ru/license.html | 7 +++ doc/ru/plugins_info.png | Bin 0 -> 11604 bytes doc/ru/running.docbook | 95 +++++++++++++++++++++++++++++ doc/ru/running.html | 28 +++++++++ doc/ru/sidebar.png | Bin 0 -> 26937 bytes doc/ru/sidebar_basket.png | Bin 0 -> 9929 bytes doc/ru/sidebar_categories.png | Bin 0 -> 11752 bytes doc/ru/sidebar_mounts.png | Bin 0 -> 12669 bytes doc/ru/view_thumbnails.png | Bin 0 -> 68748 bytes 28 files changed, 720 insertions(+) create mode 100644 doc/Makefile.am create mode 100644 doc/ksquirrel.1 create mode 100644 doc/ru/Makefile.am create mode 100644 doc/ru/credits.docbook create mode 100644 doc/ru/imagewindow.docbook create mode 100644 doc/ru/imagewindow.html create mode 100644 doc/ru/index.docbook create mode 100644 doc/ru/index.html create mode 100644 doc/ru/install-binary.html create mode 100644 doc/ru/installation.html create mode 100644 doc/ru/interface-menu.html create mode 100644 doc/ru/interface-sidebar.html create mode 100644 doc/ru/interface.docbook create mode 100644 doc/ru/interface.html create mode 100644 doc/ru/internals-libs.html create mode 100644 doc/ru/internals.docbook create mode 100644 doc/ru/internals.html create mode 100644 doc/ru/intro.docbook create mode 100644 doc/ru/intro.html create mode 100644 doc/ru/license.html create mode 100644 doc/ru/plugins_info.png create mode 100644 doc/ru/running.docbook create mode 100644 doc/ru/running.html create mode 100644 doc/ru/sidebar.png create mode 100644 doc/ru/sidebar_basket.png create mode 100644 doc/ru/sidebar_categories.png create mode 100644 doc/ru/sidebar_mounts.png create mode 100644 doc/ru/view_thumbnails.png (limited to 'doc') diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..b527d71 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,7 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +####### kdevelop will overwrite this part!!! (end)############ +SUBDIRS = ru + +man_MANS = ksquirrel.1 diff --git a/doc/ksquirrel.1 b/doc/ksquirrel.1 new file mode 100644 index 0000000..d8e3a60 --- /dev/null +++ b/doc/ksquirrel.1 @@ -0,0 +1,68 @@ +.TH KSQUIRREL 1 "September 2005" "K Desktop Environment" "Image viewer for KDE" +.SH NAME +KSquirrel \- An image viewer for KDE with dynamic format support +.SH SYNOPSIS +.B ksquirrel +[\fIoptions\fR] [\fIfile\fR] +.SH DESCRIPTION +KSquirrel is an image viewer for KDE with disk navigator, file tree, thumbnails, extended thumbnails, dynamic format support, DCOP interface and KIPI plugins support. +.PP +Image loading is based on external codecs \- ksquirrel\-libs. It supports dozens of various image formats, including SVG, WMF, JPEG2000, APNG and PSD. +.SH OPTIONS +.SS Arguments: +.TP +.B file +An initial image file or folder. +.SS KSquirrel options: +.TP +.B \-l +Show found image codecs and exit. +.TP +.B \-d +Print available DCOP parameters. +.TP +.B \--nodirectorybasket +Don't create directory basket +.TP +.B \--noimagebasket +Don't create image basket +.TP +.B \--nocategories +Don't create categories +.TP +.B \--nomountview +Don't create mount view + +.SS Generic options: +.TP +.B \-\-help +Show help about options. +.TP +.B \-\-help\-qt +Show Qt specific options. +.TP +.B \-\-help\-kde +Show KDE specific options. +.TP +.B \-\-help\-all +Show all options. +.TP +.B \-\-author +Show author information. +.TP +.B \-v\fR, \fB\-\-version +Show version information. +.TP +.B \-\-license +Show license information. +.TP +.B \-\- +End of options. +.SH "SEE ALSO" +The KSquirrel homepage can be found at \fIhttp://ksquirrel.sourceforge.net\fR. +.SH BUGS +To report a bug, please send a e\-mail to \fIksquirrel.iv@gmail.com\fR. +.SH AUTHOR +KSquirrel and ksquirrel-libs were written by Dmitry Baryshev . +.PP +This manual page was written by Dmitry Baryshev . diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am new file mode 100644 index 0000000..33fec9f --- /dev/null +++ b/doc/ru/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = ru +KDE_DOCS = ksquirrel diff --git a/doc/ru/credits.docbook b/doc/ru/credits.docbook new file mode 100644 index 0000000..4bfe1f8 --- /dev/null +++ b/doc/ru/credits.docbook @@ -0,0 +1,30 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Лицензия, авторские права и благодарности + + +&kappname; и &klibname; разработаны и сопровождаются © 2003-2007 Барышевым Дмитрием Алексеевичем. Русская версия данного документа создана © 2006 Барышевым Дмитрием Алексеевичем. Вы можете связаться со мной по электронному адресу ksquirrel.iv@gmail.com. + + + +Лицензирование &kappname; +Лицензирование &klibname; +Лицензирование этого документа + +&underGPL; +GNU LIBRARY GENERAL PUBLIC LICENSE v.2 +&underFDL; + + + + diff --git a/doc/ru/imagewindow.docbook b/doc/ru/imagewindow.docbook new file mode 100644 index 0000000..8eff182 --- /dev/null +++ b/doc/ru/imagewindow.docbook @@ -0,0 +1,26 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Окно просмотра изображения + + +Общее описание + +В окне просмотра изображения вы можете видеть открытую в данный момент картинку. Данное окно имеет панель инструментов с необходимыми Вам действиями для управления картинкой - масштабирование, поворот, сдвиг, и окном непосредственно - перейти в полноэкранный режим и др. Также в окне просмотра изображения имеется строка статуса, в которой отображается некоторая полезная информация, как то: размеры изображения, фактор масштабирования, имя файла и др. По правой кнопке мыши Вы можете вызвать контекстное меню. + + +В окне просмотра изображения действует множество сочетаний клавиш. Чтобы просмотреть, какие клавиши какие функции выполняют, достаточно выбрать Горячие клавиши из контекстного меню. Можно лишь упомянуть, что задействованы многие общепринятые сочетания, такие как PageUp, PageDown, +/-, Space, BackSpace. + + + + + diff --git a/doc/ru/imagewindow.html b/doc/ru/imagewindow.html new file mode 100644 index 0000000..42d8592 --- /dev/null +++ b/doc/ru/imagewindow.html @@ -0,0 +1,4 @@ +Глава 4. Окно просмотра изображения
Окно просмотра изображения
Пред.
След.
 

Глава 4. Окно просмотра изображения

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

Общее описание

В окне просмотра изображения вы можете видеть открытую в данный момент картинку. Данное окно имеет панель инструментов с необходимыми Вам действиями для управления картинкой - масштабирование, поворот, сдвиг, и окном непосредственно - перейти в полноэкранный режим и др. Также в окне просмотра изображения имеется строка статуса, в которой отображается некоторая полезная информация, как то: размеры изображения, фактор масштабирования, имя файла и др. По правой кнопке мыши Вы можете вызвать контекстное меню.

+В окне просмотра изображения действует множество сочетаний клавиш. Чтобы просмотреть, какие клавиши какие функции выполняют, достаточно выбрать «Горячие клавиши» из контекстного меню. Можно лишь упомянуть, что задействованы многие общепринятые сочетания, такие как PageUp, PageDown, +/-, Space, BackSpace. +

Пред.
След.
Начало
Меню 
 Запуск KSquirrel из командной строки
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/index.docbook b/doc/ru/index.docbook new file mode 100644 index 0000000..b7810f0 --- /dev/null +++ b/doc/ru/index.docbook @@ -0,0 +1,138 @@ + + + + Дмитрий Алексеевич Барышев"> + ksquirrel.iv@gmail.com"> + + + + + + + + + +]> + + +&kappname; Руководство Пользователя + + + + +ДмитрийБарышевАлексеевич +
ksquirrel.iv@gmail.com
 + + + + + + +2003-2007 +&Dmitry.Baryshev; + + +&FDLNotice; + +2007-03-10 +0.3.0 + +&kappname; это просмотрщик изображений для KDE реализующий OpenGL и поддерживающий модули KIPI. + + +KDE +image +viewer +picture + + +&intro; +&internals; +&interface; +&imagewindow; +&running; +&credits; + + +Инсталляция + + +Установка из исходников + + +&kappname; из исходников устанавливается как обычно, за исключением некоторых моментов. Для успешной компиляции &kappname; Вам необходимо установить пакет kde-devel, и в системах типа Mandriva дополнительно kdebase-devel. Рассмотрим все шаги инсталляции подробнее. + + + +Установка &klibname; + + +Сперва необходимо установить &klibname;. + + +tar jxfv ksquirrel-libs-0.7.0.tar.bz2 +./configure.gnu +make +su -c make install + + + + + +Пояснения. + + +configure.gnu это просто обёртка вокруг configure - это обычный shell-скрипт, который вызывает configure с установленным префиксом. +Вместо configure.gnu Вы можете спокойно использовать + +./configure --prefix=/usr + + + + + + + +Установка &kappname; + + +Теперь установим &kappname; + + +tar jxfv ksquirrel-0.7.0.tar.bz2 +./configure.gnu +make +su -c make install + + + + + +Пояснения. + + +configure.gnu это просто обёртка вокруг configure - это обычный shell-скрипт, который вызывает configure с установленным префиксом и отключённой поддержкой arts. +Вместо configure.gnu Вы можете спокойно использовать + +./configure --prefix="`kde-config --prefix`" --without-arts + + + + + + + + +Установка из бинарных пакетов + +Чтобы установить &kappname; и &klibname; из бинарных пакетов, вы должны сперва проверить, нет ли их на предложенных Вам дисках Вашего дистрибутива. Если они нашлись, установите их стандартными средствами Вашего дистрибутива (например, apt-get в Debian, или urpmi в Mandriva). Если на дисках их не оказалось, попробуйте поискать в онлайн репозитариях Вашего дистрибутива, а также в http://google.com и http://ksquirrel.sourceforge.net/download.php. + + + + + + + + diff --git a/doc/ru/index.html b/doc/ru/index.html new file mode 100644 index 0000000..e8db2e3 --- /dev/null +++ b/doc/ru/index.html @@ -0,0 +1,6 @@ +KSquirrel Руководство Пользователя
KSquirrel Руководство Пользователя
След.
 

KSquirrel Руководство Пользователя

Дмитрий Алексеевич Барышев

Издание 0.3.0 (2007-03-10)

Copyright © 2003-2007 Дмитрий
 Алексеевич
 Барышев

Разрешается копировать, распространять и/или изменять этот +документ на условиях лицензии GNU для свободной документации, +версии 1.1 или более поздней, опубликованной Фондом Free Software +Foundation; без неизменямых разделов, без текста на первой странице, +без текста на последней странице. Копия лицензии находится здесь the section entitled "GNU Free Documentation License".

KSquirrel это просмотрщик изображений для KDE реализующий OpenGL и поддерживающий модули KIPI.

Содержание

1. Вступление
Что такое KSquirrel
2. Отличие KSquirrel от других просмотрщиков. Свои библиотеки.
Использование OpenGL.
Свои библиотеки
Работа KSquirrel с библиотеками
3. Интерфейс
Навигатор
Боковая панель
Меню
4. Окно просмотра изображения
Общее описание
5. Запуск KSquirrel из командной строки
Аргументы командной строки для KSquirrel и ksquirrel-libs
Аргументы командной строки для KSquirrel
Примеры
6. Лицензия, авторские права и благодарности
A. Инсталляция
Установка из исходников
Установка ksquirrel-libs
Установка KSquirrel
Установка из бинарных пакетов
След.
 
 
 Вступление
 


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/install-binary.html b/doc/ru/install-binary.html new file mode 100644 index 0000000..fd29a8a --- /dev/null +++ b/doc/ru/install-binary.html @@ -0,0 +1,4 @@ +Установка из бинарных пакетов
Установка из бинарных пакетов
Пред.
Инсталляция

Установка из бинарных пакетов

+Чтобы установить KSquirrel и ksquirrel-libs из бинарных пакетов, вы должны сперва проверить, нет ли их на предложенных Вам дисках Вашего дистрибутива. Если они нашлись, установите их стандартными средствами Вашего дистрибутива (например, apt-get в Debian, или urpmi в Mandriva). Если на дисках их не оказалось, попробуйте поискать в онлайн репозитариях Вашего дистрибутива, а также в http://google.com и http://ksquirrel.sourceforge.net/download.php. +

Пред.
Начало
Инсталляция 
 
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/installation.html b/doc/ru/installation.html new file mode 100644 index 0000000..9943728 --- /dev/null +++ b/doc/ru/installation.html @@ -0,0 +1,32 @@ +Приложение A. Инсталляция
Инсталляция
Пред.
След.
 

Приложение A. Инсталляция

Содержание

Установка из исходников
Установка ksquirrel-libs
Установка KSquirrel
Установка из бинарных пакетов

Установка из исходников

+KSquirrel из исходников устанавливается как обычно, за исключением некоторых моментов. Для успешной компиляции KSquirrel Вам необходимо установить пакет kde-devel, и в системах типа Mandriva дополнительно kdebase-devel. Рассмотрим все шаги инсталляции подробнее. +

Установка ksquirrel-libs

+Сперва необходимо установить ksquirrel-libs. + +

  1. tar jxfv ksquirrel-libs-0.7.0.tar.bz2

  2. ./configure.gnu

  3. make

  4. su -c «make install»

+ +

+Пояснения. +

  • +configure.gnu это просто обёртка вокруг configure - это обычный shell-скрипт, который вызывает configure с установленным префиксом. +Вместо configure.gnu Вы можете спокойно использовать + +./configure --prefix=/usr +

+ +

Установка KSquirrel

+Теперь установим KSquirrel + +

  1. tar jxfv ksquirrel-0.7.0.tar.bz2

  2. ./configure.gnu

  3. make

  4. su -c «make install»

+ +

+Пояснения. +

  • +configure.gnu это просто обёртка вокруг configure - это обычный shell-скрипт, который вызывает configure с установленным префиксом и отключённой поддержкой arts. +Вместо configure.gnu Вы можете спокойно использовать + +./configure --prefix="`kde-config --prefix`" --without-arts +

+ +

Пред.
След.
Начало
Лицензия, авторские права и благодарности 
 Установка из бинарных пакетов
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/interface-menu.html b/doc/ru/interface-menu.html new file mode 100644 index 0000000..8c37b27 --- /dev/null +++ b/doc/ru/interface-menu.html @@ -0,0 +1,4 @@ +Меню
Меню
Пред.
След.
Интерфейс

Меню

+Как и почти во всех графических программах, в KSquirrel имеется меню команд. В нём доступны все действия, касающиеся KSquirrel: открытие файла, переход в режим просмотра слайдов, выход из программы, просмотр списка найденных кодеков и др. +

Пред.
След.
Начало
Боковая панель 
 Окно просмотра изображения
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/interface-sidebar.html b/doc/ru/interface-sidebar.html new file mode 100644 index 0000000..80b6ac1 --- /dev/null +++ b/doc/ru/interface-sidebar.html @@ -0,0 +1,15 @@ +Боковая панель
Боковая панель
Пред.
След.
Интерфейс

Боковая панель

+В KSquirrel имеется боковая панель наподобие той, что Вы видели в Konqueror. Листая страницы с помощью мыши Вы можете переключаться на файловое дерево, список подключённых дисковых разделов, панель категорий и корзину изображений. + +

  1. Файловое дерево позволяет просматривать каталоги на диске в виде иерархического дерева. Обычно файловое дерево используется для быстрой навигации по каталогам. Также имеется возможность просматривать количество файлов и подкаталогов в каждом каталоге, выбирать несколько каталогов для просмотра в навигаторе. Файловое дерево представлено на скриншоте. +

    Боковая панель
    +

  2. Вид подключённых дисковых разделов позволяет просмотреть подключенные на данный момент (смонтированные) дисковые разделы. При клике на значок устройства навигатор переходит на заданный раздел. Если устройство не смонтировано, как например CD-ROM, KSquirrel сначала попытается смонтировать данное устройство и затем перейти на него в навигаторе. +

    Боковая панель: точки монтирования
    +

  3. Панель категорий содержит ссылки на файлы, разбитые по категориям. Чтобы добавить новые ссылки в категории, используйте контекстное меню в навигаторе. +

    Боковая панель: категории
    +

  4. Корзина изображений содержит ссылки на изображения, хранящиеся на жёстком диске. Эти ссылки могут быть использованы в модулях KIPI для редактирования реальных изображений. +

    Боковая панель: корзина
    +

+ +

Пред.
След.
Начало
Интерфейс 
 Меню
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/interface.docbook b/doc/ru/interface.docbook new file mode 100644 index 0000000..335919a --- /dev/null +++ b/doc/ru/interface.docbook @@ -0,0 +1,109 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Интерфейс + + +Навигатор + + +&kappname; имеет простой файловый менеджер, который позволяет просматривать каталоги и файлы на Вашем жёстком диске. +Этот файловый менеджер, который мы называем навигатором, может представлять файлы и каталоги несколькими способами: в виде списка, иконок, детального просмотра и просмотра эскизов. + + +Эскизы + + + + +Эскизы + + + +В навигаторе также имеется возможность просматривать содержимое архивов .tar.gz, .tar.bz2, .zip, .rar (если установлен kio_rar), .7z (если установлен kio_p7zip), ходить по сети с помощью smb://, ftp:// и других протоколов, поддерживаемых kio-slaves. + + + + + + +Боковая панель + + +В &kappname; имеется боковая панель наподобие той, что Вы видели в &konqueror;. Листая страницы с помощью мыши Вы можете переключаться на файловое дерево, список подключённых дисковых разделов, панель категорий и корзину изображений. + + + +Файловое дерево позволяет просматривать каталоги на диске в виде иерархического дерева. Обычно файловое дерево используется для быстрой навигации по каталогам. Также имеется возможность просматривать количество файлов и подкаталогов в каждом каталоге, выбирать несколько каталогов для просмотра в навигаторе. Файловое дерево представлено на скриншоте. + +Боковая панель + + + + +Боковая панель + + + + +Вид подключённых дисковых разделов позволяет просмотреть подключенные на данный момент (смонтированные) дисковые разделы. При клике на значок устройства навигатор переходит на заданный раздел. Если устройство не смонтировано, как например CD-ROM, KSquirrel сначала попытается смонтировать данное устройство и затем перейти на него в навигаторе. + +Боковая панель: точки монтирования + + + + +Боковая панель: точки монтирования + + + + +Панель категорий содержит ссылки на файлы, разбитые по категориям. Чтобы добавить новые ссылки в категории, используйте контекстное меню в навигаторе. + +Боковая панель: категории + + + + +Боковая панель: категории + + + + +Корзина изображений содержит ссылки на изображения, хранящиеся на жёстком диске. Эти ссылки могут быть использованы в модулях KIPI для редактирования реальных изображений. + +Боковая панель: корзина + + + + +Боковая панель: корзина + + + + + + + + + + + +Меню + + +Как и почти во всех графических программах, в &kappname; имеется меню команд. В нём доступны все действия, касающиеся &kappname;: открытие файла, переход в режим просмотра слайдов, выход из программы, просмотр списка найденных кодеков и др. + + + + + diff --git a/doc/ru/interface.html b/doc/ru/interface.html new file mode 100644 index 0000000..e5434fb --- /dev/null +++ b/doc/ru/interface.html @@ -0,0 +1,10 @@ +Глава 3. Интерфейс
Интерфейс
Пред.
След.
 

Глава 3. Интерфейс

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

Навигатор

+KSquirrel имеет простой файловый менеджер, который позволяет просматривать каталоги и файлы на Вашем жёстком диске. +Этот файловый менеджер, который мы называем «навигатором», может представлять файлы и каталоги несколькими способами: в виде списка, иконок, детального просмотра и просмотра эскизов. + +

Эскизы
+ +В навигаторе также имеется возможность просматривать содержимое архивов .tar.gz, .tar.bz2, .zip, .rar (если установлен kio_rar), .7z (если установлен kio_p7zip), ходить по сети с помощью smb://, ftp:// и других протоколов, поддерживаемых kio-slaves. + +

Пред.
След.
Начало
Свои библиотеки 
 Боковая панель
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/internals-libs.html b/doc/ru/internals-libs.html new file mode 100644 index 0000000..651df43 --- /dev/null +++ b/doc/ru/internals-libs.html @@ -0,0 +1,12 @@ +Свои библиотеки
Свои библиотеки
Пред.
След.
Отличие KSquirrel от других просмотрщиков. Свои библиотеки.

Свои библиотеки

Почти во всех программах просмотра изображений для декодирования используются сторонние библиотеки. Примером могут служить такие библиотеки как imlib (Image Magic) и Qt. На первый взгляд, преимущества такого способа очевидны - это перекладывание головной боли по декодированию изображений на другие библиотеки, вообще абстрагируясь от низкого уровня работы с изображениями, альфа каналами, битовыми масками, RLE кодированием и прочего. Но у этого способа есть несколько очевидных недостатков. К ним причисляется, во-первых, частичное отсутствие расширяемости набора кодеков изображений. Во-вторых, это зависимость кодеков от больших (а иногда очень больших) библиотек, типа Qt. В-третьих, отсутствие поддержки анимаций, типа GIF, FLI или MNG. В-четвёртых, отсутствие возможности декодирования отдельных строк.

+Исходя из всех этих недостатков, было решено отказаться от помощи сторонних библиотек и разработать собственные библиотеки, которые могли бы не зависеть от других библиотек, кроме стандартных и требуемых самими кодеками (такие, как libsvg, libmng и др.), загружаться динамически, быть полностью расширяемыми, поддерживать декодирование строк и анимацию. Эти библиотеки получили название «ksquirrel-libs». +

+На момент написания данной документации ksquirrel-libs поддерживал 51 формат изображений, включая PNG, JPEG, Photoshop PSD, AutoCAD DXF, WMF, SVG, MNG и GIF. Имеются также кодеки для поддержки файлов шрифтов TTF, анимаций FLI и X-овых курсоров. +

+ksquirrel-libs поддерживает также текстовые поля (комментарии и др.), сохраняемые в некоторых типах изображений. Например, PNG и GIF кодеки способны читать комментарии из данных типов файлов. +

Работа KSquirrel с библиотеками

+Благодаря вышеуказанным свойствам библиотек ksquirrel-libs, KSquirrel приобретает следущие особенности: + +

  1. KSquirrel практически не знает, какой кодек будет использован для декодирования изображения - это определяется динамически.

  2. KSquirrel практически не знает, сколько страниц в декодируемом изображении и является ли оно анимацией - это определяется динамически.

  3. Благодаря поддержке декодирования отдельных строк, KSquirrel показывает изображения прогрессивно, т.е. по мере декодирования.

+

Когда KSquirrel загрузил все найденные библиотеки (используя Qt класс QLibrary), появляется возможность отображать любые поддерживанмые типы изображений (как статичных, так и анимированных). Когда пользователь выбирает изображение в навигаторе, KSquirrel по MIME типу либо расширению файла определяет, поддерживается ли данный формат изображения. Если данный формат поддерживается, то, используя найденную библиотеку, KSquirrel приступает к декодированию изображения и отображению его в окне просмотра.

Информацию о всех найденных кодеках можно просмотеть в диалоге «Информация о плагинах», как показано на скриншоте.

Информация по найденным кодекам

Подсказка: слева от имени кодека может отображаться значёк настроек, как показано на рисунке для кодека GIMP XCF. Это означает, что данный кодек может быть настроен для работы с различными параметрами. Например, для кодека GIMP XCF можно настроить цвет фона для прозрачных изображений.

Пред.
След.
Начало
Отличие KSquirrel от других просмотрщиков. Свои библиотеки. 
 Интерфейс
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/internals.docbook b/doc/ru/internals.docbook new file mode 100644 index 0000000..0e66b22 --- /dev/null +++ b/doc/ru/internals.docbook @@ -0,0 +1,71 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Отличие &kappname; от других просмотрщиков. Свои библиотеки. + + +Использование OpenGL. +На данный момент имеется возможность использовать несколько различных способов отображения изображений. В качестве движков можно использовать OpenGL, MIT-SHM, Qt, gdk-pixbuf с MMX оптимизацией. Главное их отличие друг от друга - это скорость. Например, отображение изображений с помощью средств Qt будет работать очень медленно (даже в случае наличия собственной MMX оптимизации), или же gdk-pixbuf для GTK приложений будет работать приемлимо для среднего размера изображений. + +Использование OpenGL в качестве движка просмотра изображений имеет свои преимущества и недостатки. В качестве преимущества можно упомянуть большую скорость манипулирования изображением (увеличение, уменьшение, повороты, сдвиги...), недоступную другим способам отображения. В противовес этому, как недостаток можно упомянуть наоборот очень низкую скорость манипулирования изображением, которое полностью не помещается в видеопамять Вашей видеокарты. Например, с большой вероятностью изображение 9600x9600 не поместится в видеопамять видеокарты среднего класса, как моей GF MX440, и масштабирование в окне просмотра будет работать крайне медленно. Таким образом, &kappname; отлично подходит для просмотра домашних изображений - иллюстраций стандартных размеров, сканированных листов A4, фотографий с цифрового фотоаппарата и т.п., но будет работать с затруднениями с огромными изображениями. + + + +Свои библиотеки + +Почти во всех программах просмотра изображений для декодирования используются сторонние библиотеки. Примером могут служить такие библиотеки как imlib (Image Magic) и Qt. На первый взгляд, преимущества такого способа очевидны - это перекладывание головной боли по декодированию изображений на другие библиотеки, вообще абстрагируясь от низкого уровня работы с изображениями, альфа каналами, битовыми масками, RLE кодированием и прочего. Но у этого способа есть несколько очевидных недостатков. К ним причисляется, во-первых, частичное отсутствие расширяемости набора кодеков изображений. Во-вторых, это зависимость кодеков от больших (а иногда очень больших) библиотек, типа Qt. В-третьих, отсутствие поддержки анимаций, типа GIF, FLI или MNG. В-четвёртых, отсутствие возможности декодирования отдельных строк. + + +Исходя из всех этих недостатков, было решено отказаться от помощи сторонних библиотек и разработать собственные библиотеки, которые могли бы не зависеть от других библиотек, кроме стандартных и требуемых самими кодеками (такие, как libsvg, libmng и др.), загружаться динамически, быть полностью расширяемыми, поддерживать декодирование строк и анимацию. Эти библиотеки получили название &klibname;. + + + +На момент написания данной документации &klibname; поддерживал 51 формат изображений, включая PNG, JPEG, Photoshop PSD, AutoCAD DXF, WMF, SVG, MNG и GIF. Имеются также кодеки для поддержки файлов шрифтов TTF, анимаций FLI и X-овых курсоров. + + + +&klibname; поддерживает также текстовые поля (комментарии и др.), сохраняемые в некоторых типах изображений. Например, PNG и GIF кодеки способны читать комментарии из данных типов файлов. + + + +Работа &kappname; с библиотеками + + +Благодаря вышеуказанным свойствам библиотек &klibname;, &kappname; приобретает следущие особенности: + + +&kappname; практически не знает, какой кодек будет использован для декодирования изображения - это определяется динамически. +&kappname; практически не знает, сколько страниц в декодируемом изображении и является ли оно анимацией - это определяется динамически. +Благодаря поддержке декодирования отдельных строк, &kappname; показывает изображения прогрессивно, т.е. по мере декодирования. + + + +Когда &kappname; загрузил все найденные библиотеки (используя Qt класс QLibrary), появляется возможность отображать любые поддерживанмые типы изображений (как статичных, так и анимированных). Когда пользователь выбирает изображение в навигаторе, &kappname; по MIME типу либо расширению файла определяет, поддерживается ли данный формат изображения. Если данный формат поддерживается, то, используя найденную библиотеку, &kappname; приступает к декодированию изображения и отображению его в окне просмотра. + +Информацию о всех найденных кодеках можно просмотеть в диалоге Информация о плагинах, как показано на скриншоте. + + +Информация по найденным кодекам + + + + +Информация по найденным кодекам + + + +Подсказка: слева от имени кодека может отображаться значёк настроек, как показано на рисунке для кодека GIMP XCF. Это означает, что данный кодек может быть настроен для работы с различными параметрами. Например, для кодека GIMP XCF можно настроить цвет фона для прозрачных изображений. + + + + + diff --git a/doc/ru/internals.html b/doc/ru/internals.html new file mode 100644 index 0000000..1b56f27 --- /dev/null +++ b/doc/ru/internals.html @@ -0,0 +1,2 @@ +Глава 2. Отличие KSquirrel от других просмотрщиков. Свои библиотеки.
Отличие KSquirrel от других просмотрщиков. Свои библиотеки.
Пред.
След.
 

Глава 2. Отличие KSquirrel от других просмотрщиков. Свои библиотеки.

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

Использование OpenGL.

На данный момент имеется возможность использовать несколько различных способов отображения изображений. В качестве движков можно использовать OpenGL, MIT-SHM, Qt, gdk-pixbuf с MMX оптимизацией. Главное их отличие друг от друга - это скорость. Например, отображение изображений с помощью средств Qt будет работать очень медленно (даже в случае наличия собственной MMX оптимизации), или же gdk-pixbuf для GTK приложений будет работать приемлимо для среднего размера изображений.

Использование OpenGL в качестве движка просмотра изображений имеет свои преимущества и недостатки. В качестве преимущества можно упомянуть большую скорость манипулирования изображением (увеличение, уменьшение, повороты, сдвиги...), недоступную другим способам отображения. В противовес этому, как недостаток можно упомянуть наоборот очень низкую скорость манипулирования изображением, которое полностью не помещается в видеопамять Вашей видеокарты. Например, с большой вероятностью изображение 9600x9600 не поместится в видеопамять видеокарты среднего класса, как моей GF MX440, и масштабирование в окне просмотра будет работать крайне медленно. Таким образом, KSquirrel отлично подходит для просмотра «домашних» изображений - иллюстраций стандартных размеров, сканированных листов A4, фотографий с цифрового фотоаппарата и т.п., но будет работать с затруднениями с огромными изображениями.

Пред.
След.
Начало
Вступление 
 Свои библиотеки
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/intro.docbook b/doc/ru/intro.docbook new file mode 100644 index 0000000..a2e9359 --- /dev/null +++ b/doc/ru/intro.docbook @@ -0,0 +1,39 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Вступление + + +Что такое &kappname; + + +&kappname; это просмотрщик изображений для KDE реализующий OpenGL и динамическую поддержу форматов изображений. + + + +&kappname; имеет простой файловый менеджер, который позволяет просматривать каталоги и файлы на Вашем жёстком диске. + + + +Поддержка модулей KIPI обеспечивает дополнильную функциональность. + + + +Боковая панель с несколькими вкладками добавляет возможности навигации по диску и управления изображениями. + + +Загрузка изображений осуществляется набором собственных кодеков, которые мы называем &klibname;. +&kappname; сможет отобразить все изображения, которые поддерживаются данным набором кодеков. + + + + diff --git a/doc/ru/intro.html b/doc/ru/intro.html new file mode 100644 index 0000000..c2d83ea --- /dev/null +++ b/doc/ru/intro.html @@ -0,0 +1,11 @@ +Глава 1. Вступление
Вступление
Пред.
След.
 

Глава 1. Вступление

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

Что такое KSquirrel

+KSquirrel это просмотрщик изображений для KDE реализующий OpenGL и динамическую поддержу форматов изображений. +

+KSquirrel имеет простой файловый менеджер, который позволяет просматривать каталоги и файлы на Вашем жёстком диске. +

+Поддержка модулей KIPI обеспечивает дополнильную функциональность. +

+Боковая панель с несколькими вкладками добавляет возможности навигации по диску и управления изображениями. +

Загрузка изображений осуществляется набором собственных кодеков, которые мы называем «ksquirrel-libs». +KSquirrel сможет отобразить все изображения, которые поддерживаются данным набором кодеков.

Пред.
След.
Начало
KSquirrel Руководство Пользователя 
 Отличие KSquirrel от других просмотрщиков. Свои библиотеки.
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/license.html b/doc/ru/license.html new file mode 100644 index 0000000..c0dae39 --- /dev/null +++ b/doc/ru/license.html @@ -0,0 +1,7 @@ +Глава 6. Лицензия, авторские права и благодарности
Лицензия, авторские права и благодарности
Пред.
След.
 

Глава 6. Лицензия, авторские права и благодарности

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

+KSquirrel и ksquirrel-libs разработаны и сопровождаются (c) 2003-2007 Барышевым Дмитрием Алексеевичем. Русская версия данного документа создана (c) 2006 Барышевым Дмитрием Алексеевичем. Вы можете связаться со мной по электронному адресу . +

Лицензирование KSquirrel:

Программа распространяется на условиях лицензии GNU General Public License.

+
Лицензирование ksquirrel-libs: GNU LIBRARY GENERAL PUBLIC LICENSE v.2
Лицензирование этого документа:

+Этот документ распространяется на условиях GNU Free Documentation +License.

Пред.
След.
Начало
Запуск KSquirrel из командной строки 
 Инсталляция
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/plugins_info.png b/doc/ru/plugins_info.png new file mode 100644 index 0000000..2b4a0af Binary files /dev/null and b/doc/ru/plugins_info.png differ diff --git a/doc/ru/running.docbook b/doc/ru/running.docbook new file mode 100644 index 0000000..b5aaef8 --- /dev/null +++ b/doc/ru/running.docbook @@ -0,0 +1,95 @@ + + + + +&Dmitry.Baryshev; + + + +2007-03-10 +0.3 + + +Запуск &kappname; из командной строки + + +Аргументы командной строки для &kappname; и &klibname; + + +Аргументы командной строки для &kappname; + + +Команда запуска &kappname; из командной строки выглядит так: + + + +ksquirrel + + + + + + +файл + + + +Параметр -d заставляет &kappname; отобразить в консоли доступные параметры DCOP. + + + +Параметр -l указывает &kappname; вывести на экран список найденных кодеков и выйти. Этот параметр чисто информационный. + + + +--nodirectorybasket не создавать корзину папок. + + + +--noimagebasket не создавать корзину изображений. + + + +--nocategories не создавать категории. + + + +--nomountview не создавать просмотр точек монтирования. + + + +Параметр файл заставляет &kappname; открыть указанный файл при запуске. + + + + + +Примеры + + + + +Открыть при запуске изображение /home/me/images/foto00054.jpg + + +$ ksquirrel /home/me/images/foto00054.jpg + + + + + +Отобразить при запуске доступные параметры DCOP + + +$ ksquirrel -d + + + + + + + + + + + diff --git a/doc/ru/running.html b/doc/ru/running.html new file mode 100644 index 0000000..3798aaa --- /dev/null +++ b/doc/ru/running.html @@ -0,0 +1,28 @@ +Глава 5. Запуск KSquirrel из командной строки
Запуск KSquirrel из командной строки
Пред.
След.
 

Глава 5. Запуск KSquirrel из командной строки

Дмитрий Алексеевич Барышев

Издание 0.3 (2007-03-10)

Аргументы командной строки для KSquirrel и ksquirrel-libs

Аргументы командной строки для KSquirrel

+Команда запуска KSquirrel из командной строки выглядит так: +

ksquirrel [-d] [-l] [--nodirectorybasket] [--noimagebasket] [--nocategories] [--nomountview] [файл]

+Параметр -d заставляет KSquirrel отобразить в консоли доступные параметры DCOP. +

+Параметр -l указывает KSquirrel вывести на экран список найденных кодеков и выйти. Этот параметр чисто информационный. +

+--nodirectorybasket не создавать корзину папок. +

+--noimagebasket не создавать корзину изображений. +

+--nocategories не создавать категории. +

+--nomountview не создавать просмотр точек монтирования. +

+Параметр файл заставляет KSquirrel открыть указанный файл при запуске. +

Примеры

  • +Открыть при запуске изображение /home/me/images/foto00054.jpg + +

    $ ksquirrel /home/me/images/foto00054.jpg

    + +

  • +Отобразить при запуске доступные параметры DCOP + +

    $ ksquirrel -d

    + +

Пред.
След.
Начало
Окно просмотра изображения 
 Лицензия, авторские права и благодарности
Уровень выше


Would you like to make a comment or contribute an update to this page?
+ Send feedback to the KDE Docs Team

\ No newline at end of file diff --git a/doc/ru/sidebar.png b/doc/ru/sidebar.png new file mode 100644 index 0000000..d34f26c Binary files /dev/null and b/doc/ru/sidebar.png differ diff --git a/doc/ru/sidebar_basket.png b/doc/ru/sidebar_basket.png new file mode 100644 index 0000000..d88409f Binary files /dev/null and b/doc/ru/sidebar_basket.png differ diff --git a/doc/ru/sidebar_categories.png b/doc/ru/sidebar_categories.png new file mode 100644 index 0000000..c018e61 Binary files /dev/null and b/doc/ru/sidebar_categories.png differ diff --git a/doc/ru/sidebar_mounts.png b/doc/ru/sidebar_mounts.png new file mode 100644 index 0000000..c847e00 Binary files /dev/null and b/doc/ru/sidebar_mounts.png differ diff --git a/doc/ru/view_thumbnails.png b/doc/ru/view_thumbnails.png new file mode 100644 index 0000000..34c738d Binary files /dev/null and b/doc/ru/view_thumbnails.png differ -- cgit v1.2.1