README.MiNT
author Sam Lantinga <slouken@libsdl.org>
Fri, 31 May 2002 04:45:46 +0000
changeset 385 daa944f00154
parent 319 189a6a3416c7
child 398 d219b0e02f5f
permissions -rw-r--r--
*** empty log message ***
     1 
     2 ==============================================================================
     3 Using the Simple DirectMedia Layer on Atari
     4 ==============================================================================
     5 
     6 ==============================================================================
     7 I.  Building the Simple DirectMedia Layer libraries:
     8     (This step isn't necessary if you have the SDL binary distribution)
     9 
    10   Do the classic configure, with --disable-shared --enable-static and:
    11 
    12     Tos version (should run everywhere):
    13       --disable-audio --disable-threads
    14     Tos does not support threads, so can not support audio, maybe in a future
    15     version audio support will be added via interrupts.
    16 
    17     MiNT version (maybe Magic, only for multitasking OS):
    18       --disable-pthreads --enable-pth
    19     Mint and Magic may supports threads, so audio can be used with current
    20     devices, like Sun audio, or disk-writing support. Like Tos, interrupt
    21     audio without threads is more suited for Atari machines.
    22 
    23   Then you can make ; make install it.
    24 
    25 ==============================================================================
    26 II. Building the Simple DirectMedia Layer test programs:
    27 
    28   Do the classic configure, then make.
    29 
    30   Run them !
    31 
    32 ==============================================================================
    33 III.  Enjoy! :)
    34 
    35   If you have a project you'd like me to know about, or want to ask questions,
    36   go ahead and join the SDL developer's mailing list by sending e-mail to:
    37 
    38 	sdl-request@libsdl.org
    39 
    40   and put "subscribe" into the subject of the message. Or alternatively you
    41   can use the web interface:
    42 
    43 	http://www.libsdl.org/mailman/listinfo/sdl
    44   
    45 ==============================================================================
    46 IV.  What is supported:
    47 
    48 Keyboard (GEMDOS, BIOS, GEM, Ikbd)
    49 Mouse (XBIOS, GEM, Ikbd)
    50 Video (XBIOS (Fullscreen), GEM (Windowed and Fullscreen))
    51 Timer (VBL vector)
    52 Joystick and joypad support (Ikbd, Hardware)
    53 
    54 - What is missing:
    55 Audio support (TOS)
    56 CDROM support (Metados, /dev/cdrom)
    57 Threads support (TOS)
    58 
    59 - Driver combinations:
    60 Video	Kbd	Mouse	Timer	Jstick	Joypads
    61 xbios	ikbd	ikbd	vbl	ikbd	hardware
    62 xbios	gemdos	xbios	vbl	xbios	hardware
    63 xbios	bios	xbios	vbl	xbios	hardware
    64 gem	gem	gem(*)	vbl	xbios	hardware
    65 
    66 (*) GEM does not report relative mouse motion, so xbios mouse driver is used
    67 to report this type event.
    68 
    69 ==============================================================================
    70 V.  Environment variables:
    71 
    72 SDL_ATARI_EVENTSDRIVER
    73 	Set to 'ikbd' to force IKBD 6301 keyboard driver
    74 	Set to 'gemdos' to force gemdos keyboard driver
    75 	Set to 'bios' to force bios keyboard driver
    76 
    77 SDL_VIDEODRIVER:
    78 	Set to 'xbios' to force xbios video driver
    79 	Set to 'gem' to force gem video driver
    80 
    81 SDL_JOYSTICK_ATARI:
    82 	Use any of these strings in the environment variable to enable or
    83 	disable a joystick:
    84 
    85 	'ikbd-joy1-[on|off]' for IKBD joystick on port 1 (hardware access)
    86 	'xbios-joy1-[on|off]' for IKBD joystick on port 1 (xbios access)
    87 	'porta-pad-[on|off]' for joypad on port A
    88 	'porta-joy0-[on|off]' for joystick 0 on port A
    89 	'porta-joy1-[on|off]' for joystick 1 on port A
    90 	'porta-lp-[on|off]' for lightpen on port A
    91 	'porta-anpad-[on|off]' for analog paddle on port A
    92 	'portb-pad-[on|off]' for joypad on port B
    93 	'portb-joy0-[on|off]' for joystick 0 on port B
    94 	'portb-joy1-[on|off]' for joystick 1 on port B
    95 	'portb-anpad-[on|off]' for analog paddle on port B
    96 
    97 	Default configuration is:
    98 		'ikbd-joy1-on' (if IKBD events driver enabled)
    99 		'xbios-joy1-on' (if gemdos/bios/gem events driver enabled)
   100 		'porta-pad-on portb-pad-on' (if available on the machine)
   101 
   102 	port[a|b]-[pad|joy?|lp|anpad]-* strings are mutually exclusives.
   103 	On such a port, you can only use a joypad OR 1 or 2 joysticks OR
   104 	a lightpen OR an analog paddle. You must disable joypad before
   105 	setting another controller.
   106 
   107 	The second joystick port on IKBD is used by the mouse, so not usable.
   108 
   109 	Joypads are multibuttons controller (Atari Jaguar console-like).
   110 	Joysticks are 1 button, 2 axis controllers.
   111 	Lightpen and analog paddle are 2 buttons, 2 axis controllers. The 2
   112 	buttons are those affected to 1 button joysticks on the same port.
   113 
   114 ==============================================================================
   115 VI.  More informations about drivers:
   116 
   117 Xbios video:
   118 	Video chip is detected using the _VDO cookie.
   119 	Screen enhancers are not supported, but could be if you know how to
   120 	use them.
   121 
   122 	ST, STE, Mega ST, Mega STE:
   123 		320x200x4 bits, shades of grey, available only for the purpose
   124 		of testing SDL.
   125 	TT:
   126 		320x480x8 and 320x240x8 (software double-lined mode).
   127 	Falcon:
   128 		All modes supported by the current monitor (RVB or VGA).
   129 	Clones and any machine with monochrome monitor:
   130 		Not supported.
   131 
   132 Gem video:
   133 	Automatically used if xbios not available.
   134 
   135 	All machines:
   136 		Only the current resolution, if 8 bits or higher depth.
   137 
   138 IKBD keyboard, mouse and joystick driver:
   139 	Available if _MCH cookie is ST, Mega ST, STE, Mega STE, TT or Falcon.
   140 
   141 	Hades has an IKBD, but xbios is not available for video, so IKBD
   142 	driver is disabled.
   143 
   144 Gemdos and bios keyboard driver:
   145 	Available on all machines.
   146 
   147 Mouse and joystick xbios driver:
   148 	Available on all machines (I think).
   149 
   150 Joypad driver:
   151 	Available if _MCH cookie is STE or Falcon.
   152 
   153 VBL timer driver:
   154 	Available all machines (I think).
   155 
   156 -- 
   157 Patrice Mandin <pmandin@caramail.com>
   158 http://membres.lycos.fr/pmandin/