README.MiNT
author Patrice Mandin <patmandin@gmail.com>
Wed, 29 Jun 2005 20:38:56 +0000
changeset 1083 9f8aa754622b
parent 1064 fba6b67b4d60
child 1087 8c44005e0979
permissions -rw-r--r--
Direct newbies to what to do
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)
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    58
Mouse (XBIOS, GEM, Ikbd)
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
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    68
- Driver combinations:
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
    69
Video   Kbd     Mouse   Timer   Joysticks Joypads	OpenGL
3b1ba22f5a28 Add support for OpenGL on Atari using OSMesa, the offscreen rendering driver from Mesa
Patrice Mandin <patmandin@gmail.com>
parents: 963
diff changeset
    70
xbios   ikbd    ikbd    vbl(2)  ikbd      hardware	OSMesa
3b1ba22f5a28 Add support for OpenGL on Atari using OSMesa, the offscreen rendering driver from Mesa
Patrice Mandin <patmandin@gmail.com>
parents: 963
diff changeset
    71
xbios   gemdos  xbios   vbl(2)  xbios     hardware	OSMesa
3b1ba22f5a28 Add support for OpenGL on Atari using OSMesa, the offscreen rendering driver from Mesa
Patrice Mandin <patmandin@gmail.com>
parents: 963
diff changeset
    72
xbios   bios    xbios   vbl(2)  xbios     hardware	OSMesa
984
44fd54a0ae5f Add OSMesa OpenGL support to the Atari GEM video driver
Patrice Mandin <patmandin@gmail.com>
parents: 978
diff changeset
    73
gem     gem     gem(1)  vbl(2)  xbios     hardware	OSMesa
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
    74
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    75
(1) GEM does not report relative mouse motion, so xbios mouse driver is used
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
    76
to report this type event.
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    77
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    78
(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
    79
supported via the pth library.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
    80
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    81
==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    82
V.  Environment variables:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    83
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    84
SDL_VIDEODRIVER:
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    85
	Set to 'xbios' to force xbios video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    86
	Set to 'gem' to force gem video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    87
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
    88
SDL_VIDEO_GL_DRIVER:
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
    89
	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
    90
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
    91
SDL_AUDIODRIVER:
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
    92
	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
    93
	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
    94
	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
    95
	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
    96
	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
    97
	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
    98
	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
    99
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   100
SDL_ATARI_EVENTSDRIVER
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   101
	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
   102
	Set to 'gemdos' to force gemdos keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   103
	Set to 'bios' to force bios keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   104
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   105
SDL_JOYSTICK_ATARI:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   106
	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
   107
	disable a joystick:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   108
305
9c6613983e85 Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents: 302
diff changeset
   109
	'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
   110
	'xbios-joy1-[on|off]' for IKBD joystick on port 1 (xbios access)
302
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   111
	'porta-pad-[on|off]' for joypad on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   112
	'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
   113
	'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
   114
	'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
   115
	'porta-anpad-[on|off]' for analog paddle on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   116
	'portb-pad-[on|off]' for joypad on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   117
	'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
   118
	'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
   119
	'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
   120
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   121
	Default configuration is:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   122
		'ikbd-joy1-on' (if IKBD events driver enabled)
305
9c6613983e85 Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents: 302
diff changeset
   123
		'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
   124
		'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
   125
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   126
	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
   127
	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
   128
	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
   129
	setting another controller.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   130
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   131
	The second joystick port on IKBD is used by the mouse, so not usable.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 281
diff changeset
   132
963
92c247cec42d No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents: 724
diff changeset
   133
	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
   134
	- 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
   135
	- 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
   136
	- 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
   137
	  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
   138
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   139
==============================================================================
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   140
VI.  More informations about drivers:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   141
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   142
OpenGL:
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   143
	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
   144
	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
   145
	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
   146
	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
   147
	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
   148
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   149
	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
   150
	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
   151
	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
   152
	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
   153
	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
   154
	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
   155
	searching for the function "glOrtho6d".
1007
335d9376a2cd Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents: 984
diff changeset
   156
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   157
Xbios video:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   158
	Video chip is detected using the _VDO cookie.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   159
	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
   160
	use them.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   161
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   162
	ST, STE, Mega ST, Mega STE:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   163
		320x200x4 bits, shades of grey, available only for the purpose
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   164
		of testing SDL.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   165
	TT:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   166
		320x480x8 and 320x240x8 (software double-lined mode).
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   167
	Falcon:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   168
		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
   169
		BlowUp and Centscreen extended modes, ScreenBlaster 3 current mode.
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   170
	Clones and any machine with monochrome monitor:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   171
		Not supported.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   172
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   173
Gem video:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   174
	Automatically used if xbios not available.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   175
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   176
	All machines:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   177
		Only the current resolution, if 8 bits or higher depth.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   178
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   179
IKBD keyboard, mouse and joystick driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   180
	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
   181
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   182
	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
   183
	driver is disabled.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   184
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   185
Gemdos and bios keyboard driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   186
	Available on all machines.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   187
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   188
Mouse and joystick xbios driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   189
	Available on all machines (I think).
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   190
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   191
Joypad driver:
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   192
	Available if _MCH cookie is STE or Falcon.
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   193
557
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   194
PTH timer driver:
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   195
	Available with multitasking OS.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 398
diff changeset
   196
319
189a6a3416c7 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 314
diff changeset
   197
VBL timer driver:
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   198
	Available on all machines (I think).
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   199
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   200
Audio drivers:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   201
	Cookies _SND, MCSN, STFA and GSXB used to detect supported audio
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   202
	capabilities.
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   203
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   204
	STE, Mega STE, TT:
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   205
		8 bits DMA (hardware access)
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   206
		STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   207
	Falcon:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   208
		8 bits DMA (hardware access)
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   209
		Xbios functions
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   210
		STFA, MCSN or GSXB driver if installed
398
d219b0e02f5f Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents: 319
diff changeset
   211
	Other machines:
644
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   212
		STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   213
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   214
	STFA driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   215
		http://removers.free.fr/softs/stfa.html
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   216
	GSXB driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   217
		http://assemsoft.atari.org/gsxb/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   218
	MacSound driver:
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   219
		http://jf.omnis.ch/software/tos/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   220
	MagicSound driver (MCSN,GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   221
		http://perso.wanadoo.fr/didierm/
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   222
	X-Sound driver (GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents: 557
diff changeset
   223
		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
   224
281
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   225
-- 
c5010ab8ba35 Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
   226
Patrice Mandin <pmandin@caramail.com>
314
bff64eba7721 *** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents: 305
diff changeset
   227
http://membres.lycos.fr/pmandin/