2002-02-17 19:54:28 +00:00
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
Using the Simple DirectMedia Layer on Atari
|
|
|
|
|
==============================================================================
|
|
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
I. Building the Simple DirectMedia Layer libraries:
|
|
|
|
|
(This step isn't necessary if you have the SDL binary distribution)
|
|
|
|
|
|
|
|
|
|
Do the classic configure, with --disable-shared --enable-static and:
|
|
|
|
|
|
|
|
|
|
Tos version (should run everywhere):
|
|
|
|
|
--disable-audio --disable-threads
|
|
|
|
|
Tos does not support threads, so can not support audio, maybe in a future
|
|
|
|
|
version audio support will be added via interrupts.
|
|
|
|
|
|
|
|
|
|
MiNT version (maybe Magic, only for multitasking OS):
|
|
|
|
|
--disable-pthreads --enable-pth
|
|
|
|
|
Mint and Magic may supports threads, so audio can be used with current
|
|
|
|
|
devices, like Sun audio, or disk-writing support. Like Tos, interrupt
|
|
|
|
|
audio without threads is more suited for Atari machines.
|
|
|
|
|
|
|
|
|
|
Then you can make ; make install it.
|
|
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
II. Building the Simple DirectMedia Layer test programs:
|
|
|
|
|
|
|
|
|
|
Do the classic configure, then make.
|
|
|
|
|
|
|
|
|
|
Run them !
|
|
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
III. Enjoy! :)
|
|
|
|
|
|
|
|
|
|
If you have a project you'd like me to know about, or want to ask questions,
|
|
|
|
|
go ahead and join the SDL developer's mailing list by sending e-mail to:
|
|
|
|
|
|
|
|
|
|
sdl-request@libsdl.org
|
|
|
|
|
|
|
|
|
|
and put "subscribe" into the subject of the message. Or alternatively you
|
|
|
|
|
can use the web interface:
|
|
|
|
|
|
|
|
|
|
http://www.libsdl.org/mailman/listinfo/sdl
|
|
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
IV. What is supported:
|
|
|
|
|
|
|
|
|
|
Keyboard (GEMDOS, BIOS, Ikbd)
|
|
|
|
|
Mouse (XBIOS, GEM, Ikbd)
|
|
|
|
|
Video (XBIOS (Fullscreen), GEM (Windowed and Fullscreen))
|
|
|
|
|
Timer (VBL vector)
|
2002-03-07 20:23:11 +00:00
|
|
|
Joystick and joypad support (Ikbd, Hardware)
|
2002-02-17 19:54:28 +00:00
|
|
|
|
|
|
|
|
- What is missing:
|
|
|
|
|
Audio support (TOS)
|
|
|
|
|
CDROM support (Metados, /dev/cdrom)
|
|
|
|
|
Threads support (TOS)
|
|
|
|
|
|
|
|
|
|
- Driver combinations:
|
2002-03-07 20:23:11 +00:00
|
|
|
Video Kbd Mouse Timer Jstick Joypads
|
|
|
|
|
xbios ikbd ikbd vbl ikbd hardware
|
2002-03-10 03:33:59 +00:00
|
|
|
xbios gemdos xbios vbl xbios hardware
|
|
|
|
|
xbios bios xbios vbl xbios hardware
|
|
|
|
|
gem gem gem vbl xbios hardware
|
2002-02-17 19:54:28 +00:00
|
|
|
|
|
|
|
|
==============================================================================
|
|
|
|
|
V. Environment variables:
|
|
|
|
|
|
|
|
|
|
SDL_ATARI_EVENTSDRIVER
|
|
|
|
|
Set to 'ikbd' to force IKBD 6301 keyboard driver
|
|
|
|
|
Set to 'gemdos' to force gemdos keyboard driver
|
|
|
|
|
Set to 'bios' to force bios keyboard driver
|
|
|
|
|
|
|
|
|
|
SDL_VIDEODRIVER:
|
|
|
|
|
Set to 'xbios' to force xbios video driver
|
|
|
|
|
Set to 'gem' to force gem video driver
|
|
|
|
|
|
2002-03-07 20:23:11 +00:00
|
|
|
SDL_JOYSTICK_ATARI:
|
|
|
|
|
Use any of these strings in the environment variable to enable or
|
|
|
|
|
disable a joystick:
|
|
|
|
|
|
2002-03-10 03:33:59 +00:00
|
|
|
'ikbd-joy1-[on|off]' for IKBD joystick on port 1 (hardware access)
|
|
|
|
|
'xbios-joy1-[on|off]' for IKBD joystick on port 1 (xbios access)
|
2002-03-07 20:23:11 +00:00
|
|
|
'porta-pad-[on|off]' for joypad on port A
|
|
|
|
|
'porta-joy0-[on|off]' for joystick 0 on port A
|
|
|
|
|
'porta-joy1-[on|off]' for joystick 1 on port A
|
|
|
|
|
'porta-lp-[on|off]' for lightpen on port A
|
|
|
|
|
'porta-anpad-[on|off]' for analog paddle on port A
|
|
|
|
|
'portb-pad-[on|off]' for joypad on port B
|
|
|
|
|
'portb-joy0-[on|off]' for joystick 0 on port B
|
|
|
|
|
'portb-joy1-[on|off]' for joystick 1 on port B
|
|
|
|
|
'portb-anpad-[on|off]' for analog paddle on port B
|
|
|
|
|
|
|
|
|
|
Default configuration is:
|
|
|
|
|
'ikbd-joy1-on' (if IKBD events driver enabled)
|
2002-03-10 03:33:59 +00:00
|
|
|
'xbios-joy1-on' (if gemdos/bios/gem events driver enabled)
|
2002-03-07 20:23:11 +00:00
|
|
|
'porta-pad-on portb-pad-on' (if available on the machine)
|
|
|
|
|
|
|
|
|
|
port[a|b]-[pad|joy?|lp|anpad]-* strings are mutually exclusives.
|
|
|
|
|
On such a port, you can only use a joypad OR 1 or 2 joysticks OR
|
|
|
|
|
a lightpen OR an analog paddle. You must disable joypad before
|
|
|
|
|
setting another controller.
|
|
|
|
|
|
|
|
|
|
The second joystick port on IKBD is used by the mouse, so not usable.
|
|
|
|
|
|
|
|
|
|
Joypads are multibuttons controller (Atari Jaguar console-like).
|
|
|
|
|
Joysticks are 1 button, 2 axis controllers.
|
|
|
|
|
Lightpen and analog paddle are 2 buttons, 2 axis controllers. The 2
|
|
|
|
|
buttons are those affected to 1 button joysticks on the same port.
|
|
|
|
|
|
2002-02-17 19:54:28 +00:00
|
|
|
--
|
|
|
|
|
Patrice Mandin <pmandin@caramail.com>
|
2002-03-22 18:11:56 +00:00
|
|
|
http://membres.lycos.fr/pmandin/
|
