# O Manual do &palapeli;

## Introdução

O &palapeli; é um jogo de 'puzzles' para um único jogador.

A janela do &palapeli; está dividida em duas áreas, a colecção e a mesa. Este manual irá prosseguir com a descrição destas duas áreas.

## Navegar pela colecção de 'puzzles'

Quando lançar o &palapeli; pela primeira vez, a sua colecção de 'puzzles' é previamente carregada com alguns 'puzzles' que vêm com o &palapeli;. Carregue num dos 'puzzles' para começar a jogar imediatamente. O jogo toma lugar na mesa do 'puzzle'; veja a secção seguinte para saber como usar a mesa do 'puzzle'.

Para além de seleccionar um 'puzzle', a colecção de 'puzzles' poderá ser usada para as seguintes acções:

- criar 'puzzles' novos, a partir de imagens no seu disco

- importar os 'puzzles' feitos por outros

- exportar os 'puzzles', de modo a partilhá-los com os seus amigos e com todo o mundo

- apagar os 'puzzles' que não necessita mais

A secção seguinte mostra como efectuar estas tarefas com os botões da barra de ferramentas.

### Introdução à barra de ferramentas

Poderá seleccionar os 'puzzles' na lista, carregando para tal no &Ctrl; e no &LMB; em conjunto. Se carregar no &LMB; ou no &RMB; sem o &Ctrl;, irá abrir o 'puzzle' em questão na mesa do 'puzzle'.

Criar um novo 'puzzle'

- Abre uma janela que lhe permite criar um 'puzzle' a partir de uma imagem no seu disco. Veja a secção seguinte para obter mais detalhes.

Apagar

- Todos os 'puzzles' que tiver seleccionado na lista de 'puzzles' serão removidos permanentemente da sua biblioteca.

  Esta acção não poderá ser anulada.

Importar de ficheiro

- Quando tiver recebido um ficheiro de 'puzzle' do &palapeli; (que poderá ser normalmente reconhecido pela extensão `*.puzzle`), poderá usar esta acção para o importar para a sua colecção local. Também poderá montar um 'puzzle', carregando simplesmente num ficheiro de 'puzzle' a partir do seu gestor de ficheiros preferido só que, após a importação, o 'puzzle' irá aparecer na sua colecção local, pelo que poderá apagar em segurança o ficheiro do 'puzzle' obtido.

Exportar para ficheiro

- Isto irá exportar os 'puzzles' seleccionados de momento para ficheiros, de modo a poder dá-los aos seus amigos, publicá-los na Web ou criar cópias de segurança da sua colecção.

## Criar 'puzzles' novos

Como foi descrito na secção anterior, poderá criar 'puzzles' novos s carregar no botão Criar um novo 'puzzle' na colecção de 'puzzles'.

Se carregar neste botão, irá abrir a janela de criação de 'puzzles', que consiste em três páginas:

1. Na primeira página, seleccione um ficheiro de imagem que será dividida em peças. Certifique-se que introduz os meta-dados correctos para a imagem: Deverá atribuir o autor da imagem (⪚ o fotógrafo ou o pintor); respeite por favor os direitos de cópia do autor da imagem.

2. Na segunda página, poderá seleccionar o tipo de peças em que ficará dividida a imagem. O &palapeli; vem com uma colecção de divisões pré-instaladas, mas poderá usar as divisões criadas por terceiros.

3. Na página final da janela, a divisão seleccionada poderá ser ainda personalizada ⪚ ao escolher um número de peças diferente ou ajustando os parâmetros da forma da peça. O conjunto de peças disponível depende da divisão que tiver sido seleccionada.

Este manual irá continuar a descrever as divisões que vêm com o &palapeli;. Se tiver transferido um 'plugin' de divisão de terceiros para o &palapeli;, veja por favor a documentação deste 'plugin' caso tenha problemas a instalá-lo ou a usá-lo no seu sistema.

### &psc;

O &psc; produz peças de 'puzzle' realistas com diversos padrões básicos:

Grelha rectangular

- Contém as peças rectangulares, já bastante conhecidas.

Grelha Cairo

- Com as suas peças pentagonais e ângulos de arestas irregulares, é relativamente difícil de compor, dado que as peças se encaixam em conjunto de uma forma não-familiar.

Grelha hexagonal

- Produz peças hexagonais, organizadas como células em favos.

Grelha Rotrex

- Através de uma composição especial de peças triangulares, hexagonais e rectangulares, as peças formam um padrão que faz lembrar vários círculos em intersecção.

Grelha irregular

- Esta grelha está disponível apenas se tiver instalado o qvoronoi do pacote qhull. O qvoronoi é usado para calcular formas de peças irregulares a partir de vários pontos colocados de forma aleatória.

O &psc; tem vários parâmetros que controlam a aparência das arestas das peças, especialmente os encaixes nas mesmas. São fornecidos valores por omissão para todos estes parâmetros. Está disponível um modo de predefinição adicional que reduz a quantidade de parâmetros ao mínimo necessário. Normalmente, estão disponíveis os seguintes parâmetros:

Número aprox. de peças

Percentagem de lados invertidos

- A probabilidade de cada encaixe ficar invertido. Um encaixe é considerado invertido se apontar na direcção oposta a que deveria apontar numa grelha completamente regular. Na grelha rectangular, isso resulta em peças com 3 ou 4 encaixes que apontam para dentro ou para fora, respectivamente. Posicione a barra à esquerda para obter uma grelha perfeitamente regular. No meio, a orientação dos encaixes é aleatória. À direita, a grelha fica regular de novo, mas com uma regra "alternada". Isto não significa uma inversão de todos os encaixes: Na grelha regular alternada, por exemplo, cada peça tem quatro encaixes que apontam para dentro ou para fora. Esta opção não faz efeito na grelha irregular.

Curvatura das arestas

- Define quão curvilíneas são as peças, &ie; com que força os contornos sobressaem ou se recolhem. Mova a barra para o extremo esquerdo para obter linhas de arestas rectas (excepto nos encaixes).

Tamanho do encaixe

- Define o tamanho da parte do encaixe de cada aresta. A opção por omissão (no meio da barra) é escolhida de forma para parecer um 'puzzle' real. A barra vai de 50% até 150% deste tamanho, o que irá parecer desmesuradamente grande. O programa tenta ao máximo evitar as colisões entre encaixes. As arestas em colisão são reorganizadas várias vezes e encolhidas em pequenos passos. Contudo, existem ainda alguns casos em que não seja possível achar uma solução, especialmente no caso de tamanhos de encaixes grandes.

Diversidade das curvas

- Define como é que a curvatura (ver acima) varia entre arestas. Mova a barra para a esquerda para fazer com que as reentrâncias se pareçam todas iguais entre si. À direita, poderão existir alguns contornos muito rectos ou muito curvilíneos.

Diversidade da posição do encaixe

- Define como é que a posição do encaixe na aresta varia. No extremo esquerdo, os encaixes ficam fixos no meio da sua aresta.

Diversidade dos encaixes

- Define quão individuais ficam os encaixes. No extremo esquerdo, os encaixes parecem todos iguais. No extremo direito, cada encaixe será uma peça de arte única desenhada especialmente para si.

Irr.: Diversidade do tamanho das peças

- Apenas na grelha irregular: Define como é que o tamanho da peça varia. Uma opção muito baixa corresponde a uma variação praticamente nula, onde poderá aparecer uma estrutura ligeiramente cristalizada. Os valores mais altos produzem peças muito grandes e muito pequenas.

Apresentar a imagem da grelha

- Grava uma imagem da grelha (arestas pretas num fundo branco) em `~/goldberg-slicer-dump.png`. Se já existir uma gravação anterior, será sobreposta.

### Divisões legadas

Por razões históricas, o &palapeli; também inclui as divisões "Peças de 'puzzle' clássicas" e "Peças rectangulares". Estas divisões criam peças rectangulares simples com ou sem encaixes. Ambas as divisões permitem ajustar o número de peças e as proporções. Se arrastar a barra da proporção para a esquerda, irá resultar em peças altas, enquanto se arrastar para a direita produz peças largas. A selecção por omissão produz peças aproximadamente quadradas.

## Jogar na mesa do 'puzzles'

A mesa do 'puzzle' (detalhe)

O objectivo do jogo é juntar as peças indicadas numa imagem.

As peças podem ser movidas à vontade, carregando e arrastando as mesmas com o &LMB;. Poderá seleccionar várias peças de uma vez, mantendo pressionada a tecla &Ctrl; e carregando nelas, ou arrastando uma área em torno delas com o &LMB;.

Poderá mover as peças à vontade, bastando carregar nelas e arrastá-las. Quando colocar uma peça próxima de outra peça vizinha, ambas ficarão coladas automaticamente (1). Depois de se terem encaixado, já não podem ser mais separadas. Ao contrário da realidade, não poderá combinar duas peças que não sejam verdadeiramente vizinhas.

A barra de progresso, por baixo da mesa do 'puzzle', indica a sua evolução (2). O &palapeli; irá gravar automaticamente o seu progresso após cada jogada, pelo que não terá de se preocupar em gravar explicitamente.

Com a roda do rato, ou com a barra no canto inferior direito (3), poderá alterar o nível de ampliação da mesa do 'puzzle'. Se carregar com o &RMB;, poderá mover a área de visualização da mesma.

O movimento das peças é limitado pela área da mesa do 'puzzle'. Esta área está representada no fundo da mesa do 'puzzle' por uma sombra rectangular clara. Quando mover as peças para o extremo da área da mesa do 'puzzle' (4), a área irá expandir automaticamente, de modo a ter mais espaço para movimentar as suas peças. Perto dos contornos sombreados, o cursor do rato muda para uma seta de duas pontas, a qual indica que poderá ajustar a área da mesa do 'puzzle' se carregar e arrastar a mesma com o &LMB;.

Poderá bloquear a área da mesa do 'puzzle' com o pequeno botão (5), logo a seguir à barra de progresso. A área em torno da mesa do 'puzzle' (4) irá escurecer e as peças irão parar e mover-se-ão para os extremos da área da mesa. Continua a ser possível ajustar manualmente a área da mesa do 'puzzle'.

### Interacções com o rato

Como foi descrito na secção anterior, existem diversas formas de interagir com a mesa do 'puzzle' do &palapeli;, usando para tal o rato. Poderá configurar à vontade as acções que são despoletadas por determinados botões do rato. (Veja a secção de Configuração do Jogo para obter mais informações sobre a configuração). A seguinte lista resume todas as acções do rato possíveis:

Mudar o tamanho da mesa do puzzle ao arrastar os seus extremos

- Por omissão, esta acção está associada ao &LMB;.

Mover as peças por arrastamento

- Quando carregar e arrastar uma peça do 'puzzle', esta peça será movida. Se estiverem várias peças seleccionadas e depois carregar e arrastar uma delas, então todas as peças mover-se-ão. Por omissão, esta acção está associada ao &LMB;.

Mover a área de visualização por arrastamento

- Por omissão, esta acção está associada ao &RMB;.

Seleccionar várias peças de uma vez

- Quando carregar numa área vazia da mesa do 'puzzle', em vez de carregar numa peça, poderá arrastar uma área inteira. Quando largar o botão do rato, todas as peças dentro dessa área ficarão seleccionadas. Todas as outras peças ficarão desmarcadas. Por omissão, esta acção está associada ao &LMB;.

Seleccionar as peças ao carregar

- Quando carregar numa única peça do 'puzzle', esta ficará seleccionada. Se já estava seleccionada, deixará de o estar. Por omissão, esta acção é atribuída ao &LMB; e só fica disponível quando tiver o &Ctrl; carregado.

Comutar o estado de bloqueio da área da mesa do 'puzzle'

- Esta acção é idêntica a carregar no botão (5) da barra de estado. Por omissão, esta acção não está associada a nenhum botão do rato, mas você podê-la-á activar com a janela de configuração.

Deslocar a área de visualização na horizontal e Deslocar a área de visualização na vertical

- Por omissão, esta acção está associada à roda do rato, mas podê-la-á activar com a janela de configuração.

Ampliar a área de visualização

- Esta acção é idêntica a mover a barra deslizante (3) na barra de estado. Esta acção está atribuída à roda do rato, por omissão.

### Introdução à barra de ferramentas

Reiniciar o 'puzzle'

- Elimina o progresso gravado para este 'puzzle'.

## Apresentação à Interface

A duas áreas do &palapeli;, a colecção e a mesa, estão incorporadas no menu como páginas. Existem também dois menus com acções-padrão, os quais estão descritos em baixo.

### O Menu Configuração

Configuração Mostrar a barra de estado da mesa

- Activar ou desactiva a visualização da barra de progresso e os botões respectivos, por baixo da mesa do 'puzzle'. Esta acção não irá mudar nada na colecção de 'puzzles'.

Configuração Configurar os Atalhos...

- Abre uma janela onde poderá configurar as teclas de atalho do &palapeli;

Configuração Configurar o &palapeli;...

- Abre uma janela de configuração do jogo. Veja a secção da Configuração do Jogo para mais detalhes.

### O Menu Ajuda

&help.menu.documentation;

## Configuração do Jogo

Para abrir a janela de configuração, use a opção do menu: Configuração Configurar o &palapeli;...

### Configuração geral

Fundo

- Permite-lhe escolher outra textura de fundo para a mesa do 'puzzle'. Se escolher uma única cor, em vez de uma textura, o botão por baixo da área de selecção poderá ser usado para definir essa tal cor única.

Aparência das peças

- Controla a aparência das peças na mesa do 'puzzle'. Se o &palapeli; estiver a executar de forma lenta ou quando os 'puzzles' levam muito tempo a abrir, poderá desactivar os efeitos gráficos nesta categoria para acelerar tudo.

Precisão do ajuste

- Permite-lhe seleccionar quão próximas as peças vizinhas deverão estar para se encaixarem em conjunto. Se mover a barra mais para a direita, as peças encaixar-se-ão mesmo que não estejam muito próximas. Isto torna o jogo um pouco mais simples de jogar.

### Interacção do rato

Esta página da janela de configuração permite-lhe atribuir as interacções do rato descritas na secção Jogar na mesa do 'puzzle' aos diferentes botões do rato. As interacções são divididas entre as que podem ser atribuídas aos botões do rato (⪚ Mover a área de visualização por arrastamento) e as que podem ser atribuídas à roda do rato (⪚ Deslocar a área de visualização na horizontal).

#### Página de Botões do rato

A seguir ao nome de cada interacção, existe um botão com uma imagem de um rato de computador que mostra a acção atribuída de momento. Poderá configurar a interacção, carregando para tal nesse botão com o &LMB; e depois com o botão do rato que deseja atribuir a essa interacção. Se carregar em teclas modificadoras, quando carregar pela segunda vez, a mesa do 'puzzle' irá permitir essa interacção apenas quando estiver a pressionar essas teclas.

Em vez de carregar, poderá também pressionar a tecla Espaço, de modo a atribuir o Sem-Botão especial a esta interacção. Isto só é permitido caso as teclas modificadoras estejam a ser pressionadas. O Sem-Botão significa que as teclas modificadoras irão ocupar o papel do botão do rato. A interacção começa quando carregar nas teclas modificadoras, terminando quando uma delas for libertada.

#### Página da Roda do rato

Esta página funciona de forma semelhante à anterior. Quando o botão à direita pedir a introdução de dados, terá de movimentar a roda do rato em vez de carregar num botão do mesmo. Também é permitido manter pressionadas as teclas modificadoras, tendo a mesma consequência que o caso anterior.

Se o seu rato tiver uma roda bidireccional (como acontece normalmente nos ratos por toque dos portáteis), poderá tirar partido desta: O botão irá reconhecer se o utilizador moveu a roda na horizontal ou na vertical.

## Créditos e Licença

O &palapeli; permite trazer a diversão e o desafio dos 'puzzles' para o seu ambiente de trabalho.

A ideia foi desenvolvida em primeiro lugar por Bernhard Schiffner, em conjunto com o Stefan Majewsky, que é o actual programador-chefe do &palapeli;. O &psc; foi contribuído por Johannes Löhnert.

Documentação com 'copyright' 2009, 2010 Johannes Löhnert, Stefan Majewsky.

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Instalação

&install.intro.documentation;

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;