# O Manual do &spectacle;

## Introdução

0 &spectacle; é uma aplicação simples para capturar imagens do ecrã. É capaz de capturar imagens do ecrã inteiro, de apenas um monitor, da janela activa de momento, da janela sob o cursor ou de uma região seleccionada. As imagens podem ser impressas, enviadas para outras aplicações ou gravadas numa variedade de formatos.

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

## Iniciando o &spectacle;

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

- No menu de lançamento de aplicações, o &spectacle;, pode ser encontrado em Aplicações Utilitários Programa de Captura do Ecrã &spectacle;.

- Se carregar na tecla Print do teclado, irá invocar imediatamente o &spectacle;. Adicionalmente, ficam disponíveis mais três combinações de teclas para efectuar capturas do ecrã e gravá-las na sua pasta de gravação por omissão sem mostrar a &GUI;:

  - O Meta Print irá fazer uma captura da janela activa

  - O &Shift;Print irá capturar todo o seu ambiente de trabalho, &ie; todos os monitores

  - O Meta&Shift;Print irá fazer a captura de uma região rectangular

  Poderá configurar a localização por omissão da gravação, bem como o nome do ficheiro, iniciando para tal o &spectacle; da forma normal e carregando depois no botão Configurar... e depois navegar para a secção de Gravação.

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

- O &spectacle; poderá ser iniciado a partir da linha de comandos. O &spectacle; tem um conjunto alargado de opções da linha de comandos, incluindo um modo em segundo plano que poderá ser usado para programar a captura de imagens sem mostrar a &GUI; ou sem necessitar da interacção do utilizador.

  Para iniciar o &spectacle; a partir da linha de comandos, escreva o seguinte:

      % spectacle &

  Para ver a lista completa das opções da linha de comandos, bem como uma explicação da mesma, escreva:

      % spectacle --help

## Usar o &spectacle;

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

O &spectacle; 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 &spectacle; é apresentada na janela de antevisão, que aparece do lado esquerdo da janela da aplicação &spectacle;.

A imagem pode ser gravada num local à sua escolha se carregar no botão Gravar Como ou se carregar em &Ctrl;&Shift;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. Poderá editar o nome do ficheiro para algo que desejar, incluindo o nome de uma fotografia gravada anteriormente.

Para gravar uma imagem no local predefinido, carregue na parte da seta do botão Gravar Como... e carregue em Gravar (&Ctrl;S). O novo modo de gravação será recordado da próxima vez. Poderá configurar o nome do ficheiro e o local predefinido de gravação, como é descrito mais tarde.

Para gravar rapidamente a imagem e sair do &spectacle;, assinale a opção Sair Depois de Gravar ou Copiar manualmente, carregue depois na seta ao lado de Gravar Como... e depois na opção Gravar (&Ctrl;S). Isto grava a imagem como um ficheiro PNG na sua pasta de Imagens predefinida, saindo da aplicação imediatamente. Como acima, este novo modo de gravação será recordado.

### Capturando uma Imagem

Quando abrir o &spectacle;, ele tira imediatamente uma fotografia de todo o ecrã como conveniência, mostrando uma antevisão do mesmo na janela principal. Poderá gravar esta imagem com os botões no fundo da janela, ou tirar uma nova com os controlos à direita da antevisão.

Para ignorar a fotografia actual e tirar outra, carregue no botão Tirar uma Nova Fotografia (&Ctrl;N).

Depois de capturar uma imagem do ecrã, o &spectacle; mostrar-lhe-á um painel informativo com uma ligação ao ficheiro da imagem e uma proposta para Abrir a Pasta Respectiva deste ficheiro.

Poderá configurar determinadas opções no lado direito da janela da aplicação, antes de tirar uma nova fotografia. Estas opções permitem-lhe seleccionar a área do ecrã que será capturada, definir um atraso antes da captura da imagem e configurar se o cursor do rato 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 do ecrã que deverá ser capturada e se deve existir um atraso entre carregar no botão Tirar uma Nova Fotografia (&Ctrl;N) e tirar a fotografia. Também poderá activar a opção Ao Carregar, que irá desactivar a função de atraso e tira apenas a fotografia depois de carregar nalgum lugar do ecrã, depois de carregar no botão Tirar uma Nova Fotografia(&Ctrl;N).

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

- A opção Ecrã Completo (Todos os Monitores) tira uma fotografia de todo o seu ecrã, dispersa por todas as saídas, incluindo todos os monitores, projectores etc.

- A opção Ecrã Actual tira uma fotografia da saída que contém o cursor do rato neste momento.

- A opção Janela Activa tira uma fotografia da janela que está de momento em primeiro plano. Aconselha-se que use algum atraso neste modo, para lhe dar tempo para seleccionar e activar uma janela antes de tirar a fotografia.

- A opção Janela Sob o Cursor tira uma fotografia da janela que está debaixo do cursor do rato. Se o cursor estiver sobre um menu, o &spectacle; tenta tirar uma fotografia do menu, assim como da sua janela-mãe.

  Embora isto funcione na maior parte dos casos, em alguns poderá não conseguir obter informações sobre a janela-mãe. Nesse caso, o &spectacle; volta à forma tradicional de capturar automaticamente a imagem, capturando apenas uma imagem com o elemento gráfico em questão. Poderá também forçar essa forma tradicional de capturar a imagem, assinalando a opção Capturar apenas o elemento gráfico actual nas Opções

- A opção Região Rectangular permite-lhe seleccionar uma região rectangular do seu ecrã com o seu rato. Esta região poderá estar dispersa por diferentes saídas.

  Este modo não tira imediatamente uma fotografia, mas permite-lhe desenhar um rectângulo no seu ecrã, o qual poderá ser movido e dimensionado se o desejar. Assim que o rectângulo da selecção desejado tiver sido desenhado, se fizer duplo-click sobre qualquer ponto do ecrã ou se carregar na tecla &Enter; do teclado, irá capturar a imagem.

  Poderá usar as teclas de cursores para mover e ajustar o rectângulo. Se carregar nas teclas de cursores, irá mover o rectângulo. Se mantiver a tecla &Shift; pressionada, enquanto carrega nas teclas de cursores, irá mover lentamente o rectângulo, para afinar melhor a sua selecção. Se mantiver pressionada a tecla &Alt; enquanto carrega nas teclas de cursores, irá ajustar o tamanho do rectângulo.

O campo incremental Atraso permite-lhe definir o atraso entre carregar no botão Tirar uma Nova Fotografia (&Ctrl;N) e tirar a fotografia em si. Este atraso pode ser ajustado com incrementos de 1 segundo, usando os botões do campo incremental ou usando o teclado.

Ao tirar uma fotografia com tempo de atraso, o &spectacle; mostra o tempo restante antes de tirar a fotografia no título da sua janela e coloca também visível no seu item do Gestor de Tarefas. O botão do Gestor de Tarefas do &spectacle; também mostra uma barra de progresso, para que possa ter uma ideia de quando será tirada a fotografia.

Ao esperar pela fotografia com tempo de atraso, poderá repor o &spectacle; para que o botão Tirar uma Nova Fotografia se transforme num botão Cancelar. A barra de progresso também será aqui apresentada, dando-lhe a hipótese de parar a contagem decrescente.

Se activar a opção Ao Carregar, irá substituir o atraso. Quando a opção estiver assinalada, ao carregar no botão Tirar uma Nova Fotografia (&Ctrl;N), irá esconder a janela do &spectacle; e mudar o cursor do rato para uma mira. A imagem é capturada quando pressionar o botão esquerdo do rato ou será interrompida se carregar com qualquer outro botão do rato. Lembre-se que não poderá interagir com o ambiente de trabalho com o rato, enquanto o cursor estiver como uma mira, mas poderá usar o teclado.

#### Opções

A configuração das Opções permite-lhe seleccionar se o cursor do rato deverá ser incluído nas fotografia se deseja capturar as decorações da janela em conjunto com a imagem da janela em questão. No modo Janela Sob o Cursor, também lhe permite seleccionar se o &spectacle; deverá capturar a imagem do menu actual sob o cursor ou também deve incluir a janela-mãe. Finalmente, a opção Sair Depois de Gravar ou Copiar, irá sair do &spectacle; depois de qualquer operação de gravação ou cópia.

- Se activar a opção Incluir o cursor do rato, irá incluir uma imagem do cursor do rato na fotografia.

- A opção Incluir a barra de título e contornos da janela só fica activa quando o modo da Janela Activa ou Janela Sob o Cursor estiverem seleccionados na lista da Área. Se assinalar esta opção, incluirá os contornos e a decoração da janela na fotografia tirada, enquanto que desligá-la irá gerar uma imagem apenas do conteúdo da janela.

- A opção Capturar apenas o elemento gráfico actual só fica activa quando estiver seleccionado o modo Janela Sob o Cursor na lista da Área. Se carregar nesta opção, irá capturar apenas o menu ou elemento gráfico sob o cursor, sem a sua janela-mãe.

- A opção Sair Depois de Gravar ou Copiar fará com que saia do &spectacle; depois de qualquer operação de gravação ou de cópia. Lembre-se que uma imagem copiada só ficará retida se estiver a executar um gestor da área de transferência que aceite imagens. O Klipper do KDE poderá ser configurado desta forma se carregar com o botão direito sobre o seu ícone, seleccionar a opção Configurar a Área de Transferência... e desligar a opção para Ignorar as imagens.

## Funcionalidades Adicionais

### Botões

Existem alguns botões localizados no fundo da janela do &spectacle;. As suas funções estão descritas em baixo:

Ajuda

- Dá-lhe os itens de menu comuns que estão descritos no Menu de Ajuda dos Fundamentos do &kde;.

Configurar...

- Dá-lhe acesso à janela de configuração do &spectacle;, onde poderá mudar a configuração da captura e a localização e nomenclatura por omissão dos ficheiros gravados.

Ferramentas

- Abre um menu que oferece várias ferramentas:

  - Abrir a Pasta de Fotografias irá realçar a última fotografia tirada no gestor de ficheiros predefinido

  - Acesso à janela para Imprimir

  - Uma oferta de programas externos para a Gravação do Ecrã

Exportar

- Abre um menu que lhe permite abrir directamente a fotografia com todos os programas associados ao tipo &MIME; PNG (Portable Network Graphics). Dependendo dos programas instalados, será capaz de abrir e editar a fotografia na sua aplicação gráfica ou visualizador.

  Para além disso, se tiver os 'Plugins' do KIPI instalados, poderá imprimir as suas capturas, enviá-las por e-mail ou exportá-las directamente para determinadas redes sociais e páginas Web.

Copiar para a Área de Transferência

- Este botão copia a fotografia actual para a área de transferência. Também poderá usar o a combinação de teclas &Ctrl;C para esse fim.

Gravar Como

- Grava a fotografia como uma imagem PNG na sua pasta de 'Imagens' predefinida, saindo imediatamente da aplicação.

### Configurar

Use o botão Configurar... para abrir a janela de configuração.

#### Geral

Geral

Carregue a tecla de fotografia para

- Quando for carregada uma combinação de teclas para tirar uma fotografia e o &spectacle; já estiver em execução, é possível configurar o comportamento do sistema de captura de fotografias. Poderá optar entre tirar uma fotografia nova, abrir uma nova janela do &spectacle; ou devolver o foco à janela existente do &spectacle;.

Depois de tirar uma fotografai

- Permite copiar a imagem para a área de transferência ou gravar automaticamente a imagem no local predefinido. A localização predefinida pode ser configurada com a página de configuração para Gravar.

Usar um fundo claro

- Usar uma cor de fundo clara para mascarar a área recortada no selector da região rectangular. Isto poderá fazer com que os cursores escuros sejam mais fáceis de ver.

Mostrar a lupa

- Quando for gravada uma imagem, copia a localização em que o ficheiro foi gravado para a área de transferência. Podê-la-á então colar em todo o lado onde seja aceite a introdução de texto. Lembre-se que precisa de estar a executar um gestor da área de transferência para manter a localização na área de transferência, após a saída do &spectacle;.

Aceitar ao carregar-e-largar

- Se estiver assinalada, aceita a região seleccionada, assim que o botão do rato for largado no modo de Região Rectangular.

  Ao seleccionar uma nova região, sem ter uma região anteriormente gravada disponível, se carregar, arrastar e largar o botão do rato irá capturar imediatamente a região seleccionada. Quando for apresentada uma região previamente gravada, a mesma poderá ser manipulada mais tarde, e a gravação desta região irá exigir uma confirmação manual (&Enter; ou duplo-click com o &LMB;). Se carregar e arrastar fora da região previamente gravada, irá capturar imediatamente a região recém-seleccionada.

Recordar a área seleccionada

- Por omissão, o &spectacle; recorda uma selecção inicial quando tira uma fotografia de uma região rectangular até que feche a janela do &spectacle;. Pode optar por o &spectacle; nunca recordar a última região seleccionada ou recordá-la entre sessões de capturas do ecrã.

#### Gravar

Quando usar a função Gravar, o &spectacle; grava a imagem, com um nome de ficheiro predefinido, na sua pasta de Imagens (que se encontra dentro da sua pasta pessoal). O nome do ficheiro por omissão inclui a data e hora em que a imagem foi capturada.

A página Gravar permite-lhe definir o nome do ficheiro e localização predefinidos. Se carregar nesta opção, irá invocar uma janela como a seguinte: Gravar

Localização da Gravação

- No campo de texto Localização, defina a pasta onde deseja gravar as suas fotografias, quando carregar em Gravar.

Copiar a localização da gravação para a área de transferência após a gravação

- Quando for gravada uma imagem, copia a localização em que o ficheiro foi gravado para a área de transferência. Podê-la-á então colar em todo o lado onde seja aceite a introdução de texto. Lembre-se que precisa de estar a executar um gestor da área de transferência para manter a localização na área de transferência, após a saída do &spectacle;.

Qualidade da Compressão

- Escolha a qualidade da imagem quando gravar com formatos de imagem com perdas, como o JPEG. Os valores mais elevados geram uma melhor qualidade, mas aumentam o tamanho do ficheiro. Veja a página do Wikipédia para saber mais detalhes sobre os formatos de imagem usados no &spectacle;.

Nome do Ficheiro

- Define um nome de ficheiro por omissão para as imagens gravadas.

  Poderá usar os seguintes itens de substituição no nome do ficheiro, os quais serão substituídos por texto real quando for gravado o ficheiro:

  - `%D`: Dia

  - `%H`: Hora

  - `%M`: Mês

  - `%Nd`: Número sequencial de N algarismos com preenchimento

  - `%S`: Segundo

  - `%T`: Título da janela

  - `%Y`: Ano (4 algarismos)

  - `%Nd`: Número sequencial

  - `%m`: Minuto

  - `%y`: Ano (2 algarismos)

  Poderá carregar nos itens de substituição, na lista de referências abaixo, para os inserir na linha do Nome do ficheiro.

  Se já existir um ficheiro com este nome, será adicionado um número de série ao nome do ficheiro. Por exemplo, se o nome do ficheiro for `Imagem`, e se já existir o `Imagem.png`, a imagem será gravada como `Imagem-1.png`.

  Se indicar uma extensão no nome do ficheiro, irá atribuir correctamente o formato da imagem e remover a extensão do campo do nome do ficheiro.

#### Atalhos

Esta página de configuração pode ser usada para mudar os atalhos predefinidos do &spectacle;. É possível configurar os atalhos para iniciar o &spectacle; e para capturar as diferentes partes do seu ecrã.

### Arrastar e Largar

Poderá arrastar uma imagem captura para outra aplicação ou documento. Se a aplicação for capaz de lidar com imagens, será inserida uma cópia da imagem total nela.

Se arrastar uma fotografia para uma janela de gestão de ficheiros, irá aparecer uma janela onde poderá modificar o nome do ficheiro e seleccionar o formato da imagem, sendo o ficheiro depois gravado na pasta respectiva.

Se arrastar a fotografia para um campo de texto, será introduzida a localização do ficheiro temporário gravado. Isto é útil, por exemplo, para enviar uma imagem em formulários Web ou para anexar as fotografias nos relatórios de erros no gestor de erros do &kde;.

Isto funciona com todos os clientes que não conseguem processar os dados da imagem, mas que precisam apenas de um &URL; nos dados MIME arrastados.

## Créditos e Licença

Programa com 'copyright' © 2015 de &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.

Partes do código são baseadas directamente no código do projecto &ksnapshot;. 'Copyright' © 1997-2011 da equipa do &ksnapshot;. Estão disponíveis avisos de direitos de cópia detalhados nos cabeçalhos do código-fonte.

Partes do código são baseadas directamente no código do projecto &kwin;. 'Copyright' © 2008-2013 da equipa do &kwin;. Estão disponíveis avisos de direitos de cópia 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 Nuno Donato nunodonato@iol.pt

&underFDL; &underGPL;
&documentation.index;