Skip to content

Módulos

Vii edited this page Mar 11, 2022 · 6 revisions

Módulos que forman parte de la distribución de DIV

Nombre Ubicación Código fuente Descripción
DOS4GW.EXE \SYSTEM Extensor de 32 bits para DOS de Tenberry Software. Necesario para ejecutar los binarios de DIV de 32 bits, que son casi todos excepto el div_stub (que es de 16 bits) y los DIV32RUN.* (que usan PMODE/W).
D.EXE \ src/div Ejecutable principal. Contiene el IDE, versión para Pentium. En lugar del wstub por defecto de DOS/4GW contiene un wstub personalizado (ver más abajo) que, si detecta una CPU inferior a Pentium, deriva la ejecución a D.386.
D.386 \SYSTEM src/div El IDE, versión para 386.
wstub src/wstub wstub personalizado que detecta el modelo de CPU e inicia el ciclo de ejecución del entorno. Se encarga de invocar el IDE y también el intérprete con debugger (SESSION.*) cuando se ejecuta un programa dentro del entorno.
SESSION.DIV \SYSTEM src/div32run El intérprete con debugger, versión Pentium. Se encarga de interpretar el ejecutable generado por el compilador (EXEC.EXE) y leer los ficheros que le acompañan con la información de debug correspondiente.
SESSION.386 \SYSTEM src/div32run Lo mismo, pero en versión 386.
div_stub src/div_stub Se usa en los programas que genera el compilador. Se trata de un stub muy sencillo que ejecuta DIV32RUN.DLL y le pasa como parámetro el exe y la línea de comandos (getcmd). NOTA: Ahora mismo es compilable pero NO se usa. En su lugar, se usa una cabecera previamente generada (div_stub.h). Esto es así porque el blob puede ser parcheado durante el proceso de compilación y además DIV32RUN asume que tiene un tamaño fijo, por lo que si cambiamos un sólo byte se pueden producir serios problemas.
EXEC.EXE \SYSTEM Es un ejecutable temporal generado por el compilador cuando pulsamos F10 o F11 en el entorno. Consiste únicamente en el div_stub con el bytecode (EML) anexado, junto con algunos datos necesarios para el intérprete. SESSION.* se encarga de abrirlo e interpretarlo.
DIV32RUN.INS \INSTALL src/div32run El intérprete sin debugger, versión Pentium. Al crear el instalador de un juego, se le adjunta el fichero de idioma (SYSTEM\LENGUAJE.INT) y una vez instalado se renombra a DIV32RUN.DLL.
DIV32RUN.386 \INSTALL src/div32run El intérprete sin debugger, versión 386.
DIV32RUN.DLL \INSTALL src/div32run El intérprete sin debugger, con el idioma ya adjunto, listo para ser redistribuido. OJO: Puede ser versión 386 o 586. La versión que encontremos en la carpeta INSTALL depende de qué opción hayamos seleccionado por última vez para generar un instalador.
INSTALL.OVL \INSTALL src/install El ejecutable del instalador que se usa cuando generamos un instalador desde el IDE. Es un EXE con extensión OVL. Al generar el instalador se le anexan datos al final para personalizarlo.
SETUP.OVL \INSTALL setup El programa de configuración de la tarjeta de sonido, incluido opcionalmente junto al juego al generar el instalador. Al igual que INSTALL.OVL, en realidad es un EXE renombrado a OVL. Es el EXEC.EXE resultado de compilar el programa SETUP.PRG (o cualquiera que comience con la instrucción setup_program).

Herramientas

Estas herramientas son externas a DIV. Se usan en algunas fases de la compilación o del testeo, o bien son útiles para otras cosas relacionadas con DIV. No se compilan a menos que sean necesarias, y no se copian con wmake install. Se pueden compilar con wmake tools.

Nombre Código fuente Descripción
bin2h tools/bin2h Se usa para convertir el div_stub en una cabecera (div_stub.h). De momento NO se usa, ver la descripción de div_stub más arriba.
testdll tools/testdll Permite verificar que una DLL carga correctamente en DIV (comparte el mismo código para ello). Además permite examinar una DLL para saber qué partes de la API utiliza y qué funciones exporta.
unpak tools/unpak Permite examinar y descomprimir archivos en formato PAK y formato STP. Está diseñado para ser capaz de recuperar toda la información posible incluso si el archivo está incompleto o corrupto.

Utilidades

Estos programas son accesorios a DIV. Se incluían en la distribución original de DIV pero no disponemos de su código fuente o bien ya han quedado obsoletos.

Nombre Ubicación Descripción
DC.EXE \SYSTEM Programa de (des)cifrado de archivos con una encriptación XOR básica. Servía para (des)cifrar algunos archivos de DIV que se incluían cifrados (concretamente los *.DEF y los LENGUAJE.*). No es compatible con las funciones encode_file y decode_file de DIV 2 ya que usa una cabecera diferente (ver Ficheros encriptados)
DEL_DIV.EXE \SYSTEM Desinstalador de DIV
PCM2WAV.EXE \SYSTEM Convierte archivos en formato PCM a WAV.
PCX2MAP.EXE \SYSTEM Convierte archivos PCX a formato MAP.
TURBOIFS.EXE \SYSTEM Programa para Win32 que permite generar archivos en formato IFS a partir de fuentes TrueType de Windows. Por desgracia la conversión del juego de caracteres tenía algún fallo y no generaba caracteres especiales ni acentos.
Clone this wiki locally