Projeto de MAC211 -- 2010
Náufragos

Fabio Kon - Marcelo Reis

Nos capítulos anteriores....

Terceira Fase

Nesta última etapa de desenvolvimento do projeto vamos finalizar o jogo, dando um acabamento final, implementando a interação com o usuário, pontuação dos jogadores, vidas, telas inicial e final, etc.

Além disso, vamos utilizar o Flex e o Bison para implementar um interpretador de um arquivo de configurações do joguinho, isto é, um interpretador que filtre regras que "personalizem" a sessão de jogo.

Por fim, vamos elaborar mais testes automatizados para validar a correção da ED e do interpretador, caprichar na instalação do joguinho (utilizando o Autoconf) e preparar um relatório final (utilizando LaTeX).

Interação com o Usuário

Teclas dos Botes

Relembrando as descrições do jogo e das teclas, fornecidas em EP2: cada um dos dois jogadores controla um dos dois botes (um de cada cor) e ambos têm a tarefa de recolher a maior quantidade possível de passageiros. Os jogadores devem desviar-se dos perigosos recifes de corais.

Cada jogador controla o seu bote pressionando determinadas teclas, sendo que as teclas de cada um ficam nas extremidades opostas do teclado. São elas:

• Quatro teclas para a movimentação do bote:
  • uma tecla para propulsão e outra para freio (com simulação física);
  • duas teclas para mover a bombordo e a estibordo (sem simulação física, i.e., gira numa taxa fixa para cada aperto de tecla).
  
  
• Uma tecla para "lançar âncora"; com isso, o bote fica "estacionado" no mar. A mesma tecla pode ser usada para "recolher âncora".

Para gerenciar as teclas em Allegro, antes de mais nada, inicialize o handler de teclado com a função install_keyboard(). A biblioteca conta com um vetor de chars chamado key, onde cada elemento representa se uma tecla do teclado foi acionada. Se, por exemplo, key[KEY_LEFT] devolve um valor diferente de zero, então a seta esquerda foi acionada num instante de tempo anterior. Consulte o manual e os tutoriais de Allegro para mais informações.

Capacidade dos botes

OBS: O jogador não precisa esperar lotar o bote para descarregar passageiros na R.M.S. Asimov.

Pontuação, vidas e dinâmica do jogo

• se um bote esbarra em um recife de coral: ele encalha e o jogador perde uma vida; se haviam passsageiros no bote, eles voltam para o oceano, e o bote é reinicializado em um ponto aleatório da tela, sem nenhum passageiro;
  
  
• quando um passageiro é recolhido, o jogador ganha 10 pontos;
  
  
• quando um passageiro é descarregado na R.M.S. Asimov, o jogador ganha 20 pontos;
  
  
• se um jogador acumula 500 pontos, ganha uma vida.
  
  

Ajuste fino da Jogabilidade

Importante: todos os parâmetros do jogo devem ser definidos na forma de constantes (#define), nos headers dos módulos do programa ou em variáveis apropriadas (ou seja, evite "números mágicos" no meio do seu código). Se preferir passar alguns parâmetros por linha de comando, não se esqueçam de acrescentar uma opção de "ajuda". Em ambos os casos, expliquem os diversos valores (mínimo e máximo) para cada parâmetro que o seu programa aceita.

Obrigatório: Interpretador de arquivo de configuração

• Tamanho (resolução) da tela;
  
  
• High scores;
  • Nome do jogador;
  • Placar.
  
  
• Nomes dos jogadores;
  
  
• Número de vidas iniciais;
  
  
• Nível de dificuldade padrão;
  
  
• Mensagem de Game Over (uma cadeia de caracteres).
  
  

É claro que o interpretador deverá ler corretamente os itens acima independentemente da ordem em que eles aparecem no arquivo. O joguinho deverá atualizar o arquivo de configuração ao menos nos itens em que isso claramente faz-se necessário (como, por exemplo, nos High scores).

Cada grupo está livre para acrescentar itens adicionais que julgar necessários e/ou interessantes. A filtragem deve incluir análise léxica (Flex) e sintática (Bison). Cabe a cada grupo estipular seu próprio léxico e sintaxes das regras para o processamento apropriado do arquivo de configuração.

OBS: é obrigatória a utilização de Flex e de Bison para as análises léxica e sintática, respectivamente. É permitido escrever o arquivo de configuração em XML.

Opcional: Interpretador de scripts de Bots

A filtragem deve incluir análise léxica (Flex) e sintática (Bison). Cabe a cada grupo estipular suas próprias regras para produção de um Bot, assim como a elaboração das flags necessárias e do processamento apropriado das regras.

OBS: é obrigatória a utilização de Flex e de Bison para as análises léxica e sintática, respectivamente. As regras aceitas precisam ser suficientes para cumprir todas as ações necessárias para resgatar os passageiros.

Testes Automatizados

• Robustez: a ED funciona corretamente com muitos passageiros (como por exemplo, 600 ou mais)? E com poucos passageiros (zero, por exemplo)? Ela não tem problemas de vazamento de memória e trata corretamente os erros de alocação?
  
  
• Correção: o analisador interpreta corretamente as regras especificadas? Ele rejeita corretamente regras e tokens inválidos? O que acontece quando o arquivo de configuração não existe?

Portanto, a bateria de testes deve verificar a robustez da ED e a correção do interpretador. Tal qual foi feito em EP2 de MAC211, as funções de testes devem estar em um ou mais arquivos separados do "main" do programa principal.

Relatório

• introdução: apresentação do documento e do trabalho desenvolvido.
  
  
• manual do usuário: quais são os pré-requisitos do joguinho, como instalá-lo, quais são os seus parâmetros, etc.
  
  
• implementação: a estruturação do código e as EDs empregadas, o programa de testes automatizados, a especificação das regras do(s) interpretador(es), etc.
  
  
• conclusões: o relato da experiência adquirida ao longo do desenvolvimento do projeto "Náufragos", do EP2 até o EP4.

Melhorias Opcionais

Alguns extras sugeridos seriam:

• quando todos os passageiros são recolhidos, passa-se para uma nova fase, mais difícil;
  
  
• simular "maré alta" e "maré baixa", dessa forma tornando dinâmica a exposição dos corais e aumentando a dificuldade do jogo;
  
  
• elaborar telas caprichadas de abertura e de game over;
  
  
• utilizar simulação física para os movimentos laterais dos botes;
  
  
• implementar efeitos sonoros;
  
  
• implementar interação do usuário através de outros dispositivos (por exemplo, joystick).

Data de entrega (e o que deve ser entregue)

A última fase deverá ser entregue até o dia 5 de julho (segunda-feira). Dúvidas podem ser discutidas no fórum da disciplina no Moodle, para o aproveitamento de todos.

Devem ser entregues no tar.gz:

• o código-fonte do joguinho, bem modularizado, estruturado e comentado;
  
  
• a instalação do joguinho, produzida utilizando o Autoconf;
  
  
• o código-fonte dos testes automatizados, devidamente documentado;
  
  
• o código-fonte dos analisadores léxico e sintático;
  
  
• o relatório (entregar o .tex e o .pdf).