README.MiNT
author Sam Lantinga <slouken@libsdl.org>
Tue, 05 Mar 2002 19:55:32 +0000
changeset 292 eadc0746dfaf
parent 281 c5010ab8ba35
child 302 8a86bdf34f0f
permissions -rw-r--r--
Added SDL_LockRect() and SDL_UnlockRect()
Incorporated XFree86 extension libraries into the source
slouken@281
     1
slouken@281
     2
==============================================================================
slouken@281
     3
Using the Simple DirectMedia Layer on Atari
slouken@281
     4
==============================================================================
slouken@281
     5
slouken@281
     6
==============================================================================
slouken@281
     7
I.  Building the Simple DirectMedia Layer libraries:
slouken@281
     8
    (This step isn't necessary if you have the SDL binary distribution)
slouken@281
     9
slouken@281
    10
  Do the classic configure, with --disable-shared --enable-static and:
slouken@281
    11
slouken@281
    12
    Tos version (should run everywhere):
slouken@281
    13
      --disable-audio --disable-threads
slouken@281
    14
    Tos does not support threads, so can not support audio, maybe in a future
slouken@281
    15
    version audio support will be added via interrupts.
slouken@281
    16
slouken@281
    17
    MiNT version (maybe Magic, only for multitasking OS):
slouken@281
    18
      --disable-pthreads --enable-pth
slouken@281
    19
    Mint and Magic may supports threads, so audio can be used with current
slouken@281
    20
    devices, like Sun audio, or disk-writing support. Like Tos, interrupt
slouken@281
    21
    audio without threads is more suited for Atari machines.
slouken@281
    22
slouken@281
    23
  Then you can make ; make install it.
slouken@281
    24
slouken@281
    25
==============================================================================
slouken@281
    26
II. Building the Simple DirectMedia Layer test programs:
slouken@281
    27
slouken@281
    28
  Do the classic configure, then make.
slouken@281
    29
slouken@281
    30
  Run them !
slouken@281
    31
slouken@281
    32
==============================================================================
slouken@281
    33
III.  Enjoy! :)
slouken@281
    34
slouken@281
    35
  If you have a project you'd like me to know about, or want to ask questions,
slouken@281
    36
  go ahead and join the SDL developer's mailing list by sending e-mail to:
slouken@281
    37
slouken@281
    38
	sdl-request@libsdl.org
slouken@281
    39
slouken@281
    40
  and put "subscribe" into the subject of the message. Or alternatively you
slouken@281
    41
  can use the web interface:
slouken@281
    42
slouken@281
    43
	http://www.libsdl.org/mailman/listinfo/sdl
slouken@281
    44
  
slouken@281
    45
==============================================================================
slouken@281
    46
IV.  What is supported:
slouken@281
    47
slouken@281
    48
Keyboard (GEMDOS, BIOS, Ikbd)
slouken@281
    49
Mouse (XBIOS, GEM, Ikbd)
slouken@281
    50
Video (XBIOS (Fullscreen), GEM (Windowed and Fullscreen))
slouken@281
    51
Timer (VBL vector)
slouken@281
    52
slouken@281
    53
- What is missing:
slouken@281
    54
Audio support (TOS)
slouken@281
    55
CDROM support (Metados, /dev/cdrom)
slouken@281
    56
Joystick and joypad support (Hardware)
slouken@281
    57
Threads support (TOS)
slouken@281
    58
slouken@281
    59
- Driver combinations:
slouken@281
    60
Video	Kbd	Mouse	Timer
slouken@281
    61
xbios	ikbd	ikbd	vbl
slouken@281
    62
xbios	gemdos	xbios	vbl
slouken@281
    63
xbios	bios	xbios	vbl
slouken@281
    64
gem	gem	gem	vbl
slouken@281
    65
slouken@281
    66
==============================================================================
slouken@281
    67
V.  Environment variables:
slouken@281
    68
slouken@281
    69
SDL_ATARI_EVENTSDRIVER
slouken@281
    70
	Set to 'ikbd' to force IKBD 6301 keyboard driver
slouken@281
    71
	Set to 'gemdos' to force gemdos keyboard driver
slouken@281
    72
	Set to 'bios' to force bios keyboard driver
slouken@281
    73
slouken@281
    74
SDL_VIDEODRIVER:
slouken@281
    75
	Set to 'xbios' to force xbios video driver
slouken@281
    76
	Set to 'gem' to force gem video driver
slouken@281
    77
slouken@281
    78
-- 
slouken@281
    79
Patrice Mandin <pmandin@caramail.com>
slouken@281
    80
http://www.multimania.com/pmandin