
                     _____ ______ _______ _    _ _____
                    / ____|  ____|__   __| |  | |  __ \
                   | (___ | |__     | |  | |  | | |__) |
                    \___ \|  __|    | |  | |  | |  ___/
                    ____) | |____   | |  | |__| | |
                   |_____/|______|  |_|   \____/|_|


                    por Shawn Hargreaves / David Calvin




Introduccin
------------

Este programa es una interfaz simple para crear un fichero de configuracin
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. Tambin tiene un
sistema te chequeo para asegurar que los ajustes elegidos funcionan
correctamente.



Ficheros
--------

setup.c        -  cdigo fuente
setup.exe      -  fichero del programa principal
setup.dat      -  fichero de datos, contiene grficos y sonidos de prueba
setup.txt      -  lo ests leyendo ahora
allegro.cfg    -  creado por setup.exe para salvar los ajustes



Instalacin
-----------

Si eres usuario de un programa que usa Allegro, la instalacin es simple.
Copia setup.exe en el directorio del programa que ests usando y ya est. El
fichero de configuracin 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 cdigo, y modificarlo tanto como desees
(mira abajo). Slo 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 ms simple de uso es este:

   *  ejecuta setup.exe
   *  pincha en autodeteccin
   *  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 mens "Digital Driver" y "MIDI Driver" para
ajustar tu tarjeta de sonido manualmente. Cuando sobresaltes una opcin, un
mensaje de ayuda que explica la opcin se deslizar por la parte inferior de
la pantalla.



Personificacin
---------------

Si quieres distribuir setup con tus programas, ests bienvenido a alterarlo
tanto como desees. Particularmente, hay varias cosas fciles 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 configuracin. Si usas algo diferente de
      allegro.cfg o sound.cfg, tendrs que llamar call_set_config_file() al
      comienzo de tu programa para decirle dnde 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 vaco (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 ms fcil
      para seguir las reglas es empezar con la paleta usada por tu fichero,
      y modifcala 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 aade tu imagen (que todava usa
      tu paleta original) sobre el bitmap de fondo actual. Pincha en l con
      el botn derecho y selecciona "Color Depth / 32 bit truecolor". Haz
      doble click en tu paleta para seleccionarla, y otra vez click con el
      botn 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 carcter
      debe contener un gradiente de 1 (arriba) a 15 (abajo).


