Projeto de Programação - Entrega Final MEEC - 2012/2013-2.Semestre Farm:TamagoISTi 1 Introdução Tamagotchi foi um dos primeiros animais de estimação virtuais, extremamente popular no final do último século e o Farmville é uma das sensações que assolam o Facebook hoje. O projeto de Programação consistirá na implementação de uma quinta de animais de estimação virtuais cada um semelhante ao Tamagotchi, uma quinta de TamagoISTi. Neste projeto final, pretende-se que os alunos desenvolvam uma quinta de animal de estimação virtuais com as seguintes funcionalidades: Mostra no ecrã o estado de um animal Alimentar e exercitar o animal apresentado no ecran Selecionar outro animal a mostrar Alimentar ou exercitar todos os animais da quinta. Criar novos animais A quinta permitirá a existência de animais de diversas espécies com ritmos de crescimento e emagrecimento diferentes. 2 Funcionamento da Aplicação O sistema a implementar poderá ser dividido em três grandes módulos: Quinta Display Backup O módulo Quinta armazena numa lista os diversos animais virtuais, sendo armazenando o estado de cada animal e alterando-o com base nos comandos recebidos do Display. Através do Display será possível selecionar um animal, apresentar e observar o seu estado e executar ações (por exemplo, alimentar ou exercitar os animais). Também será através desta interface que se poderá sair da aplicação.
O módulo de backup permite gravar o estado dos animais e relê-lo no início da aplicação. 2.1 Quinta Na versão Final do Projeto, os animais simulados deverão ser armazenados numa lista. Cada animal armazenado na lista pertence a uma espécie diferente, mas continua a poder executar duas ações (alimentar e exercitar). Dependendo da espécie, assim cada ação terá um efeito diferente no animal. O estado de cada animal passa a ser composto pelo nome, peso, estado de saúde e espécie. Durante a execução da aplicação é necessário armazenar informação acerca das diversas espécies possíveis: nome da espécie, parâmetro de aumento de peso (quanto peso os animais dessa espécie aumentam quando comem), e parâmetro de diminuição de peso ( quanto peso os animais dessa espécie diminuem quando se exercitam). O número máximo de espécies é 10. O estado de cada animal continua a seguir as seguintes regras: O peso varia entre 0 e 100. Cada animal nasce com 50 unidades de peso. Se o peso de um animal estiver a cima dos 75 esse animal é obeso Se o peso de um animal estiver a baixo de 25 esse animal está sub-nutrido Quando um animal atinge 0 ou 100 unidades de peso, morre As ações de alimentar e exercitar um animal dependem da sua espécie: Alimentar um animal aumenta o peso em X unidade (parâmetro de aumento de peso da espécie) Exercitar o animal diminui o peso em Y unidade (parâmetro de diminuição de peso da espécie) A passagem de tempo continua a afetar o estado dos animais: Quando um animal está obeso e passam duas unidades de tempo sem se exercitar, este engorda X unidades (parâmetro de aumento de peso), mesmo que não coma. Quando um animal está sub-nutrido e passam duas unidades de tempo sem se alimentar, este emagrece Y unidades (parâmetro de diminuição de peso), mesmo que não se exercite. No início da aplicação deverá ser lido um ficheiro (chamado especies.txt)com as caraterísticas das diversas espécies. 2.2 Display A disposição do display mantêm-se a mesma da entrega intermédia, sendo apenas adicionados o seguintes comandos: Seleção do anima a apresentar Alimentação de todos os animais Exercitar todos os animais Criação de novo animal O display apresentará o animal selecionado: o seu nome, o seu estado, e permitirá o realização de
exercício ou alimentação desse animal. Na parte correspondente à apresentação do animal, deverá ser representado o estado de saúde do animal (sub-nutrido, normal, ou obeso) através de três imagens diferentes (uma para cada estado e dependente da espécie). O peso deverá ser representado por uma barra. A barra correspondente ao peso do animal, deverá ter um comprimento proporcional ao peso. Se o animal estiver sub-nutrido ou obeso a barra deverá ser encarnada, caso contrário deverá ser verde: Diabo sub-nutrido Diabo normal Diabo obeso Os botões de controle permitirão alimentar ou exercitar o animal apresentado e sair da aplicação. De modo a selecionar o animal apresentado no ecrã o utilizador deverá usar as teclas do cursor (direta e esquerda) de modo a navegar na lista de animais. Se o utilizador carregar na tecla A, todos os animais da quinta serão alimentados. Se o utilizador carregar na tecla E, todos os animais da quinta serão exercitados. Quando o utilizador carrega na tecla N, deverá ser criado e inserido na lista um novo animal. Sempre que for realizada uma ação (alimentação, exercício ou criação) Deverá ser escrito na consola (usando printfs) o estado de todos os animais vivos (nome, espécie e peso). A imagem apresentada depende do estado do animal (normal, magro, obeso) e da sua espécie (ver secção 5). 2.2.1 Avisos No display também serão apresentados avisos acerca do estado global da quinta, sob a forma de uma marca que muda de cor: Sempre que um animal passa para o estado subnutrido ou obeso,deverá se apresentada no ecrã e durante 2 segundos uma marca amarela. Se o número de animais obesos ou subnutridos for menor do que um terço do numero total, deverá ser apresentada no ecrã uma marca verde. Sempre que mais de um terço dos animais estejam obesos ou subnutridos, deverá ser apresentada no ecrã uma marca cor de laranja. Sempre que mais do que dois terços dos animais estejam obesos ou subnutridos, deverá ser apresentada no ecrã uma marca vermelha. 2.3 Backup
De modo a permitir a interrupcao do jogo, o estado dos animais deverá ser armazenado num ficheiro chamado animal.txt Quando o utilizador carrega no botão sair, o ficheiro animal.txt deverá ser atualizado com o estado de todos os animais vivos. Quando se executa a aplicação, esse ficheiro (animal.txt) deverá ser lido e com base na sua informa,cão a lista de animais deverá ser reconstruida. Se, aquando do início da aplicação, o ficheiro animal.txt não for encontrado, o programa executa-se normalmente, mas com a quinta vazia. 3 Criação de novo animal Aquando da criação de um novo animal, deverá ser lida do teclado a informação desse animal: nome espécie O peso do animal recém nascido será de 50 unidades. 4 Morte de um animal Quando um animal morre (porque o seu peso chegou a 0 ou 100) deverá ser eliminado da lista. 5 Espécies A informação referente ao comportamento das espécies encontra-se especificada num ficheiro chamado especies.txt. Cada linhas deste ficheiro contêm a informação e caraterísticas de uma espécie: nome (uma palavra) parâmetro de aumento de peso parâmetro de diminuição de peso Estas características das espécies serão usadas aquando da alimentação e exercício dos diversos animais. O ficheiro especies.txt contem no máximo 10 espécies. O ficheiro especies.txt deverá ser lido no arranque da aplicação. As imagens a usar na representação de um animal devem existir na mesma diretoria do executável e os seus nomes seguem o seguinte formato: especie-normal.bmp especie-obeso.bmp especie-magro.bmp Apresenta-se de seguida um exemplo do ficheiro especies.txt: diabo 10 10 koala 1 1
canguru 5 10 Com base nesta informação, por exemplo, sempre que um canguru se alimenta ganha 5 unidade de peso, enquanto que quando de exercita, perde 10. Para estas espécies deverão existir os seguintes ficheiros: diabo-normal.bmp diabo-obeso.bmp diabo-magro.bmp koala-normal.bmp koala-obeso.bmp koala-magro.bmp canguru-normal.bmp canguru-obeso.bmp canguru-magro.bmp 6 Passagem do tempo De modo a a simplificar a implementação do projeto, a passagem de tempo será simulada carregando na tecla de espaço. O programa tratará este evento como se da passagem de tempo se tratasse. 7 Implementação A realização da entrega final é em grupo de 2 alunos e será implementada na linguagem C, tal como descrita no livro The C Programming Language - The ANSI edition. 7.1 Elementos gráficos Na parte gráfica será utilizada a biblioteca SDL ( http://www.libsdl.org) para a apresentação de imagens numa janela e leitura dos cliques do rato. A janela gráfica da aplicação deverá ter o tamanho 800x600 pixeis. Nessa janela serão desenhados os botões, a barra de peso e as representação de um animal. Cada grupo deverá escolher um e usar os diversos ficheiros gráficos (botões, barra, animal) já criados para a entrega intermédia. A organização da janela poderá ser diferente dos exemplos apresentados. 7.2 Armazenamento dos animais Os alunos devem guardar os animais numa lista, implementando funções para todas as funcionalidades necessárias (por ex: inserir novo elemento na lista, remover elemento da lista), alocando memória dinamicamente à medida que criam novos animais, e libertando a memória respetiva quando um animal morre. 7.3 Armazenamento das espécies As características das espécies poderão ser armazenadas num vetor. 8 Desenvolvimento da entrega final Sugere-se um desenvolvimento faseado do projeto, devendo os alunos garantir que todas as funcionalidades codificadas até esse momento se encontram a funcionar corretamente. É preferível um programa que implementa poucas funcionalidades, mas que funcionam corretamente, do que um programa totalmente desenvolvido mas que não corre. Os alunos deverão seguir a seguinte ordem:
1. Definir o tipo de dados para armazenar um animal 2. Definir o tipo de dados para armazenar todos os animais 3. Criação de animais e armazenamento na lista 4. Seleção do animal a apresentar no ecran 5. Alimentação e exercício do animal apresentado 6. Apresentação na consola do estado de todos os animais 7. Definir o tipo de dados para armazenar uma espécie 8. Definir o tipo de dados para armazenar os dados das espécies 9. leitura e armazenamento dos dados das espécies 10. Passagem de tempo 11. Alimentação de todos os animais 12. Exercício de todo os animais 13. Deteção da morte de um animal na lista 14. Eliminação dos animais mortos 15. Apresenta,cão das marcas de estado da quinta 16. Leitura e escrita do ficheiro de backup 9 Codificação É fundamental o uso consistente de um estilo de formatação e indentação do código (indentação, posicionamento das chavetas, nomes dos identificadores). Este deve ser escolhido pelos alunos, mas consistente em todo o projeto. Existem diversas variações da linguagem C. Aquela que deve ser usada é a apresentada nas aulas teóricas e descrita no livro The C Programming Language - The ANSI edition. O compilador a usar na execução do projeto é o gcc com as opções -Wall -ansi, em ambiente Linux. Projetos que não compilem quando usando as opções anteriores, i.e. que tenham erros de sintaxe, não serão avaliados. A existência de avisos durante a fase de compilação poderá ser indício da existência de problemas no código. Estes deverão ser eliminados corretamente ou ignorados com cuidado. O código produzido pelos alunos deverá ser comentado. Os comentários presentes no código deverão explicitar e explicar o funcionamento da aplicação assim como as decisões tomadas. Para além dos comentários, sugere-se o uso de nomes de variáveis e funções que explicitem o seu uso (para maior legibilidade do código). Como em qualquer projeto de informática, o funcionamento do programa não está totalmente definido no enunciado, existindo algumas ambiguidades e omissões. Para resolver essas omissões os alunos deverão tomar algumas decisões aquando do desenvolvimento do projeto. Estas decisões devem ser fundamentadas, sem nunca ir contra o definido no enunciado. 10 Submissão do código A data limite para entrega do código do Projecto Final é dia 17 de Maio. O nodo de entrega do
Projeto será anunciado mais próximo do prazo. 11 Avaliação da entrega final A avaliação do projeto terá em conta diversos parâmetros: Funcionalidades implementadas Qualidade do código produzido Estruturação da aplicação Comentários e legibilidade do código Tratamento de erros Para a obtenção da nota mínima (10 valores é necessário) a implementação do seguinte, para um animal sem espécie definida: Definir o tipo de dados para armazenar um animal Definir o tipo de dados para armazenar todos os animais Criação de animais e armazenamento na lista Seleção do animal a apresentar no ecrã (cursor direito) Alimentação e exercício do animal apresentado Apresentação do estado de todos os animais