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