# Manual do &spectacle;

## Introdução

&spectacle; é um aplicativo simples para capturar imagens da tela. É capaz de capturar imagens da tela inteira, de apenas um monitor, da janela ativa, da janela que estiver sob o ponteiro do mouse ou de uma região retangular. As imagens podem ser impressas, enviadas para outros aplicativos ou salvas em diversos formatos.

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

## Iniciando o &spectacle;

O &spectacle; pode ser iniciado por uma das várias maneiras descritas a seguir:

- No menu de lançamento de aplicativos, o &spectacle; pode ser encontrado em Aplicativos Gráficos&spectacle; (Programa de captura de tela).

- Se pressionar a tecla Print Screen no teclado, o &spectacle; será executado imediatamente. Além disso, estão disponíveis mais duas combinações de teclas. Se pressionar Meta Print Screen, irá capturar uma imagem da janela ativa e salvá-la na sua pasta padrão, enquanto que pressionar &Shift;Print Screen, irá obter uma imagem da sua área de trabalho inteira e também salvá-la na sua pasta padrão. Nessas duas últimas formas, o programa será executado sem mostrar a interface.

  O nome do arquivo e a pasta padrão para salvar as imagens podem ser configurados, iniciando o &spectacle; normalmente, clicar na seta ao lado do botão Salvar e sair e, então, selecionar a o item Configurar as opções de gravação no menu.

- A mini linha de comandos &krunner; (carregada com a combinação de teclas &Alt;F2) também pode ser usada para iniciar o &spectacle;.

- O &spectacle; pode ser iniciado a partir da linha de comando. Ele tem um amplo conjunto de opções para essa forma de execução, incluindo um modo em segundo plano que poderá ser usado para criar um script para capturar imagens sem mostrar a interface ou sem precisar de qualquer interação do usuário.

  Para iniciar o &spectacle; a partir da linha de comando, digite:

      % spectacle &

  Para ver a lista completa das opções da linha de comando e uma breve explicação, digite:

      % spectacle --help

## Como usar o &spectacle;

Assim que o &spectacle; iniciar será apresentada uma janela como esta: Janela principal do &spectacle;

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

A imagem capturada pelo &spectacle; é apresentada na janela de visualização que aparece no lado esquerdo da janela do aplicativo.

Para salvar a imagem rapidamente e sair do &spectacle;, clique no botão Salvar e sair (&Ctrl;Q). Por padrão, a imagem será salva em um arquivo no formato PNG, na sua pasta de imagens padrão e fechar o aplicativo. A pasta e o nome de arquivo padrão poderão ser configurados, como descrito mais adiante.

A imagem pode ser salva se clicar na seta que exite no botão Salvar e sair e depois na opção Salvar como... (&Ctrl;&Shift;S). Será aberta a janela padrão para salvar arquivos no &kde;, para que possa escolher o nome do arquivo, a localização da pasta e o formato que escolher para sua imagem. O nome indicado para o arquivo poderá, inclusive, ter o nome de uma imagem salva anteriormente. Também é possível selecionar a opção Salvar... (&Ctrl;S), que irá salvar a imagem com o nome e na pasta definidos como padrão.

### Capturar uma imagem

Para descartar a imagem atual e obter outra, clique no botão Capturar uma nova imagem (&Ctrl;N).

Pode-se configurar determinadas opções no lado direito da janela do aplicativo, antes de capturar uma nova imagem. Essas opções permitem-lhe selecionar a área da tela que será capturada, definir um tempo de espera até a captura da imagem e configurar se o ponteiro do mouse e/ou as decorações da janela deverão ser capturadas em conjunto com a imagem.

#### Modo de captura

A configuração do modo de captura permite-lhe definir a área da tela que deverá ser capturada e se deve existir um tempo de espera entre clicar no botão Capturar uma nova imagem (&Ctrl;N) e efetuar a captura da imagem. Também poderá ativar a opção Ao clicar, que irá desativar a função de atraso e efetuar a captura da imagem após o clique em algum local da tela. Nesse caso, é necessário primeiro clicar no botão Capturar uma nova imagem (&Ctrl;N).

A lista da Área permite-lhe definir a área da tela que deverá ser capturada. Existem cinco opções para escolher, como descrito em baixo.

- A opção Tela inteira (todos os monitores) captura uma imagem da sua área de trabalho completa, incluindo todas as saídas e monitores, projetores, etc.

- A opção Tela atual captura uma imagem da saída na qual o ponteiro do mouse estiver posicionado.

- A opção Janela ativa captura uma imagem da janela que estiver em primeiro plano. Pode ser uma boa opção inserir um tempo de espera neste modo, de forma a garantir o tempo necessário para selecionar e ativar uma janela antes de capturar a imagem.

- A opção Janela sob o cursor captura uma imagem da janela que estiver sob o ponteiro do mouse. Se o ponteiro estiver sobre um menu, o &spectacle; tenta capturar a imagem do menu, assim como da sua janela-mãe.

  Embora isso funcione na maioria das vezes, em algumas poderá não conseguir obter informações sobre a janela-mãe. Nesse caso, o &spectacle; retorna à forma tradicional de captura automática de imagem, capturando apenas uma imagem do menu. Também é possível forçar essa forma tradicional de captura de imagem, assinalando a opção Capturar apenas a mensagem atual nas Opções de conteúdo

- A opção Região retangular permite-lhe selecionar uma região retangular da sua área de trabalho com o seu mouse. Essa região poderá estar espalhada por saídas diferentes.

  Este modo não captura uma imagem imediatamente, mas permite-lhe desenhar um retângulo na sua tela, que poderá ser movido e dimensionado conforme a necessidade. Assim que o retângulo da seleção desejada for desenhado, se usar o clique duplo sobre qualquer ponto da tela ou pressionar a tecla &Enter; no teclado, irá capturar a imagem.

O campo incremental Atraso permite-lhe definir o tempo de espera entre clicar no botão Capturar uma nova imagem (&Ctrl;N) e a captura da imagem. Esse tempo pode ser ajustado com incrementos de 0,1 segundo (100 milissegundos).

Se ativar a opção Ao clicar irá substituir o atraso. Quando a opção estiver assinalada, ao clicar no botão Capturar uma nova imagem (&Ctrl;N), a janela do &spectacle; se ocultará o cursor do mouse será alterado para uma forma de mira. A imagem será capturada ao clicar com o botão esquerdo do mouse ou, se clicar qualquer outro botão, a ação será cancelada. Lembre-se de que não poderá interagir com o ambiente de trabalho com o mouse enquanto o ponteiro estiver em forma de mira, mas poderá usar o teclado.

#### Opções de conteúdo

A configuração das opções de conteúdo permite-lhe selecionar se o ponteiro do mouse deverá ser incluído nas imagens capturadas e se deseja incluir as decorações da janela em conjunto com a imagem da janela de um aplicativo. No modo Janela sob o cursor, também é possível selecionar se o &spectacle; deve apenas capturar a imagem do menu que estiver visível sob o cursor ou incluir a janela-mãe.

- Se ativar a opção Incluir ponteiro do mouse, a imagem do ponteiro do mouse irá integrar a imagem capturada.

- A opção Incluir as bordas e a barra de título da janela só ficará ativa quando o modo Janela ativa ou o Janela sob o cursor estiver selecionado na lista da Área de captura. Se assinalar esta opção, as bordas e a decoração da janela serão incluídas na imagem capturada, enquanto que desmarcá-la irá gerar uma imagem apenas do conteúdo da janela.

- A opção Capturar apenas a mensagem atual só fica ativa quando o modo Janela sob o cursor estiver selecionado na lista da Área. Assinalar esta opção irá capturar apenas o menu que estiver sob o cursor, sem sua janela-mãe.

## Funcionalidades adicionais

### Botões

Há cinco botões localizados na parte inferior da janela do &spectacle;. Suas funções estão descritas a seguir:

Ajuda

- Este botão apresenta-lhe um menu onde poderá abrir o Manual do &spectacle;, relatar um erro, mudar o idioma do aplicativo ou obter algumas informações Sobre o &spectacle; e Sobre o &kde;.

Abrir com...

- Este menu permite que a imagem capturada seja aberta diretamente em qualquer um dos programas que estiverem associados ao tipo MIME PNG (Portable Network Graphics). Dependendo de quais programas estiverem instalados, será possível abrir e editar a imagem capturada em seus aplicativos gráficos ou visualizadores preferidos.

  Além disso, se tiver os plugins do KIPI instalados, será capaz de enviar as imagens capturadas por e-mail e também exportá-las diretamente para redes sociais ou páginas Web.

Copiar para a área de transferência

- Este botão copia a imagem atual para a área de transferência. Também é possível usar as teclas de atalho &Ctrl;C para esse fim.

Salvar e sair

- Clicar neste botão irá salvar a imagem capturada como uma imagem PNG na sua pasta de imagens padrão e depois fechar do aplicativo.

  Além disso, se clicar na seta do lado direito do botão, um menu lhe permitirá Salvar a imagem, salvá-la com outro nome, localização e formato (Salvar como...), Imprimir a imagem e configurar as opções padrão, como o local de gravação padrão e qual o padrão de nomes para usar nos arquivos.

Descartar

- Descarta a imagem capturada e sai do aplicativo.

### Configurar as opções de gravação

Quando usar as funções Salvar e sair ou Salvar, o &spectacle; salva a imagem com um nome de arquivo padrão, na pasta de imagens da sua pasta pessoal. O nome do arquivo padrão inclui a data e hora em que a imagem foi capturada.

A opção para Configurar as opções de gravação permite-lhe definir o local e o padrão de nomes dos arquivos a salvar. Se clicar nessa opção, irá abrir uma caixa de diálogo como a seguinte: Configurar as opções de gravação A caixa de diálogo inclui alguma ajuda apropriada sobre a configuração das opções de gravação.

### Arrastar e soltar

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.

Se arrastar uma imagem para uma janela do gerenciador de arquivos, uma caixa de diálogo irá aparecer para indicação do nome do arquivo e seu formato, de forma a inseri-lo na pasta atual.

Se arrastar a imagem capturada para um campo de texto, será introduzido o caminho do arquivo temporário. Isso é útil, por exemplo, para enviar uma imagem através de formulários na Web ou anexar imagens em relatórios de erros no sistema de registro de erros do &kde;.

Isso funciona com todos os clientes que não recolhem os dados da imagem, mas apenas procuram por uma &URL; nos dados MIME arrastados.

## Créditos e Licença

Direitos autorais do programa © 2015 &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.

Partes do código são diretamente baseadas no código do projeto &ksnapshot;. Copyright © 1997-2011 dos programadores do &ksnapshot;. Estão disponíveis avisos de copyright detalhados nos cabeçalhos do código-fonte.

Partes do código são diretamente baseadas no código do projeto &kwin;. Copyright © 2008, 2013 dos programadores do &kwin;. Estão disponíveis avisos de copyright detalhados nos cabeçalhos do código-fonte.

Documentação baseada na documentação original do &ksnapshot;:

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

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

Tradução de André Marcelo Alvarenga alvarenga@kde.org

&underFDL; &underGPL;
&documentation.index;