Instalação do Simulador e execução da partida PET - Engenharia de Computação http://www.inf.ufes.br/~pet Em caso de dúvidas, cadastre-se no e-group em http://groups.google.com.br/group/ simulacao-2d e envie sua mensagem com a dúvida. 1 Instalando o Simulador Para instalar a versão mais nova do simulador, já pré-compilada para a distribuição Debian (e baseadas nela, como o Ubuntu), siga os passos a seguir. Caso você tenha uma outra distribuição, apenas atentese para as observações no decorrer da explicação e se mesmo assim não conseguir instalar os pacotes pré-compilados, compile-os para a sua distribuição, seguindo as instruções da seção 5. 1.1 Instalando as dependências O simulador possui algumas dependências (bibliotecas), que devem ser instaladas antes de instalarmos o simulador. Você pode escolher usar o apt-get (modo texto) ou o synaptic (modo gráfico). Achamos melhor usar o modo texto, uma vez que é mais rápido. Caso tenha problemas na instalação de algum pacote, veja as observações na seção 1.1.3. Caso queira uma explicação mais detalhada sobre como instalar pacotes via apt-get e synaptic, veja o tutorial disponível na página do PET, na seção projetos -> Software Livre 1.1.1 Instalando as dependências pelo modo texto - apt-get No modo texto, siga os comandos abaixo. Você pode copiar cada um dos comandos, um de cada vez. O que estiver entre < e > é apenas um comentário sobre o comando, não devendo ser copiado. su <forneça a senha do root. Aqui você estará se logando como root. Caso use ubuntu, pode-se usar o comando "sudo su"(sem aspas) e fornecer a senha do usuário normal> apt-get update <atualiza a lista de pacotes disponíveis na internet> apt-get install libltdl7 libstdc++6 libboost-filesystem1.40.0 \ libboost-program-options1.40.0 libqtcore4 libqtgui4 libqt4-opengl \ libqt4-network libxaw7 libxpm4 libxt6 gcc g++ tcsh <Pode copiar as três linhas acima de uma só vez. Esse comando instala todos os pacotes necessários.> 1.1.2 Instalando as dependências pelo modo gráfico - Synaptic Abra o Synaptic (Sistema->Administração->Gerenciador de Pacotes Synaptic), clique em Recarregar para atualizar as listas de pacotes disponíveis na internet e depois, usando a ferramenta de busca, selecione os seguintes pacotes para instalação: 1
libltdl7 libstdc++6 libboost-filesystem1.40.0 libboost-program-options1.40.0 libqtcore4 libqtgui4 libqt4-opengl libqt4-network libxaw7 libxpm4 libxt6 gcc g++ tcsh 1.1.3 Observação sobre as versões dos pacotes Se você não estiver usando o Debian Testing ou Ubuntu, os pacotes acima podem ter outros nomes. Nesse caso, procure no synaptic algum pacote que tenha parte do nome parecido com os pacotes acima. Também dependendo da sua distribuição, os pacotes libboost-filesystem1.40.0 e libboost-programoptions1.40 podem estar em outra versão, a 1.38 por exemplo. O simulador pré-compilado não irá funcionar com essas outras versões do libboost. Você terá que instalar exatamente a versão do libboost que está na lista da seção anterior, ou então compilar o simulador de acordo com a sua distribuição, a partir dos arquivos fontes, seguindo as instruções da seção 5. 1.2 Instalando os pacotes pré-compilados do Simulador Faça o download de todos os pacotes do simulador (rcssserver, rcssmonitor, rcsslogplayer) e salve-os em uma mesma pasta. No site do grupo os pacotes estão separados em <nome do pacote>_i386.deb (para computadores executando o Linux 32 bits) e <nome do pacote>_amd64.deb (para computadores que estão executando o Linux 64 bits, mesmo que seja em processadores intel). Abra um terminal, navegue até a pasta onde encontram-se os pacotes, e como root execute o comando: dpkg -i *.deb O comando acima instalará todos os pacotes.deb contidos na pasta, no caso, os pacotes do simulador. Obs: para estar como root digite su (enter) e depois a senha do root (enter). Pronto, o simulador está instalado e pronto para ser usado. 2
2 Compilando o time Faça o download do time trilearnbase para o seu PC. Descompacte o arquivo. Abra um terminal, entre na pasta extraída e execute o comando:./configure Isso irá verificar se você tem as dependências instaladas e criar o Makefile do time. Então, para compilar o time, digite: make O processo acima poderá demorar um pouco. Quanto estiver terminado, o time base estará compilado e pronto para ser executado. 3 Executando o simulador e o time Para executar o simulador, abra um terminal e digite: rcsoccersim Para carregar o seu time, abra um outro terminal, navegue até a pasta na qual ele está e digite:./start.sh Para rodar o mesmo time, ou um time que esteja em uma pasta diferente e que tenha o mesmo nome, vá na pasta desse time e digite:./start.sh localhost time2 Onde time2 pode ser substituído pelo nome que você quer que apareça no monitor. É necessário fornecer um nome diferente do time original, caso contrário, o simulador entenderá que mais de 11 jogadores do mesmo time estão tentando entrar na partida, o que não é possível. 3.1 Iniciando a partida Depois que os jogadores entrarem em campo, clique em Referee->kickoff no menu do monitor do simulador para o jogo começar, ou use o atalho Ctrl+K. Quando o primeiro tempo acabar, clique novamente no botão para iniciar o segundo tempo. 3
Para aumentar a tela de exibição maximize a tela do jogo (como em qualquer outro programa). Se o campo não ocupar todo o espaço disponível use a tecla I. Para vizualizar em modo Full Screen clique em View->Full Screen ou use a tecla F11. Para encerrar o simulador clique em Monitor->Quit, no canto direito, ou use o atalho Ctrl+Q. 3.2 Opções do monitor da simulação 3.2.1 Cone de visão Você pode ver o cone de visão usado atualmente por cada jogador. Para isso aperte a tecla V e depois o número do jogador. Caso queira ver o cone de visão do outro time, aperte e a tecla V e depois Ctrl + número do jogador. Para ver os cones de visão dos jogadores 10 e 11, pressione 0 e -, respectivamente. 3.2.2 Mais informações do jogo Para ver opções de mais atalhos no monitor clique em Help->Shortcut Keys. 4 Executando o arquivo de log Após a execução de cada jogo um arquivo de log, contendo toda a partida, é criado seguindo o modelo ANO_MES_DIA_-time1-time2. Na verdade, são criados 2 arquivos, um com extensão.rcg e o outro com extensão.rcl. Precisaremos apenas do.rcg. Para executar o log, abra um terminal, navegue até a pasta onde o log está e digite: rcsslogplay arquivo.rcg Serão abertas 2 janelas: uma mostrando o jogo e a outro com os controles do log. Nessa janela de controles você poderá iniciar a partida (clicando no botão de play), retroceder, avançar, pausar, passar em câmera lenta, etc. O usuário também pode ir diretamente para um determinado ciclo da partida, apenas digitando o ciclo desejado no campo especificado e clicando em go. O logplayer é muito usado para avaliar o desempenho do time. 5 Compilando o simulador para a sua distribuição Caso você não consiga usar o simulador que está no site, talvez seja necessário compilá-lo para a sua distribuição. 5.1 Instalação das dependências Instale os seguintes pacotes: libltdl-dev libboost-system1.40-dev libboost-filesystem1.40-dev 4
libboost-program-options1.40-dev libqt4-dev libxt-dev gawk gcc g++ tcsh No modo texto logue como root e digite: apt-get update <atualiza a lista de pacotes disponíveis na internet> apt-get install libltdl-dev libboost-system1.40-dev \ libboost-filesystem1.40-dev libboost-program-options1.40-dev \ libxaw7-dev libqt4-dev libxt-dev gawk gcc g++ tcsh \ libaudio-dev libpng-dev libglib-dev libxrender-dev \ libfreetype-dev libxext-dev libfontconfig-dev <Pode copiar as cinco linhas acima de uma só vez. Esse comando instala todos os pacotes necessários.> Quando for compilar pode-se deixar a versão do libboost que já está instalada. Por exemplo, se a versão instalada é a libboost-filesystem1.42-dev, não será necessário instalar a versão 1.40. Dependendo da sua distribuição, os nomes dos pacotes anteriores podem variar um pouco. 5.2 Download do código fonte do simulador Depois de instalado, faça o download dos pacotes fonte no site oficial da Simulação 2D e 3D: http: //sourceforge.net/projects/sserver/files/. Pegue a última versão disponível dos pacotes rcssserver, rcssmonitor e rcsslogplayer. 5.3 Alterações no código fonte Nessa última versão do simulador tivemos que fazer alguns pequenos ajustes no código fonte a fim de que fosse possível compilá-lo. Descompacte os pacotes faça as seguintes alterações: Arquivo rcssserver-14.0.3/rcssbase/conf/parser.cpp 1. na linha 46: substituir #include <boost/spirit.hpp> por #include <boost/spirit/include/classic.hpp> 2. em todo o arquivo: substituir boost::spirit:: por 5
boost::spirit::classic:: Faz-se isso pois quando compila-se com o include original, o compilador dá um warning pedindo para fazer a substituição mostrada no item 1. Nas novas versões do libboost, algumas bibliotecas mudaram de nome e de lugar, fazendo com que seja necessária a alteração mostrada no item 1 e 2. Arquivo rcsslogplayer-14.0.1/qt4/main.cpp 1. abaixo de #include "options.h": #include <locale.h> 2. abaixo de QApplication app( argc, argv );: setlocale (LC_NUMERIC,"C"); Arquivo rcssmonitor-14.1.0/src/main.cpp 1. abaixo de #include <iostream>: #include <locale.h> 2. abaixo de QApplication app( argc, argv );: setlocale (LC_NUMERIC,"C"); Essa alteração nos dois arquivos acima são necessárias porque o servidor usa um ponto para a separação decimal de números. Assim, quando o servidor cria uma string contendo as posições e velocidades dos jogadores em campo e da bola, os números lá inseridos possuem um ponto como separador decimal. Essa string é enviada para o monitor e para o arquivo de log, a fim de que a partida seja visualizada. Porém, quando o monitor (ou o logplayer) converte os números contidos na string recebida do servidor para uma variável do tipo float, ele usa a função do C strtof, que utiliza as configuração locais do usuário para saber qual é o separador decimal. Como no Brasil o separador decimal é a vírgula, a função não reconhece o ponto como separador decimal, causando uma leitura errada dessa string, que por sua vez causa uma paralisação da exibição da partida. As alterações acima mudam as configurações locais do usuário referente à separação decimal para o ponto, ao invés da vírgula. Essas alterações são efetuadas apenas para aquele programa, não alterando as definições do usuário permanentemente. Arquivo rcssserver-14.0.3/src/field.cpp 1. comente a linha 1206 Arquivo rcssserver-14.0.3/src/player.cpp 1. comente as linhas 1281 e 1282 Deve-se comentar essas linhas nos dois arquivos acima, para que não sejam mostrados no terminal messagens desnecessários. 6
5.4 A compilação Compile cada um dos pacotes e instale-os, seguindo a ordem: rcssserver, rcssmonitor e rcsslogplayer. Lembre-se que não deve haver espaços no nome das pastas. Para compilar cada pacote, abra um terminal, navegue até a pasta do pacote extraído e execute os comandos:./configure --prefix=/usr make Após isso, o pacote estará compilado. Para instalá-lo recomendamos usar o checkinstall, um programa que gera um pacote para a sua distribuição, fazendo com que você possa administrá-lo posteriormente de uma forma mais fácil. Para usar o checkinstall, instale-ousando o gerenciador de pacotes da sua distribuição. Então, após ter compilado o determinado pacote do simulador digite, como root: checkinstall Responda as perguntas atenciosamente. O programa irá criar o pacote e instalá-lo, ou então apenas criar o pacote, deixando para você a tarefa de instalá-lo. 7