______ ___ ___ /\ _ \ /\_ \ /\_ \ \ \ \L\ \\//\ \ \//\ \ __ __ _ __ ___ \ \ __ \ \ \ \ \ \ \ /'__`\ /'_ `\/\`'__\/ __`\ \ \ \/\ \ \_\ \_ \_\ \_/\ __//\ \L\ \ \ \//\ \L\ \ \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/ \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/ /\____/ \_/__/ Información específica para MSVC. Véase readme.txt para un punto de vista más 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 debería funcionar bien con las versiones 4, 5 y 6 de MSVC. El SDK de DirectX puede ser obtenido directamente de Microsoft. Una versión antigua de los ficheros de cabecera está incluída con el MSVC, pero Allegro requere una versión más reciente de esos ficheros. Debería copiar los ficheros de cabecera y las librerías 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 estándar de MSVC. El compilador djgpp y las herramientas asociadas pueden ser descargadas de su réplica SimTel más 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 más información sobre cómo insstalar djgpp. ============================================ ============ Instalando Allegro ============ ============================================ Esto es una distribución de código 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 línea 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 sesión 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 además desea instalar la versión de depuración de la librería (altamente recomendado), teclee ahora "make install DEBUGMODE=1". ¡Las mayúsculas son importantes, por lo que debe ser DEBUGMODE, no debugmode! Si además desea instalar la versión para medir rendimiento de la librería, teclee ahora "make install PROFILEMODE=1". Si además desea tener la versión de librería estática 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 algún 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 algún momento), puede regenerarlo tecleando "fixdll.bat". Una vez el proceso de compilación 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 aún más espacio, puede ejecutar "make clean" para librarse de todos los ficheros temporales y documentación en formato HTML. ======================================== ============ Usando Allegro ============ ======================================== Todas las funciones, variables y estructuras de datos de Allegro están definidas en allegro.h. Debería incluír esto en todos sus programas, y enlazar con una de las librerías: alleg.lib - DLL importada con optimización alld.lib - DLL importada para depurar allp.lib - DLL importada para medir rendimientos alleg_s.lib - librería optimizada enlazada estáticamente alld_s.lib - librería para depurar enlazada estáticamente allp_s.lib - librería para medir rendimientos enlazada estáticamente Cuando use una versión enlazada estáticamente de la librería, debe definir el símbolo de preprocesador ALLEGRO_STATICLINK antes de incluír los ficheros de cabecera de Allegro y enlazar su programa contra Allegro y las librerías Win32/DurectX en ese órden (vea la variable LIBRARIES de makefile.vc). También debe asegurarse de que su programa esté enlazado con la versión correcta de la librería C, es decir, la versión DLL multi hilo de MSVCRT (o la versión para depurar si procede). Puede cambiar esta opción en Project - Settings - C/C++ - Category: Code Generation - Use run-time library. ¡No olvide que necesita usar la macro END_OF_MAIN() justo después de su función 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/.