# Manual do &ksnapshot;

## Introdução

0 &ksnapshot; é uma 'applet' simples para capturar imagens do ecrã. É capaz de capturar imagens do ecrã inteiro, de apenas uma janela ou de uma região rectangular ou livre seleccionada. As imagens podem ser gravadas numa variedade de formatos.

Por favor comunique quaisquer problemas ou pedidos de funcionalidades para o Sistema de Registo de Erros do &kde;.

## Usar o &ksnapshot;

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

### Iniciando o &ksnapshot;

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

- Pode iniciar o &ksnapshot;, seleccionando para tal a opção Aplicações Gráficos Programa de Captura do Ecrã &ksnapshot;.

- Pode iniciar o &ksnapshot; introduzindo o seguinte comando numa linha de comandos:

      % ksnapshot &

- A mini-linha de comandos &krunner; (invocada com &Alt;F2) também pode ser usada para iniciar o &ksnapshot;.

Logo que o &ksnapshot; esteja a correr irá ver uma janela como a seguinte: Janela do &ksnapshot;

### Capturando uma Imagem

O &ksnapshot; captura uma imagem do ecrã inteiro imediatamente após ter sido iniciado, mas antes de aparecer no ecrã. Isto permite-lhe criar rapidamente imagens do ecrã inteiro.

A imagem capturada pelo &ksnapshot; é mostrada na janela de antevisão, que está localizada na parte central superior da janela do &ksnapshot; Em baixo está um exemplo da janela de pré-visualização do &ksnapshot;. A sua imagem será diferente dependendo do que está no seu ecrã.

Janela do &ksnapshot;

A imagem pode ser gravada se carregar no botão Gravar Como... (&Ctrl;S). Isto abre a janela normal de gravação do &kde;, onde poderá escolher o nome do ficheiro, a localização da pasta e o formato com que deseja gravar a imagem nova. Se forem capturadas múltiplas imagens, o nome do ficheiro é automaticamente incrementado para prevenir que não escreva por cima de imagens anteriores. Pode no entanto, editar o nome do ficheiro para qualquer valor que deseje, incluindo o nome de uma imagem previamente guardada.

Para capturar uma nova imagem de uma única janela, active a opção Janela Sob o Cursor (a seguir ao texto Modo de captura:) e depois carregar no botão Tirar uma Nova Fotografia (&Ctrl;N).

Dependendo da sua configuração do Atraso da fotografia você poderá obter uma cruz como cursor do rato (para o Sem atraso) ou poderá lidar com um programa até que o atraso termine e seja tirada uma fotografia.

Com o Sem atraso, a imagem é extraída imediatamente logo que você carregar numa janela.

O &ksnapshot; irá mostrar a nova imagem na área de antevisão, e nessa altura você poderá optar por gravar a nova imagem (ao carregar em Gravar Como...) ou por capturar uma nova, ao carregar no botão Tirar uma Nova Fotografia.

Para capturar uma nova imagem do ecrã inteiro, active a opção Ecrã Completo e depois carregue no botão Tirar uma Nova Fotografia. O &ksnapshot; irá agora capturar o ecrã inteiro quando carregar no botão Tirar uma Nova Fotografia.

Da mesma forma, para tirar uma fotografia de uma região, seleccione o item da lista Região Rectangular (a seguir ao texto Modo de captura) e configurar o Atraso da fotografia como Sem atraso, carregando então no botão Tirar uma Nova Fotografia. O cursor do rato irá então mudar para uma cruz, onde poderá usar o rato para seleccionar a região que deseja capturar. Para tirar a fotografia, carregue na tecla &Enter; ou então em &Esc; para sair.

Da mesma forma, para tirar uma fotografia de uma região não rectangular, seleccione o item da lista Região Livre e configurar o Atraso da fotografia como Sem atraso, carregando então no botão Tirar uma Nova Fotografia. O cursor do rato irá então mudar para uma cruz, onde poderá usar o rato para seleccionar a região que deseja capturar. Para tirar a fotografia, carregue na tecla &Enter; ou então em &Esc; para sair.

Para tirar uma nova fotografia de uma secção da janela, seleccione o item Secção da Janela da lista e carregue depois no botão Tirar uma Nova Fotografia. Com o Sem atraso, irá obter como cursor do rato uma vez, onde terá de carregar uma vez com o &LMB; na janela. A secção da janela, sob o cursor do rato, ficará realçada com um contorno vermelho. Mova o rato para a secção desejada e carregue no &LMB; para capturar a fotografia.

Se tiver vários ecrãs, o Ecrã Actual captura o ecrã que contém o cursor do rato, na altura em que é retirada a captura.

### Funcionalidades Adicionais

#### Atraso da Fotografia

O campo de Atraso da Fotografia permite-lhe introduzir uma espera de tempo, em segundos, entre o momento em que pressiona o botão Tirar uma Nova Fotografia e o momento em que a imagem é capturada.

Quando um tempo de espera é definido, não tem que carregar com o rato para capturar a imagem. Isto permite-lhe, por exemplo, abrir um menu, e capturar uma imagem dele.

#### Excluir as Decorações das Janelas

Incluir as decorações das janelas está activo por omissão no modo Janela Sob o Cursor.

Quando você só quiser capturar a aplicação em si sem a decoração envolvente da janela, desactive esta opção e tire uma nova fotografia.

#### Incluir o cursor do rato

Incluir o cursor do rato está desactivado por omissão. Esta opção não está disponível nos modos de Região Rectangular e Região Livre.

Quando você quiser incluir o cursor do rato na sua captura, active esta opção e tire uma nova fotografia.

#### Botões

Há ainda mais quatro botões localizados no fundo da janela do &ksnapshot;. As suas funções estão descritas em baixo.

Ajuda

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

Enviar Para...

- Isto irá permitir abrir a captura directamente com todos os programas que tenha associado ao seu tipo MIME para o PNG (Portable Network Graphics). Dependendo dos programas que tiver instalado, poderá abrir e editar a imagem nas suas aplicações ou visualizadores gráficos.

  Para além disso, se tiver os 'plugins' do KIPI instalados, poderá imprimir as suas capturas, enviá-las por e-mail e exportá-las directamente para uma dada rede social ou página Web, como se demonstra na imagem abaixo.

  O menu 'Enviar Para...' do &ksnapshot; com o 'kipi-plugins' instalado

Copiar

- Quando quiser editar a sua captura numa aplicação gráfica, sem gravar a fotografia, basta carregar em Copiar (&Ctrl;C) e insira a imagem num visualizador ou numa aplicação gráfica.

Gravar Como...

- Grava a captura do ecrã num ficheiro com o formato seleccionado.

## A Interface de &DBus;

O &ksnapshot; poderá ser programado a partir da sua interface &DBus;.

Existem duas formas de usar a interface de &DBus;: a &GUI; do &Qt; qdbusviewer e o utilitário da linha de comandos qdbus.

Exemplos:

- O `%` `qdbus` irá mostrar todos os serviços disponíveis.

- O `%` `qdbus` `org.kde.ksnapshot-`pidof -s ksnapshot`` irá mostrar a interface &DBus; do &ksnapshot;.

- O `%` `qdbus` `org.kde.ksnapshot-`pidof -s ksnapshot` /KSnapshot` irá mostrar os métodos que controlam o &ksnapshot;.

Para mais informações, vá por favor ao tutorial sobre &DBus;.

## Créditos e Licença

Copyright do programa

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

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

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

Tradução de Nuno Donato nunodonato@iol.pt

&underFDL; &underGPL;
&documentation.index;