Manual de usuario AI-Live
Contents
1. 0 6 2 tar gz Extraer el plugin CEGUI tar xzf CEGUI 0 6 2 tar gz Acceder al directorio CEGUI 0 6 2 cd CEGUI 0 6 2 Ejecutar aclocal bootstrap y configure aclocal amp amp bootstrap amp amp configure Compilar el c digo e instalarlo make amp amp sudo make install Volver al directorio anterior cd Descargar OGRE3D wget http downloads sourceforge net ogre ogre v1 6 5 tar bz2 Extraer OGRE3D tar xjf ogre v1 6 5 tar bz2 Acceder al directorio ogre cd ogre Ejecutar aclocal bootstrap y configure aclocal amp amp bootstrap amp amp configure Compilar el c digo e instalarlo make amp amp sudo make install Volver al directorio anterior cd Ejecutar Idconfig sudo Idconfig Una vez instalado todo se pueden borrar las carpetas iniciales del directorio Desktop Manual de usuario Universidad Carlos lll 4 Configuraci n 4 1 Configuraci n de variables de los m dulos La configuraci n de todos los m dulos del proyecto est contenida en el mismo fichero confi ialive situado en el directorio ra z de la aplicaci n A continuaci n se detallan las opciones disponibles que se encuentran dentro del fichero Variables globales para todos los clientes y servidor rootdir directorio ra z del proyecto contiene los archivos necesarios para compilar y ejecutarlo profilesdir directorio de los perfiles de personajes se2. Ejecuci n utilizando script Para lanzar el programa tan s lo hay que ejecutar el script run sh y unos par metros determinados para lanzar los distintos m dulos Esta es la forma de uso y su explicaci n run sh C server manual client s c profile m profile g La opci n C sirve para limpiar trazas y ficheros de estad sticas de los clientes y servidor tiene tres opciones server client y manual que lanzan a su vez el script de limpieza de cada uno de esos m dulos Ej run sh C server C client Manual de usuario Universidad Carlos lll Esta orden limpiar a las trazas y ficheros de estad sticas del cliente y los estados que se generan en el servidor 5 5 Clientes La opci n c profile lanza un cliente de lA utilizando el perfil que se indique El archivo del perfil se debe escribir sin la extensi n propia profile Los perfiles se leen del directorio que se haya especificado en el archivo de configuraci n Si se desea saber c mo a adir nuevos campos se debe consultar el apartado 3 Configuraci n del Manual de referencia Ej run sh c DEFAULT_ACTOR Este ejemplo lanzar a un cliente de inteligencia artificial usando el perfil DEFAULT_ACTOR profile que se debe encontrar bajo el directorio configurado en el archivo conf ialive y con las opciones necesarias para realizar la conexi n al servidor y puerto predeterminados Para lanzar un cliente manual en el script hay que utilizar la opci
3. n m profile especificando igualmente el perfil del actor a utilizar Ej run sh c mike m DEFAULT_ACTOR Este ejemplo ejecuta un cliente de IA utilizando el perfil mike profile y un cliente manual con las caracter sticas del perfil DEFAULT_ACTOR profile 5 6 Servidor Opci n s se utiliza para ejecutar un servidor con las opciones del archivo conf ialive N tese que solo puede haber un servidor escuchando en el mismo puerto de una m quina aunque podr a haber varios servidores utilizando diferentes puertos de escucha Ej run sh s Como ya se coment anteriormente es necesario que como m nimo se lancen el servidor y un cliente Por eso la primera opci n ser la de lanzar el servidor 5 7 GUI Opci n g activa el cliente gr fico 3D con las opciones especificadas en su archivo gui ini que est en el mismo directorio que el binario Las opciones de ese archivo incluyen la ip o nombre del servidor al que conectarse puerto y escenario que representar Ej run sh s c mike m DEFAULT_ACTOR g 5 8 Ayuda Opci n h muestra una peque a ayuda con los par metros disponibles Si se ejecuta el script sin ning n par metro tambi n se muestra esta ayuda de uso 10
4. Manual de usuario Al Live Diciembre 2012 Manual de usuario Universidad Carlos lll ndice 1 Introd UCCi nN en 3 2 HEOQquiSItOS A AET T AN 3 3 Compilaci n A 4 3 1 Compilaci n de toda la aplicaci n mcccccccccononnmnmnnnnnncccncnncccnnnnnccrnnannccr nana 4 3 2 Compilaci n por M AUNOS iii ici 4 3 3 Instalaci n y compilaci n de Ogre3D oooccococicccononancnoncnacnnnnnnacnnnnanccrnnnnaccnnnananos 4 4 CONTIGULACI N siisii ratarea ddidh b iaeoa anaeciaseta edena a aadd ibui naris 6 4 1 Configuraci n de variables de los m dulos ccoomcccoccnncconicncccnnnnaccrnnnnaconnnanano 6 4 2 Configuraci n de Make ooocmoncccccconococncaccccconcnncccrrrcnnncr cnn rca 7 A a EE E ETE E EE 7 5 1 Ejecuci n manual de clientes IA ooococonccccnonicoccnncnannnnnnnncnnnnnnncrnnnnnccrnnnn acera 7 5 2 Ejecuci n manual de clientes manuales mcoccccccccccnnnnccnnnnnncccnnnnnccrnnnnacer rca 8 5 3 Ejecuci n manual del Servidor oommoccccncconnnonccccnnanarnnnnnnncnnnnnnccrnnnnnccrnnnnncrr nn 8 5 4 Ejecuci n del cliente GUl ii ii 9 5 4 Ejecuci n utilizando CP ni 9 O AE T TE 10 DOI RT EE E T E ET 10 A T E E T 10 Ro AYUDA A E 10 Manual de usuario Universidad Carlos lll 1 Introducci n En este manual se explicar n los requisitos necesarios para ejecutar la aplicaci n y que funcione correctamente Posteriormente se detallar n los pasos que se deben realizar para instalar y compilar la aplicaci n Tambi n se explicar n las d
5. e paquetes Synaptic A pesar de que la aplicaci n contiene archivos de CLIPS clp no es necesaria su instalaci n ya que se encuentra embebido en el lenguaje C S que deber existir el directorio common clips que contenga las librer as auxiliares que se usen desde las librer as common clips clips h y common clips main h que se incluyen en el c digo del cliente La aplicaci n tambi n cuenta con un script de ejecuci n que se mencionar m s adelante y para su correcto funcionamiento se necesitar tener instalado xterm y un bash compatible Manual de usuario Universidad Carlos lll Para ejecutar el cliente gr fico 3D se necesita tener instalado Ogre3D en su versi n 1 6 5 Posteriormente indicaremos los pasos para realizar la instalaci n y compilaci n de Ogre3D 3 Compilaci n 3 1 Compilaci n de toda la aplicaci n Para realizar una compilaci n del proyecto entero s lo es necesario ejecutar make en el directorio ra z y ste se encargar de realizar el make de todos y cada uno de los m dulos del sistema que incluyen servidor cliente manual cliente IA y la interfaz GUI 3D Para limpiar ejecutables etc antes de volver a realizar un make se ejecuta make clean igualmente en el directorio ra z para que haga el make clean del resto de m dulos Posteriormente una vez ejecutado el make hay que comprobar que los ejecutables de los clientes y servidor tienen permisos de ejecuci n
6. en el apartado 5 se explica c mo ejecutar cada m dulo En caso de que no los tuvieran ejecutar chmod para proporcionar permisos de ejecuci n 3 2 Compilaci n por m dulos Los m dulos disponibles que conforman el proyecto y que tienen un makefile para compilar por separado son Emotional_engine compila el motor de emociones Hability_engine compila el motor de las habilidades Clips compila el c digo clips Server compila el servidor Client compila el cliente lA Clientmanual compila el cliente manual Gui compila la interfaz Gui 3D Basta con ejecutar make en el directorio en cuesti n Tambi n se puede realizar un make clean de cada m dulo por separado 3 3 Instalaci n y compilaci n de Ogre3D A continuaci n explicamos los pasos necesarios para tener instalado y compilado Ogre3D 1 6 Manual de usuario Universidad Carlos lll Acceder desde un terminal al directorio Desktop cd Desktop Instalar los paquetes necesarios sudo apt get install pkg config build essential autoconf automake libtool libzzip dev libxt dev libxxf86vm dev libxrandr dev libfreeimage dev nvidia cg toolkit checkinstall libfreetype6 dev libpcre3 dev libopenexr dev freeglut dev mesacommon dev libtiff4 dev libglademm 2 4 dev libcppunit dev libxaw7 dev libxaw headers libois dev En caso de que diera error se pueden instalar uno por uno Descargar el plugin CEGUI wget http downloads sourceforge net crayzedsgui CEGUI
7. gan las variables definidas CC gcc compilador a usar PRJCFLAGS g flags generales RM rm orden para borrar archivos Directorios dependientes del directorio ra z eengine_dir CURDIR common emotional_engine clips_dir CURDIR common clips server_dir CURDIR server source client_dir CURDIR client source clientG_dir CURDIR client gui clientM_dir CURDIR clientmanual source common_dir CURDIR common DIRS eengine_dir clips_dir client_dir server_dir clientM_dir client_gui En caso de que se a adiera un nuevo m dulo se deber a indicar en este fichero el directorio que contiene su propio Makefile con las reglas necesarias para compilarlo 5 Ejecuci n Para ejecutar la aplicaci n es necesario que se haya lanzado antes el servidor y despu s los clientes Hay que abrir una terminal para el servidor y una terminal por cada cliente que se quiera utilizar tanto de IA como manual o gr fico Basta con acceder al directorio de cada m dulo y lanzar el ejecutable correspondiente que comentamos a continuaci n para cada caso 5 1 Ejecuci n manual de clientes IA Para ejecutar un cliente de IA hay que acceder al directorio client source desde el ra z del proyecto y ejecutar client Usage client lt ontology gt lt serverhost gt lt port gt lt actor gt lt stage gt default stage is DEFAULT_STAGE default actor is DEFAULT_ACTOR Los par metros que se e
8. io client gui y a continuaci n ejecutar la sentencia gui La primera vez que ejecutemos la aplicaci n despu s de haber instalado y compilado Ogre3D y hayamos elegido utilizar un cliente gr fico nos aparecer un cuadro para elegir diferentes opciones de configuraci n de Ogre como son Display Frequency indica la frecuencia de actualizaci n de la interfaz gr fica FSAA Full Scene Anti Aliasing indica el nivel de difuminaci n de la escena Full Screen se utiliza para elegir si se desea ejecutar la interfaz gr fica en pantalla completa o en ventana RTT Render To Texture Preferred Mode indica el tipo de buffer de renderizado a emplear para la representaci n de la escena VSync Vertical Synchronization se utiliza para elegir si se desea ejecutar la sincronizaci n vertical o no Video Mode muestra las opciones de resoluci n de pantalla en pixeles para ejecutar la interfaz gr fica Posteriormente si se desea modificar estas opciones hay que ir al directorio client gui y abrir el fichero ogre cfg que contiene los valores de estas opciones Una vez con el cliente GUI corriendo se puede alternar entre las distintas perspectivas del escenario o c maras pulsando las teclas 1 2 3 4 o 5 Con la tecla ESC se cierra la interfaz gr fica no el juego Si quedaran ejecutando s lo un cliente IA o manual y uno GUI para finalizar la ejecuci n hay que cerrar antes el GUI 5 4
9. istintas opciones de configuraci n disponibles para cada m dulo de la aplicaci n Por ltimo se indicar al usuario c mo ejecutar la aplicaci n tanto de m dulos por separado como por un script que ejecuta todo y se explicar qu realizar durante la ejecuci n seg n cada m dulo Este documento est dirigido al usuario final 2 Requisitos Ser necesaria una distribuci n de Linux La aplicaci n ha sido probada desde una distribuci n Ubuntu 8 04 de 32 bits considerada como la versi n m s estable ya que la aplicaci n es compatible con el cliente gr fico 3D Para versiones posteriores la aplicaci n funciona pero es posible que existan problemas de compatibilidad con la versi n de Ogre De momento no se ha conseguido realizar la portaci n de la aplicaci n en Windows aunque el c digo fuente es portable y est preparado para ser ejecutado en otras plataformas con soporte de socket de BSD Si por el contrario se utiliza una versi n de Ubuntu de 64 bits es necesario instalar los siguientes paquetes para conseguir lanzar la aplicaci n se puede realizar desde el gestor Synaptic o con sudo apt get install a32 libs y ia32libs dev Ser necesario tener instalado PHP versi n 5 o superior con CLI interfaz de l nea de comandos para poder lanzar los ejecutables No requiere el uso de ning n servidor apache Se puede descargar desde la web http www php net downloads php o buscarlo desde el gestor d
10. rverPATH directorio donde se encuentra el ejecutable del servidor clientPATH directorio del cliente clientManualPATH directorio del cliente manual clientGUIPATH directorio del cliente gr fico ontology nombre del fichero de ontolog a debe estar en el directorio ra z de la aplicaci n port puerto donde el servidor recibe peticiones sizex geometr a x de la ventana xterm sizey geometr a y de la ventana xterm posx incrementos x para colocar las venentas xterm posy incrementos y para colocar las ventanas xterm cleanfiles nombre del script para la limpieza de archivos host ip o hostname de la m quina a la que conectar los clientes Variables para el servidor initial_state initial state server server Variables para el cliente IA client ejecutable del cliente stageC escenario por defecto al que conectar Variables del cliente manual clientmanual ejecutable del cliente manual stageM escenario por defecto al que conectar Variables del cliente gr fico clientgui ejecutable del cliente gr fico Manual de usuario Universidad Carlos lll 4 2 Configuraci n de Make Hay un archivo de configuraci n para make en el mismo directorio ra z del proyecto Como hemos indicado antes este make es el encargado de compilar todo el proyecto que realiza make por cada m dulo independientemente A continuaci n se detallan sus opciones export opci n para que todos los make recursivos ten
11. specifican en orden son la ruta a la ontolog a ip o nombre del servidor puerto al que conectarse y como opciones la ruta del perfil del actor a usar sin la extensi n profile y el escenario al que conectarse Manual de usuario Universidad Carlos lll Este cliente se ejecuta y realiza acciones autom ticamente gracias al m dulo de lA lo que conlleva que no es interactivo con el usuario Para detener la ejecuci n del cliente hay que matar el proceso Ctrl C En caso de que se estuviera ejecutando el cliente con un cliente gr fico se debe cerrar este ltimo primero Al finalizar la ejecuci n se crear un archivo de texto con la traza cuyo nombre es el identificador que se asign al actor Este archivo contendr las acciones que ha realizado una por una por el escenario 5 2 Ejecuci n manual de clientes manuales Para ejecutar un cliente manual hay que acceder al directorio clientmanual source desde el ra z del proyecto y ejecutar client Usage client lt ontology gt lt serverhost gt lt port gt lt actor gt lt stage gt default stage is DEFAULT_STAGE default actor is DEFAULT_ACTOR Los par metros que se utilizan son los mismos que para un cliente de lA Un cliente manual es interactivo es decir el usuario es el que decide las acciones que va a realizar el actor Por cada acci n realizada la aplicaci n mostrar por pantalla las diferentes acciones identificadas por un n mero que puede reali
12. zar junto con los objetos involucrados en la acci n El usuario debe introducir el n mero de la acci n y pulsar ENTER Al contrario que un cliente lA para finalizar la ejecuci n no es necesario matar el proceso ya que una de las acciones que se muestran siempre por pantalla es la de Salir n mero 0 S lo hay que introducir el O y pulsar ENTER para salir del programa En caso de que s lo quedaran ejecutando el cliente manual y un cliente GUI el GUI debe cerrarse antes 5 3 Ejecuci n manual del servidor Para lanzar el servidor hay que acceder al directorio server source y lanzar el ejecutable server Usage server lt ontology gt lt initial state gt lt port gt Los par metros que acompa an al ejecutable son ruta de la ontolog a estado inicial para generar el escenario y el puerto de escucha El servidor al igual que un cliente de lA se lanza y se ejecuta autom ticamente asignando los turnos a los distintos clientes Por la terminal se podr ver la ejecuci n que va realizando Para finalizar la ejecuci n del servidor hay que matar el proceso Ctrl C Se recomienda finalizar las ejecuciones de todos los clientes antes de matar el proceso del servidor Manual de usuario Universidad Carlos lll 5 4 Ejecuci n del cliente GUI Para utilizar el cliente gr fico es necesario haber lanzado antes un servidor y al menos un cliente de IA o manual Una vez lanzados se puede ejecutar el gui accediendo al director
Download Pdf Manuals
Related Search