Este fichero es una traducción al español del fichero allegro/setup/setup.txt en el original. ============================================================================ _____ ______ _______ _ _ _____ / ____| ____|__ __| | | | __ \ | (___ | |__ | | | | | | |__) | \___ \| __| | | | | | | ___/ ____) | |____ | | | |__| | | |_____/|______| |_| \____/|_| por Shawn Hargreaves / David Calvin Introducción ------------ Este programa es una interfaz simple para crear un fichero de configuración de hardware para Allegro (normalmente llamado allegro.cfg). El programa te permite autodetectar la tarjeta de sonido o configurarla manualmente, seleccionar un mapa de teclado y calibrar tu joystick. También tiene un sistema te chequeo para asegurar que los ajustes elegidos funcionan correctamente. Ficheros -------- setup.c - código fuente setup.exe - fichero del programa principal setup.dat - fichero de datos, contiene gráficos y sonidos de prueba setup.txt - lo estás leyendo ahora allegro.cfg - creado por setup.exe para salvar los ajustes Instalación ----------- Si eres usuario de un programa que usa Allegro, la instalación es simple. Copia setup.exe en el directorio del programa que estás usando y ya está. El fichero de configuración siempre será salvado en el directorio actual, ¡ por lo que es esencial que lo ejecutes desde el directorio de tu programa! Si eres un desarrollador de un programa que usa Allegro, puedes distribuir copias de esta utilidad junto con tu código, y modificarlo tanto como desees (mira abajo). Sólo necesitas incluir el fichero setup.exe, ya que setup.dat es enlazado directamente en el ejecutable y por ello no es necesario cuando ejecutes el programa. Uso --- El caso más simple de uso es este: * ejecuta setup.exe * pincha en autodetección * Haz un test para comprobar los ajustes * opcionalmente elige un mapa de teclado * opcionalmente calibra tu joystick * salva y sal del programa Si hay problemas, usa los menús "Digital Driver" y "MIDI Driver" para ajustar tu tarjeta de sonido manualmente. Cuando sobresaltes una opción, un mensaje de ayuda que explica la opción se deslizará por la parte inferior de la pantalla. Personificación --------------- Si quieres distribuir setup con tus programas, estás bienvenido a alterarlo tanto como desees. Particularmente, hay varias cosas fáciles que puedes hacer: * Cambia el define TITLE al comienzo de setup.c, y haz que use el nombre de tu propio programa * Cambia el define CFG_FILE al comienzo de setup.c, para cambiar el nombre del fichero de configuración. Si usas algo diferente de allegro.cfg o sound.cfg, tendrás que llamar call_set_config_file() al comienzo de tu programa para decirle dónde puede encontrar los datos. * Cambia la onda de sonido y el fichero MIDI de setup.dat. * Cambia el bitmap de fondo y la paleta de setup.dat. Puedes usar cualquier imagen de 320x200, pero hay algunas reglas que debes seguir. Tiene que haber un borde vacío (color cero) de al menos 16 pixels de alto en la parte superior e inferior de la imagen. El color cero de tu paleta tiene que ser negro, y el color 255 otro color (ej: un gris claro) que será apropiado para los bordes de los botones y el texto. Los colores de 1 a 15 deben ser un gradiente para el texto multicolor, y los colores 16 a 31 deben ser un gradiente de negro a blanco. Si tienes una imagen usando otra paleta diferente, la cosa más fácil para seguir las reglas es empezar con la paleta usada por tu fichero, y modifícala para que los primeros 32 colores y el color #255 sean como pide el programa setup, moviendo los otros colores usados por tu programa al medio de la paleta (no importa si pierdes algunos colores en este proceso, siempre que tengas otros similares en la paleta). Importa esta paleta en el grabber, y añade tu imagen (que todavía usa tu paleta original) sobre el bitmap de fondo actual. Pincha en él con el botón derecho y selecciona "Color Depth / 32 bit truecolor". Haz doble click en tu paleta para seleccionarla, y otra vez click con el botón derecho en el bitmap y selecciona "Color Depth / 256 color palette" para reducir la imagen otra vez a 8 bits por pixel. ¡Ahora estará usando la paleta correcta! * Cambia la fuente de setup.dat. Esta debe medir 8x16, y cada carácter debe contener un gradiente de 1 (arriba) a 15 (abajo).