README.MiNT
author Szymon Wilczek <kazeuser@gmail.com>
Thu, 14 Aug 2008 08:28:19 +0000
branchgsoc2008_manymouse
changeset 3779 5f599ed92fb9
parent 2029 8640d90b0406
permissions -rw-r--r--
Small improvements
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     1
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     2
Using the Simple DirectMedia Layer on Atari
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     3
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     4
1083
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
     5
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
     6
    If you want to build SDL from sources to create SDL programs on Atari:
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
     7
        see sections I - II.
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
     8
	
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
     9
    If you want to create SDL programs on Atari using SDL binary build,
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    10
        download it from my web site (URL at end of this file).
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    11
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    12
    If you want to configure a program using SDL on Atari,
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    13
	    see sections IV - VI.
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    14
9f8aa754622b Direct newbies to what to do
Patrice Mandin <patmandin@gmail.com>
parents: 1064
diff changeset
    15
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    16
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    17
I.  Building the Simple DirectMedia Layer libraries:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    18
    (This step isn't necessary if you have the SDL binary distribution)
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    19
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    20
  Do the classic configure, with --disable-shared --enable-static and:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    21
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    22
    Tos version (should run everywhere):
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    23
      --disable-threads
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    24
    Tos does not support threads.
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    25
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    26
    MiNT version (maybe Magic, only for multitasking OS):
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    27
      --disable-pthreads --enable-pth
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    28
    Mint and Magic may supports threads, so audio can be used with current
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    29
    devices, like Sun audio, or disk-writing support. Like Tos, interrupt
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    30
    audio without threads is more suited for Atari machines.
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    31
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    32
  Then you can make ; make install it.
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    33
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    34
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    35
II. Building the Simple DirectMedia Layer test programs:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    36
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    37
  Do the classic configure, then make.
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    38
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    39
  Run them !
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    40
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    41
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    42
III.  Enjoy! :)
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    43
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    44
  If you have a project you'd like me to know about, or want to ask questions,
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    45
  go ahead and join the SDL developer's mailing list by sending e-mail to:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    46
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    47
	sdl-request@libsdl.org
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    48
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    49
  and put "subscribe" into the subject of the message. Or alternatively you
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    50
  can use the web interface:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    51
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    52
	http://www.libsdl.org/mailman/listinfo/sdl
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    53
  
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    54
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    55
IV.  What is supported:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    56
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
    57
Keyboard (GEMDOS, BIOS, GEM, Ikbd)
1420
2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents: 1237
diff changeset
    58
Mouse (XBIOS, GEM, Ikbd, /dev/mouse (non working atm, disabled))
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    59
Video (XBIOS (Fullscreen), GEM (Windowed and Fullscreen))
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    60
Timer (VBL vector, GNU pth library)
963
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
    61
Joysticks and joypads (Ikbd, Hardware)
724
6b3dfe0198bb Atari CD-ROM support
Patrice Mandin <patmandin@gmail.com>
parents: 651
diff changeset
    62
Audio (Hardware, XBIOS, GSXB, MCSN, STFA, /dev/audio if threads enabled)
6b3dfe0198bb Atari CD-ROM support
Patrice Mandin <patmandin@gmail.com>
parents: 651
diff changeset
    63
Threads (Multitasking OS only via GNU pth library)
6b3dfe0198bb Atari CD-ROM support
Patrice Mandin <patmandin@gmail.com>
parents: 651
diff changeset
    64
Shared object loader (using LDG library from http://ldg.atari.org/)
6b3dfe0198bb Atari CD-ROM support
Patrice Mandin <patmandin@gmail.com>
parents: 651
diff changeset
    65
Audio CD (MetaDOS)
978
3b1ba22f5a28 Add support for OpenGL on Atari using OSMesa, the offscreen rendering driver from Mesa
Patrice Mandin <patmandin@gmail.com>
parents: 963
diff changeset
    66
OpenGL (using Mesa offscreen rendering driver)
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    67
1112
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    68
- Dependent driver combinations:
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    69
Video   Kbd     Mouse   Timer   Joysticks
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    70
xbios   ikbd    ikbd    vbl(2)  ikbd
2028
6dbe2a67b23b Update for recent changes
Patrice Mandin <patmandin@gmail.com>
parents: 1420
diff changeset
    71
xbios   gemdos  xbios   vbl(2)  xbios
6dbe2a67b23b Update for recent changes
Patrice Mandin <patmandin@gmail.com>
parents: 1420
diff changeset
    72
xbios   bios    xbios   vbl(2)  xbios
6dbe2a67b23b Update for recent changes
Patrice Mandin <patmandin@gmail.com>
parents: 1420
diff changeset
    73
gem     gem     gem(1)  vbl(2)  xbios
1112
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    74
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    75
Audio   O/S     Misc
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    76
dma8    All     Uses MFP Timer A interrupt
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    77
xbios	TOS     Uses MFP Timer A interrupt
2028
6dbe2a67b23b Update for recent changes
Patrice Mandin <patmandin@gmail.com>
parents: 1420
diff changeset
    78
xbios   MiNT    Uses MFP Timer A interrupt
1112
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    79
xbios   Magic   Disabled
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    80
stfa    All     Uses MFP interrupt
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    81
mcsn	TOS     Uses MFP Timer A interrupt
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    82
mcsn    MiNT    Uses MiNT thread
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    83
mcsn    Magic   Disabled
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    84
gsxb    All     Uses GSXB callback
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    85
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    86
Joypad driver always uses hardware access.
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
    87
OpenGL driver always uses OSMesa.
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
    88
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    89
(1) GEM does not report relative mouse motion, so xbios mouse driver is used
2028
6dbe2a67b23b Update for recent changes
Patrice Mandin <patmandin@gmail.com>
parents: 1420
diff changeset
    90
to report this type event.
1420
2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents: 1237
diff changeset
    91
A preliminary driver for /dev/mouse device driver is present, but is disabled
2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents: 1237
diff changeset
    92
till it can be used with other applications simultaneously.
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    93
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    94
(2) If you build SDL with threads using the GNU pth library, timers are
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    95
supported via the pth library.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    96
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    97
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    98
V.  Environment variables:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    99
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   100
SDL_VIDEODRIVER:
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   101
	Set to 'xbios' to force xbios video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   102
	Set to 'gem' to force gem video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   103
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   104
SDL_VIDEO_GL_DRIVER:
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   105
	Set to filename to load as OpenGL library, if you use SDL_GL_LoadLibrary()
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   106
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   107
SDL_AUDIODRIVER:
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   108
	Set to 'mint_gsxb' to force Atari GSXB audio driver
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   109
	Set to 'mint_mcsn' to force Atari MCSN audio driver
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   110
	Set to 'mint_stfa' to force Atari STFA audio driver
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   111
	Set to 'mint_xbios' to force Atari Xbios audio driver
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   112
	Set to 'mint_dma8' to force Atari 8 bits DMA audio driver
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   113
	Set to 'audio' to force Sun /dev/audio audio driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   114
	Set to 'disk' to force disk-writing audio driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   115
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   116
SDL_ATARI_EVENTSDRIVER
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   117
	Set to 'ikbd' to force IKBD 6301 keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   118
	Set to 'gemdos' to force gemdos keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   119
	Set to 'bios' to force bios keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   120
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   121
SDL_JOYSTICK_ATARI:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   122
	Use any of these strings in the environment variable to enable or
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   123
	disable a joystick:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   124
305
9c6613983e85 Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents: 302
diff changeset
   125
	'ikbd-joy1-[on|off]' for IKBD joystick on port 1 (hardware access)
9c6613983e85 Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents: 302
diff changeset
   126
	'xbios-joy1-[on|off]' for IKBD joystick on port 1 (xbios access)
2029
8640d90b0406 Add teamtap support
Patrice Mandin <patmandin@gmail.com>
parents: 2028
diff changeset
   127
	'porta-pad-[on|off]' for joypad and/or teamtap on port A
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   128
	'porta-joy0-[on|off]' for joystick 0 on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   129
	'porta-joy1-[on|off]' for joystick 1 on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   130
	'porta-lp-[on|off]' for lightpen on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   131
	'porta-anpad-[on|off]' for analog paddle on port A
2029
8640d90b0406 Add teamtap support
Patrice Mandin <patmandin@gmail.com>
parents: 2028
diff changeset
   132
	'portb-pad-[on|off]' for joypad and/or teamtap on port B
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   133
	'portb-joy0-[on|off]' for joystick 0 on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   134
	'portb-joy1-[on|off]' for joystick 1 on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   135
	'portb-anpad-[on|off]' for analog paddle on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   136
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   137
	Default configuration is:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   138
		'ikbd-joy1-on' (if IKBD events driver enabled)
305
9c6613983e85 Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents: 302
diff changeset
   139
		'xbios-joy1-on' (if gemdos/bios/gem events driver enabled)
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   140
		'porta-pad-on portb-pad-on' (if available on the machine)
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   141
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   142
	port[a|b]-[pad|joy?|lp|anpad]-* strings are mutually exclusives.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   143
	On such a port, you can only use a joypad OR 1 or 2 joysticks OR
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   144
	a lightpen OR an analog paddle. You must disable joypad before
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   145
	setting another controller.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   146
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   147
	The second joystick port on IKBD is used by the mouse, so not usable.
1087
8c44005e0979 Document IKBD hardware problem with mouse buttons and joystick fire buttons
Patrice Mandin <patmandin@gmail.com>
parents: 1083
diff changeset
   148
	Another problem with the IKBD: mouse buttons and joystick fire buttons
8c44005e0979 Document IKBD hardware problem with mouse buttons and joystick fire buttons
Patrice Mandin <patmandin@gmail.com>
parents: 1083
diff changeset
   149
	are wired together at the hardware level, it means:
1106
524fd51f5d2c Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents: 1095
diff changeset
   150
		port 0                port 0           port 1
524fd51f5d2c Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents: 1095
diff changeset
   151
		mouse left button  = joystick fire 0 = joystick fire 1
524fd51f5d2c Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents: 1095
diff changeset
   152
		mouse right button = joystick fire 1 = joystick fire 0
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   153
963
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   154
	Descriptions of joysticks/joypads:
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   155
	- Joypads: 1 hat, 17 buttons (Atari Jaguar console-like).
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   156
	- Joysticks: 1 hat, 1 button.
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   157
	- Lightpen, analog paddles: 2 axis, 2 buttons. The 2 buttons are those
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   158
	  affected to 1 button joysticks on the same port.
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   159
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   160
==============================================================================
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   161
VI.  More informations about drivers:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   162
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   163
OpenGL:
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   164
	The default is to use the Mesa offscreen driver (osmesa.ldg). If you want
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   165
	to use an older OpenGL implementation, like mesa_gl.ldg or tiny_gl.ldg,
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   166
	your program must use SDL_GL_LoadLibrary() to do so, and retrieve the
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   167
	needed function pointers with SDL_LoadFunction(). In all cases, the OpenGL
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   168
	context is taken care of by SDL itself, you just have to use gl* functions.
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   169
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   170
	However, there is one OpenGL call that has a different prototype in the old
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   171
	implementations: glOrtho(). In the old implementations, it has 6 float as
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   172
	parameters, in the standard one, it has 6 double parameters. If you want
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   173
	to compile testdyngl, or any other SDL program that loads its OpenGL
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   174
	library, you must change the glOrtho() prototype used in this program. In
1064
fba6b67b4d60 Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents: 1061
diff changeset
   175
	osmesa.ldg, you can retrieve a glOrtho() with double parameters, by
fba6b67b4d60 Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents: 1061
diff changeset
   176
	searching for the function "glOrtho6d".
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   177
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   178
Xbios video:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   179
	Video chip is detected using the _VDO cookie.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   180
	Screen enhancers are not supported, but could be if you know how to
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   181
	use them.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   182
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   183
	ST, STE, Mega ST, Mega STE:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   184
		320x200x4 bits, shades of grey, available only for the purpose
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   185
		of testing SDL.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   186
	TT:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   187
		320x480x8 and 320x240x8 (software double-lined mode).
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   188
	Falcon:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   189
		All modes supported by the current monitor (RVB or VGA).
1064
fba6b67b4d60 Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents: 1061
diff changeset
   190
		BlowUp and Centscreen extended modes, ScreenBlaster 3 current mode.
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   191
	Clones and any machine with monochrome monitor:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   192
		Not supported.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   193
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   194
Gem video:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   195
	Automatically used if xbios not available.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   196
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   197
	All machines:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   198
		Only the current resolution, if 8 bits or higher depth.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   199
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   200
IKBD keyboard, mouse and joystick driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   201
	Available if _MCH cookie is ST, Mega ST, STE, Mega STE, TT or Falcon.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   202
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   203
	Hades has an IKBD, but xbios is not available for video, so IKBD
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   204
	driver is disabled.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   205
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   206
Gemdos and bios keyboard driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   207
	Available on all machines.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   208
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   209
Mouse and joystick xbios driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   210
	Available on all machines (I think).
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   211
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   212
Joypad driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   213
	Available if _MCH cookie is STE or Falcon.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   214
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   215
PTH timer driver:
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   216
	Available with multitasking OS.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   217
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   218
VBL timer driver:
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   219
	Available on all machines (I think).
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   220
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   221
Audio drivers:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   222
	Cookies _SND, MCSN, STFA and GSXB used to detect supported audio
1112
6ded3dd929f5 Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents: 1106
diff changeset
   223
	capabilities.
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   224
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   225
	STE, Mega STE, TT:
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   226
		8 bits DMA (hardware access)
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   227
		STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   228
	Falcon:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   229
		8 bits DMA (hardware access)
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   230
		Xbios functions
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   231
		STFA, MCSN or GSXB driver if installed
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   232
	Other machines:
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   233
		STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   234
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   235
	STFA driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   236
		http://removers.free.fr/softs/stfa.html
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   237
	GSXB driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   238
		http://assemsoft.atari.org/gsxb/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   239
	MacSound driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   240
		http://jf.omnis.ch/software/tos/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   241
	MagicSound driver (MCSN,GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   242
		http://perso.wanadoo.fr/didierm/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   243
	X-Sound driver (GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   244
		http://www.uni-ulm.de/~s_thuth/atari/xsound_e.html
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   245
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   246
-- 
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   247
Patrice Mandin <pmandin@caramail.com>
1420
2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents: 1237
diff changeset
   248
http://pmandin.atari.org/