     ______   ___    ___
    /\  _  \ /\_ \  /\_ \
    \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___ 
     \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
      \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
       \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
	\/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
				       /\____/
				       \_/__/


             Informacin especfica para MSVC.

    Vase readme.txt para un punto de vista ms general.



====================================
============ notas MSVC ============
====================================

   Estado: completo.



============================================
============ Software requerido ============
============================================

   - Microsoft Visual C++.
   - DirectX reciente y otros ficheros de cabecera del SDK de Windows.
   - compilador djgpp (djdev*.zip, gcc*b.zip, and bnu*b.zip).
   - GNU make (mak*b.zip).
   - Opcional: rm (fil*b.zip). Usado por el comando clean.
   - Opcional: sed (sed*b.zip). Usado por "make depend".
   - Opcional: sort (txt*b.zip). Usado por "fixdll". Use el sort Unix, no el
     sort del DOS!

   Allegro debera funcionar bien con las versiones 4, 5 y 6 de MSVC.

   El SDK de DirectX puede ser obtenido directamente de Microsoft. Una
   versin antigua de los ficheros de cabecera est includa con el MSVC,
   pero Allegro requere una versin ms reciente de esos ficheros. Debera
   copiar los ficheros de cabecera y las libreras actuales a los
   directorios include y lib del MSVC respectivamente, o alterar las
   variables de entorno INCLUDE y LIB para poner los ficheros de cabecera
   del SDK de DirectX antes que los directorios estndar de MSVC.

   El compilador djgpp y las herramientas asociadas pueden ser descargadas
   de su rplica SimTel ms cercana, en el directorio
   /pub/simtelnet/gnu/djgpp/, o puede usar el zip picker que hay en
   http://www.delorie.com/djgpp/. Lea el fichero readme.1st del djgpp para
   obtener ms informacin sobre cmo insstalar djgpp.



============================================
============ Instalando Allegro ============
============================================

   Esto es una distribucin de cdigo fuente, por lo que deber compilar
   Allegro antes de poder usarlo. Para hacer esto deber:

   Ajustar su entorno para que MSVC pueda ser usado desde la lnea de
   comando. Posiblemente tiene un fichero vcvars32.bat que har esto por
   usted. (En Windows NT y Windows 2000 deber ejecutar este fichero siempre
   que habra una sesin DOS, o alternativamente puede configurar las
   variables de entorno en Panel de Control/Sistema/Entorno.)

   Teclee "cd allegro", seguido de "fix.bat msvc", seguido por "make". Ahora
   vaya a hacer algo interesante mientras todo se compila. Cuando acabe de
   compilar, teclee "make install" para que pueda usar la libreria.

   Si adems desea instalar la versin de depuracin de la librera
   (altamente recomendado), teclee ahora "make install DEBUGMODE=1". Las
   maysculas son importantes, por lo que debe ser DEBUGMODE, no debugmode!

   Si adems desea instalar la versin para medir rendimiento de la librera,
   teclee ahora "make install PROFILEMODE=1".

   Si adems desea tener la versin de librera esttica aparte de la DLL por
   defecto, active la variable de entorno "STATICLINK=1" y repita el "make
   install", "make install DEBUGMODE=1", y "make install PROFILEMODE=1".

   Si su copia de Allegro no incluye los ficheros de dependencia makefile.dep
   (poco probable, a no ser que haya ejecutado "make veryclean" en algn
   momento), puede regenerarlos tecleando "make depend".

   Si su copia de Allegro no incluye el fichero de enlazado .def (poco
   probable, a no ser que haya ejecutado "make veryclean" en algn momento),
   puede regenerarlo tecleando "fixdll.bat".

   Una vez el proceso de compilacin haya terminado puede recuperar algo de
   espacio del disco duro ejecutando "make compress", que usa el programa UPX
   para comprimir los ficheros ejecutables y la dll optimizada. Antes de
   ejecutar "make compress", debe ajustar la variable de entorno UPX_BIN para
   que apunte a upx.exe. Deber ejecutar "make compress" antes de "make
   install" si desea que la dll comprimida sea copiada al directorio de
   windows. Para recuperar an ms espacio, puede ejecutar "make clean" para
   librarse de todos los ficheros temporales y documentacin en formato
   HTML.
 


========================================
============ Usando Allegro ============
========================================

   Todas las funciones, variables y estructuras de datos de Allegro estn
   definidas en allegro.h. Debera inclur esto en todos sus programas, y
   enlazar con una de las libreras:

   alleg.lib      - DLL importada con optimizacin
   alld.lib       - DLL importada para depurar
   allp.lib       - DLL importada para medir rendimientos
   alleg_s.lib    - librera optimizada enlazada estticamente
   alld_s.lib     - librera para depurar enlazada estticamente
   allp_s.lib     - librera para medir rendimientos enlazada estticamente

   Cuando use una versin enlazada estticamente de la librera, debe definir
   el smbolo de preprocesador ALLEGRO_STATICLINK antes de inclur los
   ficheros de cabecera de Allegro y enlazar su programa contra Allegro y las
   libreras Win32/DurectX en ese rden (vea la variable LIBRARIES de
   makefile.vc). Tambin debe asegurarse de que su programa est enlazado con
   la versin correcta de la librera C, es decir, la versin DLL multi hilo
   de MSVCRT (o la versin para depurar si procede). Puede cambiar esta
   opcin en Project - Settings - C/C++ - Category: Code Generation - Use
   run-time library.

   No olvide que necesita usar la macro END_OF_MAIN() justo despus de su
   funcin main()!

   Si usa una de las versiones DLL, obviamente necesitar redistribuir la DLL
   adecuada junto con su programa, la cual podr encontrar en el directorio
   allegro/lib/msvc/.

