# O Manual do &kenolaba;

## Introdução

O &kenolaba; é um jogo simples de estratégia em tabuleiro que é jogado por duas pessoas. Existem peças vermelhas e amarelas para cada um dos jogadores. A partir do início, em que cada jogador tem 14 peças, são realizados movimentos até que um jogador tenha empurrado para fora do tabuleiro 6 peças no adversário.

O programa original foi desenvolvido em 1993 para o DOS e para o Xlib puro. Para o &kde; houve uma grande reescrita.

Se conheces o jogo de tabuleiro Abalone, irás gostar deste programa. De facto, este programa foi inspirado no jogo mencionado. O Abalone é uma marca registada da Abalone SA, França.

## Regras do Jogo

O vermelho joga sempre primeiro.

São permitidos dois tipos de movimentos:

Normal

- Podem ser movidas uma, duas ou três das suas peças em fila numa das 6 direcções. Também são permitidos movimentos laterais.

  Carrega no botão esquerdo do rato na primeira peça que queres mexer. A peça ficará realçada. Agora arrasta o rato na direcção desejada. Se o movimento for válido, o cursor irá mudar para uma seta nessa direcção e todas as peças do movimento ficarão realçadas. Se este for o movimento que queres fazer, larga o botão do rato.

  Os movimentos laterais são feitos de outra maneira: para duas peças adjacentes carrega entre elas e arrasta-as; para três peças carrega no botão do meio na peça do meio - se for permitido um movimento lateral para as peças elas ficarão realçadas. Caso contrário só a do meio ficará realçada e farás um movimento normal.

Empurrar

- Podes empurrar um máximo de duas peças do adversário à frente das tuas peças desde que o número de peças que movas seja maior do que as do opositor que empurras. Isto significa que três peças tuas podem empurrar uma ou duas peças do adversário, assim como com duas só podes empurrar uma.

  Os movimentos de empurrão especiais são aquelas em que empurras uma peça do adversário para fora do tabuleiro. Se empurrares seis peças do adversário para fora ganhaste.

Se continua a não saber como é o &kenolaba;, veja um jogo em que o computador jogue pelos dois lados. Depois de executar o &kenolaba;, seleccione Configuração Joga o Computador Ambos e inicie um novo jogo.

## Jogo em Rede

### Jogo Normal em Rede

O &kenolaba; pode ser jogado através da rede. Isto permite a duas pessoas jogarem uma contra a outra em computadores diferentes, ou a uma pessoa observar o jogo de outro &kenolaba;. Para usar a opção de rede do &kenolaba;, este deve estar definido para Modo Rede seleccionando Jogo Rede.

Todos os programas do &kenolaba; que estejam em modo Rede difundem as posições alteradas aos outros.

Para trocarem as posições, os programas do &kenolaba; devem-se avisar uns aos outros. Se estiverem na mesma máquina, não é necessário nada (à parte de estarem em Modo Rede). Se estiverem a correr em computadores diferente tens de especificar a outra máquina na linha de comandos com a opção `-h`, tal como se segue:

    %kenolaba -h NomeDaMáquina

Para os curiosos: o &kenolaba;, quando está em Modo Rede, fica à espera num 'socket' de TCP pelas mudanças de posição dos outros programas do &kenolaba;. Podes especificar o número do porto com a opção da linha de comandos `-p`. Precisas disto se quiseres jogar dois jogos de &kenolaba; em rede diferentes.

#### Exemplos

- O Carlos na `maquina1` e a Maria na `maquina2` querem jogar um contra o outro: a Maria apenas inicia o &kenolaba;, altera em Opções Joga o computador para Nenhum e muda para Modo Rede. O Carlos inicia o &kenolaba; com

      %kenolaba -h maquina2

  e depois faz o mesmo que a Maria. Agora um dos dois pode iniciar o jogo e mexer as peças vermelhas. Cada vez que a posição é alterada num programa, altera automaticamente no outro também.

- O João quer observar o jogo: ele faz o mesmo que o Carlos, mas ele próprio não joga.

- Dois jogos em rede do &kenolaba; irão correr entre as máquinas `m1` e a `m2`. Para distinguir os jogos, usamos o porto 12345 numa delas. Na `m1` iniciamos como de costume:

      %kenolaba

  para o primeiro jogo, e (não como de costume):

      %kenolaba -p 12345

  para o segundo. Na `m2` iniciamos o primeiro jogo com:

      %kenolaba
      -h m1

  e o segundo com:

      %kenolaba -h m1:12345

  (Os dois pontos separam a máquina e o porto como num &URL;).

## Opções Avançadas

### Modo de Modificação

Podes editar as posições actuais do tabuleiro seleccionando Editar Modificar para pôr o &kenolaba; em modo de modificação. Podes adicionar peças vermelhas ou amarelas ou retirá-las. A linha de estado mostra o número de peças amarelas e vermelhas, o número do movimento, quem deve jogar a seguir e se a posição é válida: um ponto de exclamação significa que não, um símbolo para assinalar significa que sim.

Se a posição é inválida e mudares para o modo de jogo, não poderás jogar! Só se podem usar posições válidas para o início de um jogo.

As opções de Retirar e Frente simplesmente incrementam e decrementam o número do movimento, mas não alteram nenhumas peças.

#### Utilização

Carregando no botão esquerdo ou direito do rato num campo vazio ou amarelo tu entras em modo de adição de peças vermelhas; se carregares com o botão do meio num campo vermelho ou vazio, entras em modo de adição de peças amarelas. Finalmente, se carregares com o botão esquerdo ou o direito numa peça vermelha, ou com o botão do meio numa peça amarela, entras no modo de remoção de peças. Qualquer peça sobre a qual o rato passe com o botão carregado será apagada.

Para sair do modo de modificação e entrar no modo de jogo, basta desligares a opção Modificar no menu Editar.

##### Usar a Área de Transferência

O tabuleiro actual do &kenolaba; pode ser copiado para a área de transferência usando o comando Copiar no menu Editar e pode ser colado através da opção Colar. Desta maneira podes copiar as posições do tabuleiro dum programa do &kenolaba; para outro carregando em Copiar num programa e em Colar no outro, mas isto é mais fácil com o Modo de Rede (ver acima). Outra utilização é a gravação das posições num ficheiro de texto (usando o Copiar e um editor à tua escolha) e obter uma posição posteriormente seleccionando-a no editor e colando-a no &kenolaba;.

### Nível do Computador

O computador pode jogar em quatro níveis diferentes, nomeadamente:

- Fácil

- Normal

- Difícil

- Desafio

Quanto mais difícil o nível, mais tempo o computador leva a procurar um movimento. Podes interromper a pesquisa carregando na tecla S.

### Espiar

A opção de Espiar pode ser ligada e desligada no menu Configuração e a opção Espiar. Se for a tua vez, podes ver a classificação da jogada que queres fazer na barra de estado. Se for a vez do computador podes ver (na barra de estado e nas peças realçadas) o movimento que ele pensa ser o melhor a jogar. Claro que isto muda à medida que ele pesquisa.

### Seleccionar qual a cor com que o computador joga

Podes fazer com que o computador jogue com as peças vermelhas, amarelas ou com ambas. Escolhe de entre estas opções antes de começares um novo jogo. Claro que isto funciona se quiseres mudar de lado também. Escolhe Nenhum para jogar contra outra pessoa. Isto é bastante útil no modo de rede.

## Configuração Avançada

O &kenolaba; oferece opções avançadas de configuração, o que lhe permite alterar todo o sistema de pontuação, se assim o desejar. Para aceder a essas opções avançadas, seleccione Configuração Configurar o Kenolaba. À medida que altera as opções, a pontuação que as suas configurações modificadas dão para a jogada actual é mostrada na parte inferior da janela, a seguir a Avaliação da posição actual.

### A Página Jogadas

O número de pontos adicionados ao total para cada tipo de jogada podem ser modificados aqui, dependendo do tipo de jogada e do número de peças envolvidas. As jogadas estão divididas em três tipos:

Normal

- Uma jogada normal é aquela em que tu moves uma ou mais peças tuas, mas não empurras nenhuma peça do teu adversário.

Empurrar

- Uma jogada para empurrar é aquela em que tu forças uma ou mais peças do teu adversário a mudar de posição, empurrando-as, embora se mantenham no tabuleiro.

Empurrar para Fora

- Numa jogada 'Empurrar para Fora' colocas um ou mais peças do teu adversário fora do tabuleiro.

### A Página Posição

O número de pontos adicionados à pontuação total para uma posição do tabuleiro está dependente do anel do tabuleiro onde as peças estão. Para cada anel, do centro para fora, pode ser definida uma pontuação média adicional, com um intervalo +/-. A pontuação atribuída para uma posição em particular varia aleatoriamente de acordo com o intervalo +/-. Isto é para evitar que os jogos do computador com ele próprio entrem em ciclo infinito.

### A Página Em-linha

Para cada vez que o número de peças em linha ocorre, é adicionado o número de pontos indicado à pontuação, como por exemplo X O O O adiciona a pontuação para três em linha, e também duas vezes a pontuação para dois em linha.

### A Página Contagem

Adiciona um dado número de pontos baseado na diferença do número de bolas de ambos os jogadores, de 1 bola a mais até 5 bolas a mais. Se existir uma diferença de 6 bolas, o jogo acaba.

## Referência do Menu

O movimento das peças é explicado nas Regras do Jogo. Os botões na barra de ferramentas têm o mesmo significado que as opções dos menus Jogo ou Editar.

### O Menu Jogo

&Ctrl;N Jogo Novo

- Inicia um novo jogo mesmo que já esteja um a decorrer.

S Jogo Parar Pesquisa

- Quando o computador está a pensar, a sua pesquisa em profundidade é interrompida e ele joga o melhor movimento que encontrou até à altura.

PgUp Jogo Retirar

- Volta atrás na tua jogada anterior. São permitidas as anulações de dois (!) movimentos: o do adversário e o teu último movimento. Por isso é a tua vez de novo. São recordados 100 movimentos; por isso, não hesites em voltar atrás nas jogadas até ao início do jogo (mais rápido se carregares em F2). Se estiveres em modo de modificação (ver Editar Modificar em baixo), decrementa o número do movimento desta posição.

PgDown Jogo Frente

- Só é útil no modo de modificação. Incrementa o número do movimento desta posição.

H Jogo Dica

- É mostrada uma sugestão para o teu próximo movimento. Só é possível se estiveres a jogar no nível normal ou superior, o número do movimento for o 2 e não tiveres anulado o teu movimento.

N Jogo Jogo em Rede

- Se esta opção estiver ligada, a aplicação fica em modo de rede.

&Ctrl;Q Jogo Sair

- Sai do &kenolaba;.

### O Menu Editar

&Ctrl;C Editar Copiar

- Copia uma representação do tabuleiro do &kenolaba; para a Área de Transferência

&Ctrl;V Editar Colar

- Interpreta o conteúdo da área de transferência do X como uma representação em ASCII dum tabuleiro do &kenolaba;, e copia-o para o tabuleiro actual. Gera-se uma representação em ASCII através do Copiar.

&Ctrl;Ins Editar Modificar

- Muda o &kenolaba; para o modo de modificação.

&Ctrl;S Editar Gravar Posição

- Grava a posição actual para ser obtida posteriormente através da opção Editar Carregar Posição .

&Ctrl;O Editar Carregar Posição

- Recupera o estado do tabuleiro guardado no ficheiro de configuração do &kenolaba; através de Editar Gravar Posição.

### O Menu Configuração

&Ctrl; M Configuração Mostrar Menu

- Mostra ou esconde a barra de menu do &kenolaba;.

Configuração Mostrar Barra de Ferramentas

- Mostra ou esconde a barra de ferramentas do &kenolaba;.

Configuração Mostrar Barra de Estado

- Mostra ou esconde a barra de estado do &kenolaba; na base do ecrã.

Configuração Gravar Configuração

- Guarda a configuração actual para a tornar por omissão para o &kenolaba;.

Configuração Configurar Teclas...

- Traz a janela de configuração de teclas normal do &kde; para configurares os atalhos de teclado usados pelo &kenolaba;.

Configuração Configurar Barras de Ferramentas...

- Mostra a janela de configuração das barras de ferramentas normal do &kde; para personalizares a barra de ferramentas do &kenolaba;.

Configuração Nível

- Selecciona o nível com que o computador joga. Pode ser um dos seguintes:

  - Fácil

  - Normal

  - Difícil

  - Desafio

Configuração Computador Joga com as

- Escolhe com que cores o computador joga. Pode ser uma das seguintes:

  - Vermelhas

  - Amarelas

  - Ambas

  - Nenhumas

Configuração Mover Devagar

- Quando esta opção está seleccionada é desenhado o movimento da jogada do computador, piscando e realçando as peças usadas na jogada. Desliga esta opção se não quiseres esperar por esta animação. Nesse caso só um realce rápido é efectuado.

Configuração Rasterizar Peças

- Se estiver seleccionada, as peças são desenhadas 'online' por um 'ray-tracer' interno simples quando necessário (p.ex. ao redimensionar a janela).

Configuração Espiar

- Se estiver seleccionada, permite espiar o adversário.

### O Menu Ajuda

&help.menu.documentation;

## Opções da linha de comandos

    kenolaba

    -p
    MyPortNumber

    -h
    host:port

Com o `-p` especificas o número do porto onde irás receber ligações de TCP para o modo de rede.

Com o `-h` especificas um processo remoto do &kenolaba; (com um número de porto opcional, se não usares o porto por omissão da máquina remota) para comunicar com ela no modo de rede. Podes especificar vários processos remotos.

## Créditos & Licenças

&kenolaba;

Programa copyright 1997-2000 Josef Weidendorfer Josef.Weidendorger@gmx.de

Documentação Original de Robert Williams rwilliams@kde.org e Josef Weidendorfer

Documentação actualizada para o &kde; 2.0 por Philip Rodrigues philip.rodrigues@ntlworld.com

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kenolaba;

&install.intro.documentation;

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

&install.compile.documentation;