Mercurial > sdl-ios-xcode

annotate README.MiNT @ 1083:9f8aa754622b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Direct newbies to what to do
author Patrice Mandin <patmandin@gmail.com>
date Wed, 29 Jun 2005 20:38:56 +0000
parents fba6b67b4d60
children 8c44005e0979
rev   line source
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/