# Manual do &ksnapshot;

Richard
J.
Moore

    &Richard.J.Moore.mail;

Robert
L.
McCormick

    &Robert.L.McCormick.mail;

Brad
Hards

    &Brad.Hards.mail;

Lauri
Watts

    &Lauri.Watts.mail;

Revisão
Richard
J
Moore

    &Richard.J.Moore.mail;

Desenvolvimento
Matthias
Ettrich

    &Matthias.Ettrich.mail;

Desenvolvimento
Marcus
Gama

    marcus_gama@uol.com.br

Tradução
André Marcelo
Alvarenga

    andrealvarenga@gmx.net

Tradução
1997-2000
&Richard.J.Moore;
2000
&Matthias.Ettrich;
&FDLNotice;
2006-07-05
0.7

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.

KDE
KSnapshot
kdegraphics
captura da tela
imagem da tela

## Introdução

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.

Comunique quaisquer problemas ou solicitações de novos recursos no Sistema de registro de erros do &kde;

## Usando o &ksnapshot;

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

### Iniciando o &ksnapshot;

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

- Você pode iniciar o &ksnapshot; selecionando-o a partir do Menu K Gráficos &ksnapshot; (Programa de captura de tela).

- Você pode iniciar o &ksnapshot; digitando o seguinte na linha de comando:

      % ksnapshot &

- A pequena linha de comando (invocada com &Alt;F2) também pode ser usada para iniciar o &ksnapshot;

Assim que o &ksnapshot; inicia, você verá uma janela como a seguinte: Janela do &ksnapshot;

### Capturando uma imagem

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.

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.

Janela do &ksnapshot;

A captura pode ser salva clicando no botão Salvar como.... 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 capturar uma nova imagem de janela individual, selecione a opção Janela sob o cursor (próxima do texto Modo de captura:), e depois clique no botão Nova captura de tela.

Dependendo da sua configuração do Atraso na captura:, você obterá uma cruz como ponteiro do mouse (para Sem atraso) 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.

Com Sem atraso, a capturada é obtida imediatamente ao clicar em uma janela.

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

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

Da mesma forma, para capturar uma região, selecione a opção Região e defina o Atraso na captura para Sem atraso, e então, clique no botão Nova captura de tela. O ponteiro do mouse será alterado para uma cruz e pode ser usado para selecionar a região que deseja capturar.

Para obter uma nova captura de seção da janela, selecione a opção Seção da janela e então, clique no botão Nova captura de tela. Com Sem atraso 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.

### Recursos adicionais

#### Atraso na captura de tela

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

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.

#### Excluir decorações da janela

Incluir decorações da janela está habilitado por padrão.

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.

#### Imprimir

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

#### Copiar para área de transferência

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

#### Botões

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

Ajuda

  Fornece-lhe um menu onde poderá abrir o Manual do &ksnapshot;, relatar um erro ou obter algumas informações Sobre o &ksnapshot; e Sobre o &kde;.

Sair

  Fecha o aplicativo &ksnapshot;.

## Interface &DCOP;

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.

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 é `ksnapshot-`, seguido do número do processo.

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

Você pode obter uma lista de interfaces &DCOP; disponíveis e usar os argumentos corretos, como é mostrado no exemplo:

    $ dcop `dcopstart ksnapshot` interface
    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()

Nos exemplos seguintes, o processo será sempre `ksnapshot-23151`.

### Acesso &DCOP; às configurações

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

Você pode obter o modo de captura atual usando `grabMode`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface grabMode

Ele retornará `0` para captura da tela inteira, `1` para captura da janela e `2` para captura de região.

Você pode definir o modo de captura usando `setGrabMode`, que precisa de um argumento para identificar o modo solicitado (como na `grabMode`). Assim, você pode definir o modo de captura de janela (`1`), usando:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Você pode obter a configuração do tempo de espera atual (o item da &GUI; Atraso na captura:) usando `timeout`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface timeout

Isto retornará a configuração do tempo de espera, em segundos, ou zero, se não tiver um atraso definido (captura no clique).

Você pode definir o tempo de espera usando `setTime`, que precisa de um argumento para identificar a duração. Assim, você pode definir um atraso de 4 segundos usando:

    $ dcop ksnapshot-23151 interface setTime 4

Você pode obter o caminho onde a captura de tela será salva usando `url`, como mostrado abaixo:

    $dcop ksnapshot-23151 interface url

Isto retornará o nome do arquivo como um &URL; (ex. `file:///home/bradh/test2.png`).

Você pode definir o caminho usando `setURL`, que precisa de um argumento de texto para identificar o novo caminho. Assim, você pode definir o caminho como `file:///home/bradh/snapshot.jpg` usando:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg

### Obtendo imagens com &DCOP;

A chave para obtenção de imagens com &DCOP; é o uso do `slotGrab`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface slotGrab

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 `url` ou alterado pelo `setURL`), você pode usar `slotSave`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface slotSave

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

Se desejar salvar a imagem com um nome diferente (ou caminho) sem alterar o caminho com `setURL`, você pode usar `save` e fornecer o &URL; a salvar como argumento. Assim, se deseja salvar a captura em `file:///tmp/tempshot.png`, você pode fazer o seguinte:

    $ dcop ksnapshot-23151 interface save file:///tmp/tempshot.png

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.

Além de salvar a captura de tela, você pode também copiá-la para a área de transferência usando `slotCopy`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface slotCopy

Se precisar selecionar uma janela que não esteja sob o ponteiro do mouse, use `slotMovePointer`, 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:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Imprimindo imagens com &DCOP;

Você pode imprimir a imagem atual (que pode ou não estar salva) usando `printSlot`, como mostrado abaixo:

    $ dcop ksnapshot-23151 interface slotPrint

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

### Controle do aplicativo &DCOP;

Você pode fechar o &ksnapshot; usando `exit`, como mostrado abaixo.

    $ dcop ksnapshot-23151 interface exit

## Créditos e licença

Direitos autorais do programa

- 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

- 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;

Documentação baseada no original, direitos autorais 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

Tradução de Marcus Gama marcus.gama@uol.com.bre André Marcelo Alvarenga andrealvarenga@gmx.net

&underFDL; &underGPL;

&documentation.index;