# O Manual do &kolf;

Jason
Katz-Brown

    jasonkb@mit.edu

José
Pires

    jncp@netcabo.pt

Tradução
&FDLNotice;
2005-12-18
1.1

O &kolf; é um jogo de golfe em miniatura para o &kde;.

KDE
golfe
miniatura
arcada

## Introdução

O &kolf; é um jogo de golfe em miniatura com gráficos em bloco e com uma vista 2D de cima para baixo. Os níveis são dinâmicos e até 10 pessoas poderão jogar de uma vez em simultâneo.

O &kolf; vem com um nível de tutorial. Se Jogar este nível, será a melhor forma de se preparar.

## Tutorial

O modo de jogo do &kolf; é simples. É mais fácil de aprender como jogar com as mãos na massa e, por isso, vem incluído um campo de tutorial para o guiar pelas noções básicas. Este capítulo conduzi-lo-á através deste tutorial. Para dar início a este tutorial, escolha a opção Ajuda Tutorial.

### Acertar na Bola

Para apontar a bola, poderá tanto alinhar o rato por trás da bola para que o taco aponte na direcção em que deseja acerta na bola ou carregue numa das teclas: Esquerda (no sentido contrário ao dos ponteiros do relógio) ou Direita (no sentido dos ponteiros do relógio), para rodar o taco.

Para rodar o taco mais depressa com o teclado, mantenha pressionada a tecla Shift enquanto carrega ou mantém carregadas as teclas dos cursores. Para rodar mais devagar, mantenha carregada a tecla Control.

Para acertar na bola, carregue e mantenha carregado o &LMB; ou a tecla de cursor Baixo. Quanto mais tempo mantiver carregada a tecla ou o botão, mais força terá a tacada. Irá exigir alguma prática para que tenha uma boa noção da velocidade.

Para interromper a tacada enquanto ainda mantém o taco sobre tensão, carregue em Escape.

Acerte com a bola no buraco (o círculo cinzento) para passar para o próximo.

### Rampas

As rampas são áreas inclinadas onde a bola rola de uma forma esperada. A luz do campo de golfe vem do canto superior esquerdo, de modo a que as rampas mais brilhantes irão empurrar a bola para o canto superior esquerdo do buraco. Escolha a opção Buraco Mostrar Informação para ver uma seta que aponta na direcção em que a rampa fará rolar a bola.

Neste buraco de tutorial, acerte na bola para que vá para a rampa que aponta para cima, e deixar que ela rebole para a cova, de modo a passar para o próximo buraco.

#### Direcções

No próximo buraco, experimente com os outros tipos de rampas. Existem rampas elípticas, verticais, horizontais e diagonais no &kolf;. Acerte com a bola no buraco.

#### Inclinação

O próximo buraco de tutorial tem duas rampas com inclinações diferentes. Se você escolher o Buraco Mostrar Informação, a inclinação da rampa irá aparecer como um número de 1 a 8, em que o 8 é o mais inclinado e o 1 o mais plano. Para além disso, quanto mais sombreada for a rampa, mais inclinada será. Acerte no buraco e passe para o próximo.

### Paredes

As bolas ressaltam nas paredes, como seria de esperar, com um ligeiro efeito. Desvie a bola das paredes para dentro da cova e avance para o próximo buraco.

### Charcos e Areia

#### Charcos

Os charcos são azuis. Quando a bola for parar num charco, é adicionada uma tacada de penalização à sua pontuação e a sua bola é colocada fora do charco.

#### Areia

A areia é amarela. As bolas rolam através da areia muito devagar.

Acerte na bola à volta dos charcos e através da areia para o buraco para continuar para o próximo buraco.

### Moinhos

Os moinhos são objectos compostos com paredes de contornos castanhos e com um braço móvel tanto na parte superior como na inferior do objecto. As meias paredes criam a abertura do moinho, à volta da qual roda um braço preto. Exige algum prática para ser capaz de cronometrar a tacada da bola para que passe pela abertura. Acerte na bola através do moinho para o buraco de modo a prosseguir.

### Buracos Negros

Quando você acertar com a sua bola num buraco negro, esta é transportada para a saída e ejectada com o ângulo da saída a uma velocidade directamente proporcional à velocidade com que a bola estava a ir. Escolha a opção Buraco Mostrar Informações para ver qual o Buraco Negro que vai para cada saída e com que direcção. A fronteira à volta dos Buracos Negros e das suas saídas correspondentes estão da mesma cor. Acerte com a bola no buraco negro, o qual irá ejectar então a bola para o buraco de modo a que você passe para o próximo nível.

### Bóias

As bóias são plataformas móveis que carregam uma bola que pare em cima dela. A velocidades das bóias pode variar. Esta é uma bóia bastante lenta, mas você deverá à mesma cronometrar a sua tacada para que passe por cima da parede e caia na cova.

### Pontes

As pontes são simples - estas simplesmente elevam a bola por cima das coisas que estejam por baixo delas, como as rampas, a areia e as poças. Estas poderão ter paredes castanhas no seu perímetro.

## Básicos

Aqui está um descrição detalhada das funcionalidades básicas do &kolf;.

### Começar um Jogo

Para começar um jogo, escolha a opção Jogo Novo. Isto irá abrir uma janela onde você poderá configurar o seu jogo novo.

Estão disponíveis mais campos do &kolf; feitos por terceiros na página Web do &kolf;. Veja na página de campos do &kolf; enviados pelos utilizadores.

#### Página dos Jogadores

Para adicionar um jogador ao seu jogo, carregue no botão Novo Jogador.

Os textos na área da relva são os nomes dos jogadores neste jogo. Para mudar o nome dos jogadores, altere o texto nos campos de texto. Para mudar a cor da bola dos jogadores, carregue no botão do meio que tem um rectângulo colorido, para que se abra uma janela onde você poderá seleccionar a nova cor da bola. O rectângulo no botão é a cor actual da bola do jogador.

Para remover um jogador, carregue no botão Remover ao lado do nome do jogador.

#### A Página Campo

Para escolher o campo onde deseja jogar, carregue no seu item da lista à esquerda desta página. O &kolf; vem com vários campos incorporados nos quais poderá jogar.

Para adicionar um campo que tenha obtido da Internet ou criado, carregue no botão Adicionar... no fundo desta página e escolha o ficheiro do campo na janela de selecção de ficheiros.

#### A Página de Opções

Nesta página você poderá escolher se este jogo será ou não jogado no Modo restrito. Neste modo, não existe a anulação de jogadas, buracos móveis ou a edição do campo. Este modo é geralmente usado nas competições. Só no modo restrito é que os recordes são registados.

### Jogos Gravados

O &kolf; poderá manter um histórico das suas rondas ainda em progresso e gravá-lo no disco para que possa carregar essas rondas e jogá-las mais tarde. Os jogos gravados incluem o buraco actual, os nomes e as cores dos jogadores em jogo, bem como as suas pontuações.

#### Gravar o Jogo

Para gravar o seu jogo enquanto ainda está a jogar, escolha a opção Jogo Gravar o Jogo . Se ainda não tiver gravado nenhum jogo antes, ser-lhe-á pedido o nome do ficheiro onde irá gravar os dados.

#### Carregar um Jogo

Para carregar o jogo que você gravou, escolha a opção Jogo Carregar o Gravado... . Você poderá então escolher o jogo gravado a abrir.

### Praticar

Existem algumas funcionalidades que tornam a prática do seu golfe mais simples. Estas funcionalidades não estão activadas durante o modo restrito.

#### Desfazer

Para anular uma jogada mal feita, escolha a opção Buraco Anular Tacada.

#### Mudar de Buraco

O menu Jogar contém vários itens do menu para mudar para os vários buracos que são bastante esclarecedoras. Veja a referência do menu Jogar.

### Opções das Tacadas

O &kolf; tem algumas formas de dar a tacada. O método básico das tacadas está descrito acima.

O rato está activo por omissão. Isto significa que, sempre que o rato é mexido, o taco alinhar-se-á com a linha entre o rato e a bola.

Se preferir usar apenas o teclado e as teclas dos cursores, você poderá desactivar as tacadas com o rato desligando a opção Configuração Usar o Rato para Mover o Taco.

#### Tacadas Avançadas

As tacadas avançadas poderão se activadas se assinalar a opção Configuração Activar o Modo Avançado. Este modo de tacada é ligeiramente mais desafiante que o modo normal, e poderá ser usado tanto com o rato como com o teclado.

Para dar a tacada neste modo:

1. Carregue a tecla de cursor Baixo uma vez para começar a tacada. O indicador de tacada irá aparecer e o medidor da força irá começar a encher com uma dada cor, a qual vai mudando à medida que esse medidor se vai enchendo.

2. Carregue outra vez na tecla de cursor Baixo quando o medidor de força tenha enchido com a quantidade que você deseja. Quanto mais cheio estiver esse círculo do medidor, mais forte será a tacada. Exige alguma prática para conseguir dar a força correcta nas tacadas.

   Depois disto, a cor do indicador da tacada irá começar a descer até ao início.

3. Carregue mais uma vez na tecla Baixo de novo quando o indicador de força estiver tão perto quanto possível da linha central do indicador da tacada.

Quanto mais perto do click final for, mais real a tacada será da linha original.

## Edição dos Campos

O &kolf; vem com um editor versátil para o seu formato de ficheiros dos campos. Os campos poderão conter qualquer número de buracos e não existe nenhum limite à criatividade do desenhador do campo.

### Criar um Novo Campo

Para criar um novo campo, escolha a opção Jogo Novo. Vá à página Campos da janela e escolha o campo Criar Novo. Garanta que, na página Opções da janela, o Modo restrito está desactivado.

Para jogar este campo novo mais tarde, carregue no botão Adicionar... para adicionar o seu campo à lista de campos.

### Adicionar Buracos

Escolha a opção Buraco Novo para adicionar um novo buraco ao fim do campo.

Você poderá repor um buraco para um campo em branco, de forma semelhante à de quando foi criado da primeira vez, se escolher a opção Buraco Limpar.

Irão aparecer dois itens no campo de jogo: o buraco em si e uma bola branca. A bola branca marca onde as bolas dos jogadores irão iniciar o nível.

### Conceitos Básicos da Edição

O bloco básico de construção dos campos do &kolf; é o objecto. Cada nível de um buraco é composto a partir de um conjunto de objectos. Os objectos poderão ser movidos para qualquer local e os diferentes tipos de objectos terão propriedades diferentes que você poderá definir.

Para começar a editar o nível de um buraco, active o item do menu Buraco Editar ou carregue no ícone do lápis na barra de ferramentas. Para abandonar o modo de edição, desligue este item do menu (ou o ícone da barra de ferramentas).

#### Adicionar Objectos

Para adicionar um novo objecto ao campo, escolha o seu nome na lista chamada Adicionar objecto:. O objecto irá aparecer no centro do campo.

As pontes e os sinais irão cobrir os novos objectos se eles já estiverem no centro do nível.

Você poderá adicionar mais do que um buraco num nível. Se o fizer, poderá criar desenhos de buracos interessantes.

Alguns dos objectos do &kolf; estão disponíveis como 'plugins'. Se você adicionar estes objectos ao seu campo, os jogadores do campo irão necessitar de obter esse 'plugin'.

Os 'plugins' do &kolf; criados por terceiros estão disponíveis na página Web do &kolf;. Veja na página de obtenção de 'plugins' do &kolf;.

#### Mover e Redimensionar os Objectos

Mova o seu cursor do rato por cima do objecto que deseja mover para que o cursor mude para o formato de uma mão. A partir daí carregue e arraste o objecto para onde o desejar mover.

As poças, a areia, as bóias, as pontes e os sinais poderão ser redimensionados se arrastar o pequeno círculo que têm no seu canto inferior direito.

As paredes poderão ser movidas se carregar e arrastar os seus pontos finais, ou poderá arrastar a parede por inteiro se carregar e arrastar a parte do meio da parede como é normal.

#### Configuração dos Objectos

As propriedades dos objectos podem ser alteradas na área do canto inferior direito da janela do &kolf;. Para editar um objecto, mova o cursor do seu rato para cima dela até que o cursor mude para a mão. De seguida carregue nele. Os vários controlos para esse objecto irão aparecer no canto inferior direito da janela do &kolf;.

##### Configuração Geral do Nível

Para editar as configurações gerais do nível, carregue numa área do nível que não esteja coberta por nenhum objecto. Logo que isto seja possível, o cursor ficará o ponteiro da seta normal.

Nome do campo:

  Este é o nome que é mostrado na janela do novo jogo e na janela de Acerca do Campo.

Autor do campo:

  Este é o nome do autor que é mostrado na janela de Acerca do Campo.

Par:

  O 'par' do nível.

Máximo:

  Número máximo de tacadas que o jogador pode dar neste buraco.

Mostrar as paredes de contorno

  Se se devem mostrar as paredes à volta do contorno do nível.

##### Rampas

Tipo

  Escolha o tipo da rampa - Vertical, Horizontal, Diagonal, Diagonal Oposto, Circular. As rampas diagonais e diagonais opostas são triangulares, enquanto que as circulares têm exactamente essa forma. As rampas verticais e horizontais são rectangulares, como seria de esperar.

Inverter direcção

  Se se deve inverter ou não a inclinação da rampa. Por exemplo, pense numa rampa elíptica (circular). Quando não estiver invertida, ela empurra as rampas para fora como um monte. Quando estiver, ela puxa as bolas para dentro como uma cova.

Grau:

  Escolhe o grau (inclinação) da rampa, movendo a barra deslizante para que o grau vá de 0 a 8, em que o 8 é o mais inclinado e o 0 é o plano. As rampas mais a pique empurram mais a bola.

Imóvel

  Se esta pode ou não ser movida por outros objectos, como flutuadores.

  Se uma bóia sobrepor este objecto em algum ponto da sua deslocação e se a inclinação for grande, não movendo deste modo a bóia, você precisa tornar a rampa Imóvel, ou então o &kolf; irá ter uma crise de performance!

##### Charcos e Areia

As poças ou charcos e a areia têm as mesmas opções de configuração.

Activar mostrar/esconder

  Se assinalar esta opção, activa a intermitência desta poça de água ou de areia.

Velocidade do Mostrar/Esconder

  Quanto mais perto do Rápido estiver a barra, mais depressa o charco ou a areia ficarão intermitentes.

##### Pontes, Moinhos, Bóias e Sinais

As pontes, moinhos, bóias e sinais tem todos opções semelhantes de configuração dos lados em que existem paredes de contorno. Para mostrar a parede de um lado, active a opção para esse lado.

Existem também algumas opções específicas para os moinhos, as bóias e os sinais.

###### Moinhos

Moinho ao fundo

  Se o braço do moinho a preto está em cima ou em baixo - por omissão, este está em baixo. As duas meias-paredes irão estar sempre com o braço. Repare que você não poderá activar a parede do contorno do lado em que o braço se encontra.

Velocidade

  Quanto mais perto do Rápido estiver a barra, mais rapidamente se moverá o braço do moinho.

###### Bóias

O caminho que a bóia segue é mostrado pela parede a que se encontra associado.

Velocidade de movimentação

  Quanto mais próxima do Rápido estiver a barra, mais rapidamente se move a bóia. Se a barra estiver encostada por completo ao extremo Lento, a bóia irá parar.

###### Sinais

Sinal HTML:

  Você poderá indicar qualquer &HTML; válido aqui. Por exemplo se escrever Dê-lhe <i>devagar</i> em direcção à rampa! irá criar o texto Dê-lhe devagar em direcção à rampa!.

## Referência do Menu e dos Comandos

### O Menu Jogo

&Ctrl;N Jogo Novo...

  Iniciar um novo jogo

&Ctrl;O Jogo Carregar o Gravado...

  Carrega um jogo gravado previamente.

&Ctrl;S Jogo Gravar o Campo

  Grava o campo actual usando o seu nome de ficheiro actual.

Jogo Gravar o Campo Como...

  Abre uma janela de ficheiros que lhe permite gravar o campo actual com um outro nome de ficheiro.

Jogo Gravar o Jogo

  Grava o jogo actual com o nome do último jogo gravado, ou com um nome de ficheiro que você irá indicar se ainda não tiver gravado o jogo.

Jogo Gravar o Jogo Como...

  Abre uma janela de ficheiros que lhe permitirá gravar o jogo actual com o nome de um ficheiro à sua escolha.

&Ctrl;End Jogo Terminar o Jogo

  Termina o jogo actual, sem sair do &kolf;

&Ctrl;H Jogo Mostrar os Recordes

  Mostra a tabela com os recordes.

&Ctrl;P Jogo Imprimir...

  Imprime o ecrã actual.

Jogo Acerca do Campo

  Mostra o nome, o autor e o 'par' do campo.

&Ctrl;Q Jogo Sair

  Sai do &kolf;

### O Menu Buraco

&Ctrl;E Buraco Editar

  Muda para o modo de edição para editar o nível actual.

&Ctrl;&Shift;N Buraco Novo

  Cria um novo nível de buraco. (Só no modo de edição).

&Ctrl;Delete Buraco Limpar

  Remove todos os objectos do nível actual. (Só no modo de edição).

&Ctrl;R Buraco Reiniciar

  Repõe o nível actual para a sua posição inicial, de modo a que possa começar do início.

&Ctrl;I Buraco Mostrar Informações

  Mostra a informação sobre os objectos do nível actual.

&Ctrl;Z Buraco Anular a Tacada

  Anula a última jogada que você tenha feito.

### O Menu Ir

Jogar Mudar para o Buraco

  Vai directamente para outro nível do campo. Uma lista com os números dos níveis permitir-lhe-á escolher qual o nível para o qual deseja mudar.

&Alt;Direita Jogar Próximo Buraco

  Vai para o próximo nível do campo.

&Alt;Esquerda Jogar Buraco Anterior

  Vai para o nível anterior do buraco.

&Ctrl;Home Jogar Primeiro Buraco

  Vai para o primeiro nível do campo.

&Ctrl;&Shift;End Jogar Último Buraco

  Vai para o último nível do campo.

Jogar Buraco Aleatório

  Vai para um nível aleatório do campo actual.

### O Menu Configuração

Configuração Mostrar a Barra de Ferramentas

  Activa ou desactiva a barra de ferramentas principal.

Configuração Mostrar a Barra de Estado

  Activa ou desactiva a barra de estado.

Configuração Utilizar o Rato Para Mover o Taco

  Permite a utilização do rato para mover o taco.

Configuração Activar Modo Avançado

  Activa o modo avançado para aplicar tacadas, tal como está descrito na sua própria secção.

Configuração Mostrar o Guia dos Tacos

  Activa ou desactiva a linha de guia do taco.

Configuração Tocar os Sons

  Activa ou desactiva os efeitos sonoros.

Configuração Activar Todas as Janelas

  Reactiva todas as janelas que você tenha desactivado ao carregar numa opção Não mostrar esta mensagem de novo ou semelhante.

Configuração Recarregar os Plugins

  Volta a carregar o código dos 'plugins'.

Configuração Mostrar os 'Plugins'

  Mostra os 'plugins' actualmente carregados.

Configuração Configurar os Atalhos...

  Personalizar os atalhos do teclado.

Configuração Configurar as Barras de Ferramentas...

  Abre uma janela onde poderá configurar as barras de ferramentas do &kolf;.

### O Menu Ajuda

&help.menu.documentation;

## Créditos e Licenças

&kolf; com 'copyright' 2001, 2002 de &Jason.Katz-Brown;

### Programadores

- &Jason.Katz-Brown; jasonkb@mit.edu

- Niklas Knutsson

- Ryan Cumming

- Daniel Matza-Brown

Documentação com 'copyright' 2002 de &Jason.Katz-Brown;

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

&underFDL; &underGPL;

## Instalação

&install.intro.documentation; &install.compile.documentation;

&documentation.index;