<?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 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
>2006-07-05</date>
<releaseinfo
>0.7</releaseinfo>

<abstract>
<para
>O &ksnapshot; é um miniaplicativo 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 ou de uma região selecionada. 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; é um miniaplicativo 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 ou de uma região selecionada. 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/wizard.cgi"
> 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 <menuchoice
> <guimenu
>Menu K</guimenu
><guisubmenu
>Gráficos</guisubmenu
> <guimenuitem
>&ksnapshot; (Programa de captura de tela)</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 (invocada 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 esquerda 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
>. 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
>.</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 inteira</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, selecione a opção <guilabel
>Região</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>

<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>

</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.</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="print-snapshot">
<title
>Imprimir</title>

<para
>Quando desejar imprimir a sua captura a partir da visualização, basta clicar em <guibutton
>Imprimir...</guibutton
> e você obterá o diálogo de impressão padrão do &kde;, onde poderá imprimir a sua captura de tela diretamente.</para>
</sect2>

<sect2 id="copy-snapshot">
<title
>Copiar para área de transferência</title>

<para
>Quando desejar editar sua captura em um aplicativo gráfico sem salvá-la, basta clicar em <guibutton
>Copiar para área de transferência</guibutton
> e inserir a imagem em um visualizador ou aplicativo gráfico.</para>
</sect2>


<sect2 id="bottom-buttons">
<title
>Botões</title>

<para
>Existem mais dois 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 ou obter algumas informações <guimenuitem
>Sobre o &ksnapshot;</guimenuitem
> e <guimenuitem
>Sobre o &kde;</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Sair</guibutton
></term>
<listitem
><para
>Fecha o aplicativo &ksnapshot;.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>
</chapter>

<chapter id="dcop">

<title
>Interface &DCOP;</title>

<para
>O &ksnapshot; pode ser programado para usar a interface &DCOP;. Este capítulo explica as várias chamadas &DCOP; que podem ser utilizadas e fornece alguns exemplos de como usá-las.</para>

<para
>Como em todas as chamadas &DCOP;, é necessário especificar o aplicativo com que deseja interagir e a interface em particular. Com o &ksnapshot; é necessário identificar o aplicativo em particular, que é <literal
>ksnapshot-</literal
>, seguido do número do processo.</para>

<para
>Para iniciar o &ksnapshot; e obter o argumento correto, use <command
>dcopstart ksnapshot</command
>, para retornar o argumento (como por exemplo, <computeroutput
>ksnapshot-20594</computeroutput
>) na saída padrão.</para>

<para
>Você pode obter uma lista de interfaces &DCOP; disponíveis e usar os argumentos corretos, como é mostrado no exemplo: <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
>Nos exemplos seguintes, o processo será sempre <computeroutput
>ksnapshot-23151</computeroutput
>. </para>

<sect1 id="dcop-settings">

<title
>Acesso &DCOP; às configurações</title>

<para
>Para cada uma das configurações possíveis de controlar com a &GUI;, é possível obter o status atual da configuração e modificá-la usando &DCOP;. </para>

<para
>Você pode obter o modo de captura atual usando <literal
>grabMode</literal
>, como mostrado abaixo: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface grabMode</command>
</screen
> Ele retornará <computeroutput
>0</computeroutput
> para captura da tela inteira, <computeroutput
>1</computeroutput
> para captura da janela e <computeroutput
>2</computeroutput
> para captura de região. </para>

<para
>Você pode definir o modo de captura usando <literal
>setGrabMode</literal
>, que precisa de um argumento para identificar o modo solicitado (como na <literal
>grabMode</literal
>). Assim, você pode definir o modo de captura de janela (<command
>1</command
>), usando: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setGrabMode 1</command
>
</screen>
</para>

<para
>Você pode obter a configuração do tempo de espera atual (o item da &GUI; <guilabel
>Atraso na captura:</guilabel
>) usando <literal
>timeout</literal
>, como mostrado abaixo: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface timeout</command>
</screen
> Isto retornará a configuração do tempo de espera, em segundos, ou zero, se não tiver um atraso definido (captura no clique). </para>

<para
>Você pode definir o tempo de espera usando <literal
>setTime</literal
>, que precisa de um argumento para identificar a duração. Assim, você pode definir um atraso de 4 segundos usando: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setTime 4</command
>
</screen>
</para>

<para
>Você pode obter o caminho onde a captura de tela será salva usando <literal
>url</literal
>, como mostrado abaixo: <screen width="60">
<prompt
>$</prompt
><command
>dcop ksnapshot-23151 interface url</command>
</screen
> Isto retornará o nome do arquivo como um &URL; (ex. <computeroutput
>file:///home/bradh/test2.png</computeroutput
>). </para>

<para
>Você pode definir o caminho usando <literal
>setURL</literal
>, que precisa de um argumento de texto para identificar o novo caminho. Assim, você pode definir o caminho como <literal
>file:///home/bradh/snapshot.jpg</literal
> usando: <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
>Obtendo imagens com &DCOP;</title>

<para
>A chave para obtenção de imagens com &DCOP; é o uso do <literal
>slotGrab</literal
>, como mostrado abaixo: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotGrab</command
>
</screen>
</para>

<para
>Isto obterá uma captura de tela usando as configurações do modo de captura atual e o tempo de espera (como descrito acima). Se desejar salvar a imagem capturada, você pode usar um conjunto de chamadas. Se desejar apenas salvar a imagem no caminho atual (retornado pelo <literal
>url</literal
> ou alterado pelo <literal
>setURL</literal
>), você pode usar <literal
>slotSave</literal
>, como mostrado abaixo: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotSave</command
>
</screen>
</para>

<para
>Se desejar que o usuário seja capaz de especificar o nome do arquivo (e o caminho), você pode usar <literal
>slotSaveAs</literal
>, que mostrará um diálogo de salvamento de arquivo padrão do &kde;.</para>

<para
>Se desejar salvar a imagem com um nome diferente (ou caminho) sem alterar o caminho com <literal
>setURL</literal
>, você pode usar <literal
>save</literal
> e fornecer o &URL; a salvar como argumento. Assim, se deseja salvar a captura em <filename
>file:///tmp/tempshot.png</filename
>, você pode fazer o seguinte: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface save file:///tmp/tempshot.png</command>
</screen
> Lembre-se que isto retornará 'true' se a captura foi salva com sucesso ou 'false' se ocorreu algum problema. Dessa forma, você deverá saber que, se o arquivo existir, o usuário obterá um diálogo padrão do &kde;, para decidir se será sobrescrito ou não. </para>

<para
>Além de salvar a captura de tela, você pode também copiá-la para a área de transferência usando <literal
>slotCopy</literal
>, como mostrado abaixo: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotCopy</command
>
</screen>
</para>

<para
>Se precisar selecionar uma janela que não esteja sob o ponteiro do mouse, use <literal
>slotMovePointer</literal
>, informando como argumento a posição x e a posição y (ambos em pixels da tela). Dessa forma, para mover o mouse para o canto superior direito da tela (0,0), faça o seguinte: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command
>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Imprimindo imagens com &DCOP;</title>

<para
>Você pode imprimir a imagem atual (que pode ou não estar salva) usando <literal
>printSlot</literal
>, como mostrado abaixo: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotPrint</command
>
</screen>
</para>

<para
>Note que isto mostrará o diálogo de impressão normal do &kde;, que pode precisar de interação do usuário. </para>

</sect1>

<sect1 id="dcop-exit">
<title
>Controle do aplicativo &DCOP;</title>

<para
>Você pode fechar o &ksnapshot; usando <literal
>exit</literal
>, como mostrado abaixo. <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
>andrealvarenga@gmx.net</email
></para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

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




