33 Detalles especï¿½ficos del DOS

DIGI_*/DOS
GFX_*/DOS
i_love_bill
JOY_TYPE_*/DOS
MIDI_*/DOS
split_modex_screen

Drivers: JOY_TYPE_*/DOS
La biblioteca para DOS soporta los siguientes tipos de parï¿½metros para la funciï¿½n install_joystick():

JOY_TYPE_AUTODETECT
Intenta detectar el joystick instalado. En realidad es imposible distinguir entre todas las posibles configuraciones, por lo que esta rutina sï¿½lo puede elegir el controlador de joystick estï¿½ndar, Sidewider, GamePad Pro, o GrIP, pero usarï¿½ informaciï¿½n del fichero de configuraciï¿½n si ï¿½ste existe (el fichero puede ser creado usando la utilidad setup o llamando a la funciï¿½n save_joystick_data()), por lo que siempre puede usar JOY_TYPE_AUTODETECT en su cï¿½digo y elegir el tipo de hardware exacto desde el programa setup.
JOY_TYPE_NONE
Controlador vacï¿½o para mï¿½quinas sin joystick.
JOY_TYPE_STANDARD
Un joystick normal de dos botones.
JOY_TYPE_2PADS
Modo de joystick dual (dos joysticks, cada uno con dos botones).
JOY_TYPE_4BUTTON
Activa los botones extras de un joystick de 4 botones.
JOY_TYPE_6BUTTON
Activa los botones extras de un joystick de 6 botones.
JOY_TYPE_8BUTTON
Activa los botones extras de un joystick de 8 botones.
JOY_TYPE_FSPRO
Joystick CH Flightstick Pro o compatible, que tiene cuatro botones, un mando de gases analï¿½gico, y un sombrero de 4 direcciones.
JOY_TYPE_WINGEX
Un Logitech Wingman Extreme, que deberï¿½a funcionar con cualquier joystick compatible Thrustmaster Mk.I. Tiene soporte para cuatro botones y un sombrero. Esto tambiï¿½n funciona con el Wingman Warrior, si conecta el conector de 15 pins (ï¿½recuerde desconectar el conector de 9 pins!) y si ajusta el pequeï¿½o interruptor de adelante a la posiciï¿½n "H" (sin embargo, no podrï¿½ usar el mando de gases o el 'spinner').
JOY_TYPE_SIDEWINDER
El pad digital Microsoft Sidewinder (soporta hasta cuatro mandos, cada uno con diez botones y un control digital de direcciï¿½n).
JOY_TYPE_SIDEWINDER_AG
Versiï¿½n alternativa de JOY_TYPE_SIDEWINDER. Pruebe con esto si su Sidewinder no es reconocido con JOY_TYPE_SIDEWINDER.
JOY_TYPE_GAMEPAD_PRO
El Gravis GamePad Pro (soporta dos mandos, cada uno con diez botones y un control digital de direcciï¿½n).
JOY_TYPE_GRIP
Controlador GrIP de Gravis, usando el fichero de controlador grip.gll.
JOY_TYPE_GRIP4
Versiï¿½n del controlador GrIP de Gravis que estï¿½ restringido a moverse sï¿½lamente a lo largo de los cuatro ejes principales.
JOY_TYPE_SNESPAD_LPT1
JOY_TYPE_SNESPAD_LPT2
JOY_TYPE_SNESPAD_LPT3
Pads SNES conectados a los puertos LPT1, LPT2, y LPT3 respectivamente.
JOY_TYPE_PSXPAD_LPT1
JOY_TYPE_PSXPAD_LPT2
JOY_TYPE_PSXPAD_LPT3
Pads PSX conectados a los puertos LPT1, LPT2, y LPT3 respectivamente. Mire http://www.ziplabel.com/dpadpro/index.html para obtener informaciï¿½n sobre el cable paralelo necesario. El controlador automï¿½gicamente detecta quï¿½ tipos de pads PSX estï¿½n conectados de entre los digitales, analï¿½gicos (modo rojo o verde), NegCon, multi taps, pistolas de luz Namco, Jogcons (volantes con retroalimentaciï¿½n de fuerza), y el ratï¿½n. Si el mando no es reconocido es tratado como un mando analï¿½gico, queriendo decir que el controlador deberï¿½a funcionar con casi cualquier cosa. Puede conectar los mandos como desee, pero sï¿½lo serï¿½n usados los primeros 8. El Dual Shock de Sony o el Jogcon de Namco se volverï¿½n a colocar ellos mismos en modo digital despuï¿½s de no haber sido muestreados durante 5 segundos. Esto es normal, pasa lo mismo en una Playstation, estï¿½n diseï¿½ados para detener cualquier vibraciï¿½n en caso de que la mï¿½quina anfitriï¿½n se cuelgue. Otros mandos multifunciï¿½n tendrï¿½n rarezas similares. Sin embargo, si esto le ocurre a un mando Jogcon, el botï¿½n para cambiar de modo serï¿½ desactivado. Para reactivarlo, tendrï¿½ que apretar y mantener pulsados al mismo tiempo los botones Start y Select. El G-con45 necesita ser conectado (y apuntar) a un monitor de tipo TV conectado a su ordenador. La salida compuesta de vï¿½deo de mi tarjeta funciona bien con ï¿½sto (una Hercules Stingray 128/3D 8Mb). Los modos de vï¿½deo TV tambiï¿½n deberï¿½an funcionar en Mame.
JOY_TYPE_N64PAD_LPT1
JOY_TYPE_N64PAD_LPT2
JOY_TYPE_N64PAD_LPT3
Pads N64 conectados a los puertos LPT1, LPT2, y LPT3 respectivamente. Mire http://www.st-hans.de/N64.htm para obtener informaciï¿½n sobre el adaptador hardware necesario. Soporta hasta cuatro mandos en un ï¿½nico puerto paralelo. No es necesario caliblar el control analï¿½gico, ya que ï¿½sto lo hace el mando por si mismo cuando se enciende. Esto significa que el stick tiene que estar centrado cuando el mando es inicializado. Un posible problema que la gente podrï¿½a tener con este controlador es que es fï¿½sicamente imposible poner el stick analï¿½gico totalmente diagonal, pero no veo que esto pueda causar grandes problemas. Esto es debido a la forma del mando donde reposa la palanca del control analï¿½gico. Como el del Gravis Game Pad Pro, este controlador necesita desconectar brevemente las interrupciones de hardware mientras es muestreado. Esto causa un notable impacto en la ejecuciï¿½n de mi maquina con ambos controladores, pero no hay modo de evitarlo. En una (muy) tosca suposiciï¿½n dirï¿½a que ï¿½sto relentiza el Mame un 5%-10%.
JOY_TYPE_DB9_LPT1
JOY_TYPE_DB9_LPT2
JOY_TYPE_DB9_LPT3
Una pareja de joysticks de dos botones conectados al puerto LPT1, LPT2 y LPT3 respectivamente. El primer puerto es compatble con un controlador joy-db9 (multisistema 2 botones), y el segundo es compatible con la interfaz Atari del DirectPad Pro. Lea en el fichero de cï¿½digo fuente (src/dos/multijoy.c) informaciï¿½n de los pines.
JOY_TYPE_TURBOGRAFIX_LPT1
JOY_TYPE_TURBOGRAFIX_LPT2
JOY_TYPE_TURBOGRAFIX_LPT3
Estos controladores soportan hasta 7 joysticks, cada uno con hasta 5 botones, conectados a los puertos LPT1, LPT2 y LPT3 respectivamente. Usan la interfaz TurboGraFX de Steffen Schwenke: mire http://www.burg-halle.de/~schwenke/parport.html para mï¿½s detalles sobre cï¿½mo construir esto.
JOY_TYPE_WINGWARRIOR
Un joystick Wingman Warrior.
JOY_TYPE_IFSEGA_ISA
JOY_TYPE_IFSEGA_PCI
JOY_TYPE_IFSEGA_PCI_FAST
Controlador para las tarjetas con interfaz de joystick IF-SEGA, de la companï¿½a IO-DATA (ï¿½stas existen en variantes PCI, PCI2 e ISA).

Relacionado con: install_joystick.

Drivers: GFX_*/DOS
La librerï¿½a para DOS soporta los siguientes parï¿½metros de tarjeta para la funciï¿½n set_gfx_mode():

GFX_TEXT
Volver al modo texto.
GFX_AUTODETECT
Deja que Allegro escoja un driver grï¿½fico apropiado.
GFX_AUTODETECT_FULLSCREEN
Autodetecta el driver grï¿½fico, pero sï¿½lo usarï¿½ drivers a pantalla completa, fallando si no estï¿½n disponibles en la plataforma actual.
GFX_AUTODETECT_WINDOWED
Igual que el anterior, pero sï¿½lo con drivers en ventana. Esto siempre fallarï¿½ bajo DOS.
GFX_SAFE
Controlador especial para cuando quiere establecer un modo grï¿½fico seguro y no le importa realmente en quï¿½ resoluciï¿½n o profundidad de color. Mire para mï¿½s detalles la documentaciï¿½n de set_gfx_mode().
GFX_VGA
El modo 13h estï¿½ndar de 256 colores de la VGA, usando el controlador GFX_VGA. Este es normalmente 320x200, que le permitirï¿½ trabajar con cualquier VGA pero no soporta pantallas virtuales grandes ni scroll por hardware. Allegro permite tambiï¿½n varias variantes modificadas de este modo que permiten scroll, miden 320x100 (con una pantalla virtual de 200 pixels de altura), 160x120 (con una pantalla virtual de 409 pixels de altura), 256x256 (sin scroll), y 80x80 (con una pantalla virtual de 819 pixels de altura).
GFX_MODEX
El Modo-X funcionarï¿½ en cualquier tarjeta VGA, y permite un rango de resoluciones modificadas de 256 colores.
- Resoluciones estables del modo-X:
  - Razï¿½n de aspecto cuadrado: 320x240
  - Razï¿½n de aspecto oblicuo: 256x224, 256x240, 320x200, 320x400, 320x480, 320x600, 360x200, 360x240, 360x360, 360x400, 360x480
  Estos han funcionado en cada tarjeta/monitor que he probado.
- Resoluciones de modo-X inestables:
  - Razï¿½n de aspecto cuadrado: 360x270, 376x282, 400x300
  - Razï¿½n de aspecto oblicuo: 256x200, 256x256, 320x350, 360x600, 376x308, 376x564, 400x150, 400x600
  Estos sï¿½lo funcionan en algunos monitores. Funcionaron bien en mi vieja mï¿½quina, pero no se llevan bien con mi nuevo monitor. Si estï¿½ preocupado por la posibilidad de daï¿½ar su monitor usando estos modos, no lo estï¿½. Por supuesto no estoy dando ninguna garantï¿½a al respecto, y si su hardware explota es una pena, pero no creo que este tipo de ajustes puedan hacer daï¿½o alguno. De la documentaciï¿½n del programa TWEAK de Robert Schmidt: "Hace tiempo, poner valores o combinaciones ilegales o no soportadas en los registros de la tarjeta de vï¿½deo podï¿½a ser peligroso para su salud y para su monitor. *Nunca* he declarado que esto no pueda pasar si usa TWEAK, pero estoy muy seguro de que esto nunca pasarï¿½. Nunca he oï¿½do que usar TWEAK o cambiar manualmente los registros de la VGA hayan ocasionado daï¿½o alguno."
La mayorï¿½a de las funciones de dibujo en el modo-X son mï¿½s lentas que en el modo 13h, debido a la complejidad de la organizaciï¿½n planar del bitmap, pero los rellenos de ï¿½reas sï¿½lidas y los blits alineados al plano de una parte de la memoria de vï¿½deo a otra pueden ser significativamente mï¿½s rï¿½pidos, particularmente en hardware antiguo. El modo-x accede a las 256k totales de la RAM de la VGA, por lo que el scroll por hardware y el intercambio de pï¿½ginas es posible, y es posible partir la pantalla para mover la parte superior y tener un indicador de estado fijo en la parte inferior.
GFX_VESA1
Usa el controlador VESA 1.x.
GFX_VESA2B
Usa el controlador VBE 2.0 con bancos.
GFX_VESA2L
Usa el controlador VBE 2.0 con framebuffer lineal.
GFX_VESA3
Usa el controlador VBE 3.0. Este es el ï¿½nico controlador VESA que soporta la funciï¿½n request_refresh_rate(). Los modos VESA estï¿½ndares son 640x480, 800x600, y 1024x768. Estos deberï¿½an funcionar con cualquier tarjeta SVGA: si no lo hacen, consiga una copia del Scitech Display Doctor y mire si se soluciona el problema. Las profundidades de color disponibles dependen de su hardware. La mayorï¿½a de las tarjetas soportan resoluciones de 15 y 16 bits, pero si es posible se recomendarï¿½a implementar ambas (no es tan difï¿½cil...) en caso de que una no estï¿½ disponible. Algunas tarjetas permiten color verdadero de 24 y 32 bits, en cuyo caso la elecciï¿½n es entre 24 (salvar memoria) o 32 (va mï¿½s rï¿½pido), pero algunas tarjetas antiguas no tienen modos de 32 bits y algunas nuevas no soportan resoluciones de 24 bits. Use el programa de test vesainfo para saber quï¿½ modos puede visualizar con su controlador VESA. Muchas tarjetas tambiï¿½n soportan 640x400, 1280,1024 y 1600x1200, pero estos modos no siempre estï¿½n disponibles, por ejemplo las tarjetas S3 no tienen modo 640x400. Otras resoluciones raras pueden estar disponibles, ej: algunas tarjetas Tseng tienen un modo 640x350, y la Advance Logic tiene un modo de 512x512. El SciTech Display Doctor provee varios modos de baja resoluciï¿½n en los que puede hacer scroll en un rango diferente de profundidades de color (320x200, 320x240, 320x400, 320x480, 360x200, 360x240, 360x400, y 360x480 funcionan en mi ET4000 a 8, 15 o 16 bits por pixel). Estos modos son fenomenales, permitiï¿½ndle hacer scroll o intercambio de pï¿½ginas sin la complejidad del modo-X, pero desafortunadamente no son un estï¿½ndar, por lo que necesitarï¿½ el Display Doctor para poder usarlos.
GFX_VBEAF
VBE/AF es un superconjunto del estï¿½ndar VBE 2.0, que trae un API para acceder a caracterï¿½sticas de aceleraciï¿½n por hardware. Los controladores VBE/AF actualmente sï¿½lo estï¿½n disponibles desde el proyecto FreeBE/AF o como una parte del pack del SciTech Display Doctor, pero puede proporcionar grandes mejoras en la velocidad si se usa con el hardware adecuado. Para ver una discusiï¿½n detallada sobre la aceleraciï¿½n por hardware, lea la documentaciï¿½n sobre la variable gfx_capabilities. Puede usar el programa test afinfo para comprobar si tiene un controlador VBE/AF, y para ver quï¿½ resoluciones soporta. Los controladores VBE/AF de SciTech requieren que el acceso con nearptr estï¿½ activado, por lo que cualquier puntero errï¿½neo puede bloquear su mï¿½quina cuando estos controladores estï¿½n en uso. Esto significa que puede ser buena idea usar VESA mientras depura su programa, y activar VBE/AF sï¿½lo cuando el cï¿½digo funcione correctamente. Los controladores FreeBE/AF no tienen este problema.
GFX_XTENDED Un modo 640X400 con memoria plana como estï¿½ descrito por Mark Feldman en PCGPE. Usa VESA para seleccionar un modo SVGA (por lo tanto, sï¿½lo funcionarï¿½ en tarjetas que soporten una resoluciï¿½n VESA 640X400), y luego activa la memoria plana como si se fuese a utilizar el modo-x. Esto permite que la pantalla entera pueda ser direccionada sin necesidad de utilizar conmutaciï¿½n de bancos, aunque el scroll por hardware y el intercambio de pï¿½ginas no serï¿½n posibles. Este driver nunca serï¿½ autodetectado (en su lugar el modo VESA 640X400 normal serï¿½ el seleccionado), por lo tanto si desea utilizarlo, deberï¿½ pasar GFX_EXTENDED explï¿½citamente a set_gfx_mode().

Relacionado con: set_gfx_mode.

Drivers: DIGI_*/DOS
Las funciones DOS soportan las siguientes tarjetas de sonido digitales:

      DIGI_AUTODETECT      - permite que Allegro elija un driver de sonido
                             digital
      DIGI_NONE            - sin sonido digital
      DIGI_SB              - Sound Blaster (autodetecciï¿½n)
      DIGI_SB10            - SB 1.0 (8 bit mono single shot dma)
      DIGI_SB15            - SB 1.5 (8 bit mono single shot dma)
      DIGI_SB20            - SB 2.0 (8 bit mono dma autoinicializada)
      DIGI_SBPRO           - SB Pro (8 bit stereo)
      DIGI_SB16            - SB16 (16 bit stereo)
      DIGI_AUDIODRIVE      - ESS AudioDrive
      DIGI_SOUNDSCAPE      - Ensoniq Soundscape
      DIGI_WINSOUNDSYS     - Windows Sound System

Relacionado con: detect_digi_driver, install_sound, install_sound_input.

Drivers: MIDI_*/DOS
Las funciones DOS soportan las siguientes tarjetas de sonido MIDI:

      MIDI_AUTODETECT      - permite que Allegro elija un driver de sonido
                             MIDI
      MIDI_NONE            - sin sonido MIDI
      MIDI_ADLIB           - Adlib o sintetizador FM SB (autodetecciï¿½n)
      MIDI_OPL2            - sintetizador OPL2 (mono, usado en Adlib y SB)
      MIDI_2XOPL2          - sintetizadores duales OPL2 (stereo, usado en SB
                             Pro-I)
      MIDI_OPL3            - sintetizador OPL3 (stereo, SB Pro-II y
                             superiores)
      MIDI_SB_OUT          - interfaz MIDI SB
      MIDI_MPU             - interfaz MIDI MPU-401
      MIDI_DIGMID          - reproductor por software de tablas de ondas
                             basado en samples
      MIDI_AWE32           - AWE32 (chip EMU8000)

Relacionado con: detect_midi_driver, install_sound, install_sound_input.

void split_modex_screen(int line);
Esta funciï¿½n sï¿½lo estï¿½ disponible en modo-X. Permite la divisiï¿½n de la pantalla VGA en dos partes por una lï¿½nea especifica. En la mitad superior de la pantalla puede hacer scroll a cualquier punto de la memoria de video mediante la funciï¿½n scroll_screen(), pero la parte inferior serï¿½ siempre fija y mostrarï¿½ el contenido de la posiciï¿½n (0, 0) del bitmap de pantalla (screen). Tras dividir la pantalla, normalemente querrï¿½ hacer un scroll de forma que la parte superior muestre una zona mï¿½s baja de la memoria de video y despuï¿½s crearï¿½ dos sub-bitmaps para acceder a ambas secciones (en examples/exscroll.c tiene una demostraciï¿½n de cï¿½mo se puede hacer esto). Para desactivar la divisiï¿½n, llame a split_modex_screen(0).

Relacionado con: set_gfx_mode, scroll_screen.

extern int i_love_bill;
Cuando se ejecuta en entorno DOS puro, el temporizador reprograma dinï¿½micamente el reloj para generar interrupciones en los momentos exactos, lo que confiere una exactitud extremadamente alta. Desafortunadamente, esta velocidad constante no funciona correctamente en la mayorï¿½a de sistemas multitarea (sobre todo bajo Windows), por lo tanto, existe un modo alternativo que bloquea la interrupciï¿½n del temporizador por hardware a una velocidad de 200 ticks por segundo. Esto, reduce la fiabilidad del temporizador (por ejemplo, rest() redondearï¿½ el tiempo de espera al 5ï¿½ milisegundo mï¿½s cercano al tiempo especificado), e impide al simulador de retrazo vertical su funcionamiento, pero como punto positivo, permite que los programas de Allegro funcionen bajo Windows. Esta variable es inicializada por allegro_init() si se detecta la presencia de un sistema operativo multitarea y ademï¿½s se activa el modo de temporizador de razï¿½n fija.

Relacionado con: install_timer, allegro_init, os_type.

Volver al Indice