<?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 % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
]>

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

<bookinfo>
<title
>Manual do &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
>Revisão</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Richard</firstname
> <othername
>J</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias</firstname
> <surname
>Ettrich</surname
> <affiliation
> <address
>&Matthias.Ettrich.mail;</address>
</affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
><othercredit role="translator"
><firstname
>André Marcelo</firstname
><surname
>Alvarenga</surname
><affiliation
><address
><email
>andrealvarenga@gmx.net</email
></address
></affiliation
><contrib
>Tradução</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/05/2013</date>
<releaseinfo
>0.8.2 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>O &ksnapshot; é uma aplicação simples para capturar imagens da tela. Ele é capaz de capturar imagens de toda a área de trabalho, de uma janela individual, de uma seção da janela, uma região retangular selecionada ou uma região selecionada à mão livre. As imagens podem ser salvas em vários formatos.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>captura da tela</keyword>
<keyword
>imagem da tela</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &ksnapshot; é uma aplicação simples para capturar imagens da tela. Ele é capaz de capturar imagens de toda a área de trabalho, de uma janela individual, de uma seção da janela, uma região retangular selecionada ou uma região selecionada à mão livre. As imagens podem ser salvas em vários formatos.</para>

<para
>Comunique quaisquer problemas ou solicitações de novos recursos no <ulink url="http://bugs.kde.org/"
>Sistema de registro de erros do &kde;</ulink
>.</para>

</chapter>

<chapter id="using-ksapshot">
<title
>Usando o &ksnapshot;</title>

<para
>Este capítulo descreve a utilização do &ksnapshot; para capturar imagens da tela.</para>

<sect1 id="starting">
<title
>Iniciando o &ksnapshot;</title>

<para
>O &ksnapshot; pode ser iniciado por uma das várias maneiras descritas abaixo.</para>

<itemizedlist>
<listitem>
<para
>Você pode iniciar o &ksnapshot; selecionando-o a partir do menu do lançador de aplicativos <menuchoice
><guisubmenu
>Aplicativos</guisubmenu
> <guimenuitem
>Programa de captura de tela &ksnapshot;</guimenuitem
></menuchoice
>. </para
></listitem>
<listitem>
<para
>Você pode iniciar o &ksnapshot; digitando o seguinte na linha de comando:</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>A pequena linha de comando do &krunner; (acionada com <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>) também pode ser usada para iniciar o &ksnapshot;.</para
></listitem>
</itemizedlist>

<para
>Assim que o &ksnapshot; inicia, você verá uma janela como a seguinte: <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Janela do &ksnapshot;</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Capturando uma imagem</title>

<para
>O &ksnapshot; captura uma imagem de toda a sua área de trabalho imediatamente após ter sido iniciado, mas antes de aparecer na tela. Isto permite-lhe criar rapidamente imagens da tela inteira.</para>

<para
>A imagem capturada pelo &ksnapshot; é mostrada na janela de visualização, que está localizada na parte superior da janela do &ksnapshot;. Abaixo está um exemplo da janela de visualização do &ksnapshot;. A sua visualização será diferente, dependendo do que é mostrado na sua área de trabalho.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Janela do &ksnapshot;</phrase>
</textobject>
</mediaobject>

<para
>A captura pode ser salva clicando no botão <guibutton
>Salvar como...</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
>). Isto abre o diálogo de salvamento padrão do &kde;, onde você pode escolher o nome do arquivo, a localização da pasta e o formato em que a sua captura será salva. Se forem capturadas múltiplas imagens, o nome do arquivo é automaticamente incrementado para evitar a sobreposição das imagens anteriores. Você pode, no entanto, editar o nome do arquivo da forma que desejar, incluindo o nome de uma imagem previamente salva. </para>

<para
>Para capturar uma nova imagem de janela individual, selecione a opção <guilabel
>Janela sob o cursor</guilabel
> (próxima do texto <guilabel
>Modo de captura</guilabel
>), e depois clique no botão <guibutton
>Nova captura de tela</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
>).</para>

<para
>Dependendo da sua configuração do <guilabel
>Atraso na captura</guilabel
>, você obterá uma cruz como ponteiro do mouse (para <guilabel
>Sem atraso</guilabel
>) ou um ponteiro do mouse padrão, podendo usá-lo para trabalhar com algum programa, até que o atraso termine e a captura de tela seja obtida.</para>

<para
>Com <guilabel
>Sem atraso</guilabel
>, a captura é obtida imediatamente ao clicar em uma janela.</para>

<para
>O &ksnapshot; mostrará a nova captura na área de visualização e, nesse momento, você poderá escolher entre salvar a nova imagem (clicando em <guibutton
>Salvar como...</guibutton
>) ou capturar uma nova, clicando no botão <guibutton
>Nova captura de tela</guibutton
>.</para>

<para
>Para capturar uma nova imagem da área de trabalho inteira, selecione a opção <guilabel
>Tela cheia</guilabel
> e clique no botão <guibutton
>Nova captura de tela</guibutton
>. O &ksnapshot; irá agora capturar a tela inteira da área de trabalho, se clicar em <guibutton
>Nova captura de tela</guibutton
>.</para>

<para
>Da mesma forma, para capturar uma região retangular, selecione a opção <guilabel
>Região retangular</guilabel
> e defina o <guilabel
>Atraso na captura</guilabel
> para <guilabel
>Sem atraso</guilabel
>, e então, clique no botão <guibutton
>Nova captura de tela</guibutton
>. O ponteiro do mouse será alterado para uma cruz e pode ser usado para selecionar a região que deseja capturar. Para realizar uma captura pressione a tecla &Enter; ou faça um duplo clique. Pressione &Esc; para sair.</para>

<para
>Você pode querer capturar uma região não retangular. Faça isso selecionando <guilabel
>Região à mão livre</guilabel
> e defina o <guilabel
>Atraso na captura</guilabel
> para <guilabel
>Sem atraso</guilabel
>, e então, clique no botão <guibutton
>Nova captura de tela</guibutton
>. O ponteiro do mouse será alterado para uma cruz e pode ser usado para desenhar a região que deseja capturar. Para realizar uma captura pressione a tecla &Enter; ou faça um duplo clique. Pressione &Esc; para sair.</para>

<para
>Para obter uma nova captura de seção da janela, selecione a opção <guilabel
>Seção da janela</guilabel
> e então, clique no botão <guibutton
>Nova captura de tela</guibutton
>. Com <guilabel
>Sem atraso</guilabel
> aparecerá uma cruz como ponteiro do mouse e você deverá clicar uma vez com o &LMB; na janela. A seção da janela sob o ponteiro do mouse será destacada com uma borda vermelha. Mova o mouse para a seção desejada e clique com o &LMB; para capturar a imagem. </para>

<para
>Se você tiver várias telas, a <guilabel
>Tela atual</guilabel
> captura a tela que contém o cursor do mouse, no momento em que é realizada a captura.</para>

<para
>Ao manter o &ksnapshot; aberto para obter várias imagens da tela usando a opção <guibutton
>Região retangular</guibutton
> ou <guibutton
>Região livre</guibutton
>, as imagens subsequentes serão inicializadas com a última forma usada com esta função (desde a execução do &ksnapshot;). Você terá então a possibilidade de ajustar as alças da região retangular, mover a região livre ou substituir por completo a forma, começando a desenhar uma nova num local diferente da tela.</para>
</sect1>

<sect1 id="additional-features">
<title
>Recursos adicionais</title>

<sect2 id="delay">
<title
>Atraso na captura de tela</title>

<para
>O campo <guilabel
>Atraso na captura</guilabel
> permite-lhe informar um tempo de espera, em segundos, entre o momento em que pressiona o botão <guibutton
>Nova captura de tela</guibutton
> e o momento em que a imagem é capturada.</para>

<para
>Quando um tempo de espera é definido, você não precisa clicar o mouse para capturar a imagem. Isto permite-lhe abrir um menu e capturar uma imagem dele.</para>

</sect2>

<sect2 id="window-decoration">
<title
>Excluir decorações da janela</title>

<para
><guilabel
>Incluir decorações da janela</guilabel
> está habilitado por padrão no modo <guilabel
>Janela sob o cursor</guilabel
>.</para>

<para
>Quando desejar capturar o aplicativo em si, sem a decoração da janela que está ao seu redor, desabilite esta opção e faça uma nova captura de tela.</para>

</sect2>

<sect2 id="mouse-pointer">
<title
>Incluir ponteiro do mouse</title>

<para
><guilabel
>Incluir ponteiro do mouse</guilabel
> está desabilitado por padrão. Esta configuração não está disponível nos modos <guilabel
>Região retangular</guilabel
> e <guilabel
>Região à mão livre</guilabel
>.</para>

<para
>Quando desejar incluir o ponteiro do mouse em sua captura, ative esta opção e faça uma nova captura de tela.</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
>Botões</title>

<para
>Existem mais quatro botões localizados na parte inferior da janela do &ksnapshot;. Suas funções estão descritas abaixo.</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Ajuda</guibutton
></term>
<listitem
><para
>Fornece-lhe um menu onde poderá abrir o <guimenuitem
>Manual do &ksnapshot;</guimenuitem
>, relatar um erro, mudar o idioma do &ksnapshot; ou obter algumas informações <guimenuitem
>Sobre o &ksnapshot;</guimenuitem
> e <guimenuitem
>Sobre o &kde;</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Enviar para...</guibutton
></term>
<listitem
><para
>Isto permitirá abrir diretamente uma captura com todos os programas que estiverem associados com o tipo MIME PNG (Portable Network Graphics). Dependendo de quais programas tiver instalado, você será capaz de abrir e editar a captura em seus aplicativos gráficos ou visualizadores.</para>
<para
>Além disso, se você tiver os <application
>plugins do KIPI</application
> instalados será capaz de imprimir suas capturas, enviá-las por e-mail e exportá-las diretamente para redes sociais ou páginas Web, como mostrado na imagem abaixo.</para>
<mediaobject>
<imageobject>
<imagedata fileref="send-to-menu.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>O menu 'Enviar para...' do &ksnapshot; com os plugins do KIPI instalados</phrase>
</textobject>
</mediaobject>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Copiar</guibutton
></term>
<listitem
><para
>Quando desejar editar sua captura em um aplicativo gráfico sem salvá-la, basta clicar em <guibutton
>Copiar</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>) e inserir a imagem em um visualizador ou aplicativo gráfico.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Salvar como...</guibutton
></term>
<listitem
><para
>Salva a captura de tela para um arquivo no formato selecionado.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="drag-and-drop">
<title
>Arrastar e soltar</title>
<para
>Uma imagem capturada poderá ser arrastada para outro aplicativo ou documento. Se o aplicativo conseguir tratar imagens, será inserida lá uma cópia completa da mesma. </para>
<para
>Se arrastar uma imagem para uma janela de gerenciamento de arquivos, irá aparecer na caixa de diálogo onde você poderá indicar o nome do arquivo e seu formato, para que o arquivo seja introduzido na pasta atual. </para>
<para
>Se você arrastar a imagem para um campo de texto, é introduzido o caminho do arquivo temporário. Isto é útil, por exemplo, para enviar uma imagem para formulários na Web ou para anexar imagens em relatórios de erros no <ulink url="https://bugs.kde.org/"
>sistema de registro de erros do &kde;</ulink
>. </para>
<para
>Isto funciona com todos os clientes que não recolhem os dados da imagem, mas apenas procuram por uma &URL; nos dados MIME arrastados. </para>
 </sect2>
 
</sect1>
</chapter>

<chapter id="dcop">

<title
>Interface &DBus;</title>

<para
>O &ksnapshot; poderá ser programado a partir da sua interface &DBus;.</para>

<para
>Existem duas formas de usar a interface de &DBus;: a &GUI; do &Qt; <application
>qdbusviewer</application
> e o utilitário da linha de comando <application
>qdbus</application
>. </para>

<para
>Exemplos: <itemizedlist mark='opencircle'>

<listitem
><para
>O <prompt
>&percnt;</prompt
> <command
>qdbus</command
> irá mostrar todos os serviços disponíveis. </para
></listitem>

<listitem
><para
>O <prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot`</option
> irá mostrar a interface &DBus; do &ksnapshot;. </para
></listitem>

<listitem
><para
>O <prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot` /KSnapshot</option
> irá mostrar os métodos que controlam o &ksnapshot;. </para
></listitem>

</itemizedlist>
</para>

<para
>Para mais informações, vá por favor ao <ulink url="http://techbase.kde.org/Development/Tutorials/D-Bus/Introduction"
>tutorial sobre &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
>Créditos e licença</title>

<para
>Direitos autorais do programa</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
>Documentação baseada no original, direitos autorais 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para>
<para
>Tradução de Marcus Gama <email
>marcus.gama@uol.com.br</email
> e André Marcelo Alvarenga <email
>alvarenga@kde.org</email
></para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

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




