<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ksnapshot;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Russian "INCLUDE"
> <!-- change language only here -->
]>

<book id="ksnapshot" lang="&language;">

<bookinfo>
<title
>Руководство пользователя &ksnapshot;</title>

<authorgroup>
<author
><firstname
>Richard</firstname
> <othername
>J.</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
</author>

<author
><firstname
>Robert</firstname
> <othername
>L.</othername
> <surname
>McCormick</surname
> <affiliation
> <address
>&Robert.L.McCormick.mail;</address>
</affiliation>
</author>

<author
><firstname
>Brad</firstname
> <surname
>Hards</surname
> <affiliation
> <address
>&Brad.Hards.mail;</address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
>&Lauri.Watts.mail;</address>
</affiliation>
<contrib
>Редактор</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Richard</firstname
> <othername
>J</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
<contrib
>Разработчик</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias</firstname
> <surname
>Ettrich</surname
> <affiliation
> <address
>&Matthias.Ettrich.mail;</address>
</affiliation>
<contrib
>Разработчик</contrib>
</othercredit>

<othercredit role="translator"
> <firstname
>Виталий</firstname
><surname
>Лопатин</surname
> <affiliation
><address
><email
>vitls@chat.ru</email
></address
></affiliation
> <contrib
>Перевод на русский</contrib
> </othercredit
> <othercredit role="translator"
> <firstname
>Алексей</firstname
><surname
>Баранов</surname
> <affiliation
><address
><email
>aleksei.ee@gmail.com</email
></address
></affiliation
> <contrib
>Дополнение перевода</contrib
> </othercredit
> 
</authorgroup>

<copyright>
<year
>1997-2000</year>
<holder
>&Richard.J.Moore;</holder>
</copyright>

<copyright>
<year
>2000</year>
<holder
>&Matthias.Ettrich;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>22 мая 2013 г.</date>
<releaseinfo
>0.8.2 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&ksnapshot; &mdash; это небольшая программа для создания снимков экрана. Она пригодна для захвата отдельного окна, части окна, части экрана (прямоугольной и произвольной формы) или всего рабочего стола. Изображения могут быть сохранены в различных форматах.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>снимок экрана</keyword>
<keyword
>скриншот</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Введение</title>

<para
>&ksnapshot; &mdash; это небольшая программа для создания снимков экрана. Она пригодна для захвата отдельного окна, части окна, части экрана (прямоугольной и произвольной формы) или всего рабочего стола. Изображения могут быть сохранены в различных форматах.</para>

<para
>О найденных ошибках и недостающих вам возможностях пишите в <ulink url="http://bugs.kde.org/"
>систему отслеживания ошибок &kde;</ulink
>.</para>

</chapter>

<chapter id="using-ksapshot">
<title
>Использование &ksnapshot;</title>

<para
>Эта глава описывает использование &ksnapshot; для создания снимков экрана.</para>

<sect1 id="starting">
<title
>Запуск &ksnapshot;</title>

<para
>&ksnapshot; может быть запущен несколькими способами, как указано ниже.</para>

<itemizedlist>
<listitem>
<para
>Вы можете запустить &ksnapshot; выбрав его из меню запуска приложений: <menuchoice
> <guisubmenu
>Приложения</guisubmenu
><guisubmenu
>Графика</guisubmenu
> <guimenuitem
>Создание снимков экрана (&ksnapshot;)</guimenuitem
></menuchoice
>. </para
></listitem>
<listitem>
<para
>Вы можете запустить &ksnapshot;, введя в командной строке следующее:</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>Диалог запуска команд &krunner; (вызываемый по <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>) также может быть использован для запуска &ksnapshot;.</para
></listitem>
</itemizedlist>

<para
>Когда &ksnapshot; запустится, вы увидите окно вроде этого: <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Окно предварительного просмотра &ksnapshot;</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Создание снимка</title>

<para
>&ksnapshot; захватывает изображение всего рабочего стола сразу после запуска, но перед тем как он сам будет показан на нём. Это позволяет быстро сделать снимок всего экрана целиком .</para>

<para
>Снимки, сделанные &ksnapshot;, показаны в окне предварительного просмотра, которое расположено в верхней части окна &ksnapshot;. Ниже показано типичное окно &ksnapshot;. Содержание окна предварительного просмотра зависит от того, что отображается на рабочем столе.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Окно предварительного просмотра &ksnapshot;</phrase>
</textobject>
</mediaobject>

<para
>Снимок можно сохранить, нажав кнопку <guibutton
>Сохранить как...</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
>). Эта кнопка откроет стандартное окно сохранения файла, в котором вы сможете выбрать имя файла, папку и формат, в котором будет сохранён снимок экрана. Если сделано несколько снимков, имя файла автоматически увеличится, чтобы не перезаписать уже готовый снимок. Вы можете по своему усмотрению изменять имя файла, включая имена предыдущих снимков. </para>

<para
>Чтобы снять одно окно, выберите из списка <guilabel
>Окно под курсором мыши</guilabel
> (напротив подписи «Режим захвата снимка») и нажмите кнопку <guibutton
>Сделать новый снимок</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
>).</para>

<para
>В зависимости от значения <guilabel
>Задержки</guilabel
>, вы будете видеть разные указатели мыши сразу после нажатия на кнопку <guibutton
>Создать новый снимок</guibutton
>. Вы увидите сразу указатель мыши в виде креста, если выбрано значение <guibutton
>Без задержки</guibutton
>, либо вы увидите обычный указатель мыши, которым вы можете пользоваться для работы с системой, пока идёт время задержки, чтобы подобрать нужный момент для захвата. Использование задержки может быть удобно, например, для захвата меню приложения.</para>

<para
>В режиме <guilabel
>Без задержки</guilabel
> снимок создаётся сразу после щелчка мышью по окну.</para>

<para
>&ksnapshot; отобразит новый снимок экрана в области просмотра, при этом вы сможете сохранить изображение (с помощью кнопки <guibutton
>Сохранить как...</guibutton
>) или сделать новый с помощью кнопки <guibutton
>Новый снимок</guibutton
>.</para>

<para
>Чтобы снять рабочий стол целиком, выберите из списка <guilabel
>Весь экран</guilabel
> (напротив подписи <guilabel
>Режим захвата снимка</guilabel
>). Теперь при нажатии кнопки <guibutton
>Сделать новый снимок</guibutton
> вы снимете весь рабочий стол.</para>

<para
>Аналогично, чтобы сделать снимок прямоугольной области, выберите <guilabel
>Прямоугольная область экрана</guilabel
> из списка <guilabel
>Режим захвата снимка</guilabel
>, далее выберите <guilabel
>Без задержки</guilabel
> в поле <guilabel
>Задержка</guilabel
>,а затем нажмите на кнопку <guibutton
>Сделать новый снимок</guibutton
>.Когда курсор мыши примет вид креста, вы сможете выбрать область экрана, которую хотите захватить.Чтобы сделать снимок, нажмите &Enter; или сделайте двойной щелчок мышью, либо нажмите клавишу &Esc; для выхода.</para>

<para
>Вы также можете сделать снимок произвольной области. Для этого выберите <guilabel
>Произвольная область экрана</guilabel
> из списка <guilabel
>Режим захвата снимка</guilabel
>, в поле <guilabel
>Задержка</guilabel
> выберите <guilabel
>Без задержки</guilabel
> и нажмите кнопку <guibutton
>Сделать новый снимок</guibutton
>. Когда курсор мыши примет вид креста, вы можете выбрать для снимка произвольную область экрана. После выделения области вы можете создать снимок двойным щелчком левой кнопкой мыши по области или с помощью клавиши &Enter;. Если вы захотите отменить создание снимка, нажмите &Esc;.</para>

<para
>Чтобы сделать снимок области окна, выберите <guilabel
>Область окна</guilabel
> из списка <guilabel
>Режиме захвата снимка</guilabel
>, а затем нажмите кнопку <guilabel
>Сделать новый снимок</guilabel
>.Если у вас установлен режим <guilabel
>Без задержки</guilabel
>, то указатель мыши сразу примет форму креста, и вы сможете один раз нажать левой кнопкой мыши на интересующее окно. После выбора окна будет обводиться красной рамкой та область этого окна, которая сейчас находится под указателем мыши. Вы можете менять область окна для захвата, просто перемещая курсор мыши. Когда вы выбрали желаемую область окна, нажмите левую кнопку мыши, чтобы создать снимок. </para>

<para
>Если у вас подключены несколько мониторов, то в режиме <guilabel
>Текущий экран</guilabel
> будет сделан снимок экрана, на котором находится указатель мыши.</para>

<para
>Если делать несколько снимков подряд, не закрывая &ksnapshot;, используя режимы захвата <guibutton
>Прямоугольная область экрана</guibutton
> и <guibutton
>Произвольная область экрана</guibutton
>, снимки будут сделаны для последней выбранной области захвата (с момента запуска &ksnapshot;). Вы можете изменять размер прямоугольной области, используя для этого метки по краям, перемещать выбранную область произвольной формы или полностью заменить область на новую, начав выделение за пределами текущей области захвата.</para>
</sect1>

<sect1 id="additional-features">
<title
>Дополнительные возможности</title>

<sect2 id="delay">
<title
>Задержка</title>

<para
>Поле <guilabel
>Задержка</guilabel
> позволяет задать время в секундах между нажатием кнопки <guibutton
>Сделать новый снимок</guibutton
> и моментом создания снимка экрана.</para>

<para
>Когда задержка установлена, вам не нужно щёлкать мышкой, чтобы сделать снимок. Это позволит вам открыть какое-либо меню и сделать его снимок.</para>

</sect2>

<sect2 id="window-decoration">
<title
>Исключить декорации окон</title>

<para
>Параметр <guilabel
>Включая обрамления окна</guilabel
> включён по умолчанию в режиме <guilabel
>Окно под курсором мыши</guilabel
>.</para>

<para
>Если вам нужен снимок только самого приложения, выключите этот параметр.</para>

</sect2>

<sect2 id="mouse-pointer">
<title
>Включая курсор мыши</title>

<para
>Параметр <guilabel
>Включая курсор мыши</guilabel
> выключен по умолчанию. Он недоступен в режимах захвата <guilabel
>Прямоугольной области экрана</guilabel
> и <guilabel
>Произвольной области экрана</guilabel
>.</para>

<para
>Если вам необходимо добавить указатель мыши на снимок, включите этот параметр и сделайте новый снимок.</para>

</sect2>

<!-- not in 4.1
<sect2 id="print-snapshot">
<title
>Print</title>

<para
>When you want to print your snapshot from the preview, just click
<guibutton
>Print...</guibutton
> and you get the standard &kde; Print dialog, from
where you can directly print your snapshot.</para>
</sect2>
-->


<sect2 id="bottom-buttons">
<title
>Кнопки</title>

<para
>В нижней части окна &ksnapshot; расположены четыре кнопки. Их назначение описано ниже.</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Справка</guibutton
></term>
<listitem
><para
>Открывает меню, через которое доступны <guimenuitem
>Руководство пользователя &ksnapshot;</guimenuitem
>, форма сообщения об ошибке, переключение языка интерфейса &ksnapshot; и просмотр информации <guimenuitem
>о &ksnapshot;</guimenuitem
> и <guimenuitem
>о &kde;</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Открыть в...</guibutton
></term>
<listitem
><para
>Позволяет открывать снимок напрямую в приложении, которое ассоциировано у вас с форматом PNG (Portable Network Graphics). В зависимости от установленных программ, вы сможете открыть и отредактировать снимки в графических приложениях.</para>
<para
>Кроме того, если у вас установлены <application
>модули KIPI</application
> вы сможете распечатать снимки, отослать их по электронной почте и отправить напрямую в некоторые социальные сети и на веб-сайты, как показано на снимке ниже.</para>
<mediaobject>
<imageobject>
<imagedata fileref="send-to-menu.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Меню &ksnapshot; «Открыть в...» с установленным пакетом kipi-plugins</phrase>
</textobject>
</mediaobject>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Копировать</guibutton
></term>
<listitem
><para
>Если вы хотите отредактировать ваш снимок в графическом приложении без предварительного сохранения, просто нажмите <guibutton
>Копировать</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>) и вставьте изображение в графическое приложение.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Сохранить как...</guibutton
></term>
<listitem
><para
>Сохраняет снимок в файл в выбранном формате.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="drag-and-drop">
<title
>Перетаскивание мышью</title>
<para
>Готовый снимок можно перетаскивать в другое приложение или документ. Если приложение позволяет принимать перетаскиваемые изображения, то полное изображение будет вставлено в него. </para>
<para
>Если перетащить снимок в окно диспетчера файлов, появится диалог сохранения изображения в файл, где можно выбрать имя и формат файла изображения. Файл будет сохранён в папку, открытую в текущий момент в диспетчере файлов. </para>
<para
>Если перетащить снимок к текстовому полю, то в него будет вставлен путь к временному файлу, в котором сохранён снимок. Это полезно, например, для загрузки снимков через веб-формы или при прикреплении снимков к <ulink url="https://bugs.kde.org/"
>отчетам об ошибках &kde;</ulink
>. </para>
<para
>Это работает со всеми приложениями, которые принимают не содержимое изображения, а адрес &URL;, содержащийся в метаданных к перетаскиваемому объекту. </para>
 </sect2>
 
</sect1>
</chapter>

<chapter id="dcop">

<title
>Интерфейс &DBus;</title>

<para
>Программой &ksnapshot; можно управлять из сценариев, используя интерфейс &DBus;.</para>

<para
>Есть два способа использовать интерфейс &DBus;: графическое приложение на &Qt; <application
>qdbusviewer</application
> и программа для командной строки <application
>qdbus</application
>. </para>

<para
>Примеры: <itemizedlist mark='opencircle'>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> покажет все доступные службы &DBus;. </para
></listitem>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot`</option
> покажет интерфейс &DBus; для &ksnapshot;. </para
></listitem>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot` /KSnapshot</option
> покажет методы для управления &ksnapshot;. </para
></listitem>

</itemizedlist>
</para>

<para
>Для получения дополнительной информации прочитайте <ulink url="http://techbase.kde.org/Development/Tutorials/D-Bus/Introduction"
>учебное пособие &DBus;</ulink
>. </para>

<!--
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484
/
/KDebug
/KSnapshot
/MainApplication
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KSnapshot
method void org.kde.ksnapshot.slotGrab()
method void org.kde.ksnapshot.slotOpen(QString application)
method void org.kde.ksnapshot.slotSave()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /MainApplication
method void org.kde.KApplication.quit()
method void org.kde.KApplication.reparseConfiguration()
method void org.kde.KApplication.updateUserTimestamp()
method void org.kde.KApplication.updateUserTimestamp(int time)
property readwrite int com.trolltech.Qt.QApplication.cursorFlashTime
property readwrite int com.trolltech.Qt.QApplication.doubleClickInterval
property readwrite QSize com.trolltech.Qt.QApplication.globalStrut
property readwrite int com.trolltech.Qt.QApplication.keyboardInputInterval
property readwrite bool com.trolltech.Qt.QApplication.quitOnLastWindowClosed
property readwrite int com.trolltech.Qt.QApplication.startDragDistance
property readwrite int com.trolltech.Qt.QApplication.startDragTime
property readwrite QString com.trolltech.Qt.QApplication.styleSheet
property readwrite int com.trolltech.Qt.QApplication.wheelScrollLines
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationName
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationVersion
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationDomain
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationName
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KDebug
method void org.kde.KDebug.notifyKDebugConfigChanged()
method void org.kde.KDebug.printBacktrace()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()
-->
<!-- dbus-launch ksnapshot-->
<!-- ksnapshot qdbus org.kde.ksnapshot-20985-->
<!--
<para
>To start &ksnapshot; and obtain the right argument, use
<command
>dcopstart ksnapshot</command
>, which returns the 
argument (such as <computeroutput
>ksnapshot-20594</computeroutput
>) on
standard output.</para>

<para
>You can get a list of the available &DCOP; interfaces, use
the right arguments, as shown in this example:
<screen width="60"
>
<prompt>$</prompt> <command>dcop `dcopstart ksnapshot` interface</command><computeroutput>
QCStringList interfaces()
QCStringList functions()
QString url()
void slotGrab()
void slotPrint()
void slotSave()
bool save(QString filename)
void slotSaveAs()
void slotCopy()
void setTime(int newTime)
int timeout()
void setURL(QString newURL)
void setGrabMode(int grab)
int grabMode()
void slotMovePointer(int x,int y)
void exit()
</computeroutput>
</screen>
</para>

<para>
In the examples following, the process is always
<computeroutput
>ksnapshot-23151</computeroutput
>.
</para>

<sect1 id="dcop-settings">

<title
>&DCOP; Access to Settings</title>

<para
>For each of the settings that you can control with the
&GUI;, you can both obtain the current status of that setting,
and modify the setting, using &DCOP;.
</para>

<para
>You can obtain the current capture mode using 
<literal
>grabMode</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface grabMode</command>
</screen>
This will return <computeroutput
>0</computeroutput
> for full-screen capture,
<computeroutput
>1</computeroutput
> for window capture, and <computeroutput
>2</computeroutput>
for region capture.
</para>

<para
>You can set the capture mode using <literal
>setGrabMode</literal
>,
which requires an argument to identify the mode required (as for <literal
>grabMode</literal
>).
So you can set window capture mode (<command
>1</command
>), using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setGrabMode 1</command>
</screen>
</para>

<para
>You can obtain the current timeout setting (the <guilabel
>Snapshot delay:</guilabel>
&GUI; item) using <literal
>timeout</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface timeout</command>
</screen>
This will return the timeout setting in seconds, or zero if there is no delay
(capture on click).
</para>

<para
>You can set the timeout using <literal
>setTime</literal
>,
which requires an argument to identify the timeout duration. So you can
set a delay of 4 seconds using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setTime 4</command>
</screen>
</para>

<para
>You can obtain the path that the snapshot will be saved to using 
<literal
>url</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt><command>dcop ksnapshot-23151 interface url</command>
</screen>
This will return the filename, as a &URL; (eg as 
<computeroutput
>file:///home/bradh/test2.png</computeroutput
>).
</para>

<para
>You can set the path using <literal
>setURL</literal
>,
which requires a string argument to identify the new path. So you can
set the path to <literal
>file:///home/bradh/snapshot.jpg</literal>
using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg</command>
</screen>
</para>

</sect1>

<sect1 id="dcop-snapshot">
<title
>Taking Screenshots with &DCOP;</title>

<para>
The key to taking screenshots with &DCOP; is use of <literal
>slotGrab</literal
>,
as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotGrab</command>
</screen>
</para>

<para>
This will take a snapshot using the current snapshot mode and timeout settings
(as described above). If you want to save the snapshot image, there are a
number of calls you can use. If you just want to save the image to the current
path (as returned by <literal
>url</literal
> or changed by
<literal
>setURL</literal
>), you can use <literal
>slotSave</literal
>, as shown
below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotSave</command>
</screen>
</para>

<para>
If you want the user to be able to specify a filename (and path), you can use
<literal
>slotSaveAs</literal
>, which will bring up a standard &kde; file
save dialog.</para>

<para>
If you want to save the image to a different name (or path) without
changing the path with <literal
>setURL</literal
>, you can use
<literal
>save</literal
>, providing the &URL; to save to as an argument. So if you
want to save the snapshot to <filename
>file:///tmp/tempshot.png</filename
>, you
can do the following:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface save file:///tmp/tempshot.png</command>
</screen>
Note that this will return true if the snapshot was successfully saved, and false
otherwise. Also, you should be aware that if the file already exists, the user
will get a standard &kde; dialog that requires the user to decide whether to overwrite
or not.
</para>

<para>
In addition to saving the snapshot, you can also copy it to the clipboard, using 
<literal
>slotCopy</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotCopy</command>
</screen>
</para>

<para>
If you need to select a window that may not be under the mouse cursor, you
can use <literal
>slotMovePointer</literal
>, passing the x position
(in screen pixels) and the y position (also in screen pixels) as arguments.
So to move the mouse to the top left hand corner of the screen (0,0), you
can do the following:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Printing Screenshots with &DCOP;</title>

<para>
You can print the current screenshot (which may or may not have been saved)
using <literal
>printSlot</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotPrint</command>
</screen>
</para>

<para>
Note that this will bring up the normal &kde; print dialog, which may require
user interaction.
</para>

</sect1>

<sect1 id="dcop-exit">
<title
>&DCOP; Application control</title>

<para>
You can cause &ksnapshot; to exit by using <literal
>exit</literal
>,
as shown below.
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface exit</command>
</screen>
</para>

</sect1>
-->
</chapter>

<chapter id="credits">

<title
>Авторские права и лицензия</title>

<para
>Авторское право</para>
<itemizedlist>
<listitem
><para
>1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para
></listitem>
<listitem
><para
>2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;</para
></listitem>
</itemizedlist>

<para
>Документация основана на оригинале, © &Richard.J.Moore; &Richard.J.Moore.mail;, 1997-2000.</para>
<para
>Перевод на русский: Виталий Лопатин <email
>vitls@chat.ru</email
></para
> <para
>Дополнение перевода: Алексей Баранов <email
>aleksei.ee@gmail.com</email
></para
>  
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

<!--
Local Variables:
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->