Mercurial > sdl-ios-xcode
annotate README.MiNT @ 1269:905d5b482f2a
Some explanation on why SDL_RWFromFP doesn't always work on Win32
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Thu, 26 Jan 2006 06:10:34 +0000 |
| parents | a8068adf156b |
| children | 2405517b5eab |
| 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 | 62 Audio (Hardware, XBIOS, GSXB, MCSN, STFA, /dev/audio if threads enabled) |
| 63 Threads (Multitasking OS only via GNU pth library) | |
| 64 Shared object loader (using LDG library from http://ldg.atari.org/) | |
| 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 |
|
1237
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
71 xbios gemdos xbios vbl(2) xbios(3) |
|
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
72 xbios bios xbios vbl(2) xbios(3) |
|
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
73 gem gem gem(1) vbl(2) xbios(3) |
|
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 |
|
6ded3dd929f5
Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents:
1106
diff
changeset
|
78 xbios MiNT Uses MiNT thread |
|
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 |
|
1237
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
90 to report this type event. Under MiNT, using XBIOS mouse driver is not possible. |
|
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
91 |
|
557
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
92 (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
|
93 supported via the pth library. |
|
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
94 |
|
1237
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
95 (3) Redirecting XBIOS vectors does not work under MiNT, so it is disabled in |
|
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
96 this case. |
|
a8068adf156b
Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later.
Patrice Mandin <patmandin@gmail.com>
parents:
1112
diff
changeset
|
97 |
|
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
98 ============================================================================== |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
99 V. Environment variables: |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
100 |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
101 SDL_VIDEODRIVER: |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
102 Set to 'xbios' to force xbios video driver |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
103 Set to 'gem' to force gem video driver |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
104 |
|
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
105 SDL_VIDEO_GL_DRIVER: |
|
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
106 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
|
107 |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
108 SDL_AUDIODRIVER: |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
109 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
|
110 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
|
111 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
|
112 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
|
113 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
|
114 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
|
115 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
|
116 |
|
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
117 SDL_ATARI_EVENTSDRIVER |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
118 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
|
119 Set to 'gemdos' to force gemdos keyboard driver |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
120 Set to 'bios' to force bios keyboard driver |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
121 |
|
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
122 SDL_JOYSTICK_ATARI: |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
123 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
|
124 disable a joystick: |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
125 |
|
305
9c6613983e85
Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents:
302
diff
changeset
|
126 '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
|
127 '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
|
128 '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
|
129 '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
|
130 '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
|
131 '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
|
132 '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
|
133 '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
|
134 '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
|
135 '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
|
136 '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
|
137 |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
138 Default configuration is: |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
139 'ikbd-joy1-on' (if IKBD events driver enabled) |
|
305
9c6613983e85
Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents:
302
diff
changeset
|
140 '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
|
141 '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
|
142 |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
143 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
|
144 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
|
145 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
|
146 setting another controller. |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
147 |
|
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
148 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
|
149 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
|
150 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
|
151 port 0 port 0 port 1 |
|
524fd51f5d2c
Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents:
1095
diff
changeset
|
152 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
|
153 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
|
154 |
|
963
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
155 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
|
156 - 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
|
157 - 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
|
158 - 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
|
159 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
|
160 |
|
319
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 VI. More informations about drivers: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
163 |
|
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
164 OpenGL: |
|
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
165 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
|
166 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
|
167 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
|
168 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
|
169 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
|
170 |
|
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
171 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
|
172 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
|
173 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
|
174 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
|
175 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
|
176 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
|
177 searching for the function "glOrtho6d". |
|
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
178 |
|
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
179 Xbios video: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
180 Video chip is detected using the _VDO cookie. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
181 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
|
182 use them. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
183 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
184 ST, STE, Mega ST, Mega STE: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
185 320x200x4 bits, shades of grey, available only for the purpose |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
186 of testing SDL. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
187 TT: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
188 320x480x8 and 320x240x8 (software double-lined mode). |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
189 Falcon: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
190 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
|
191 BlowUp and Centscreen extended modes, ScreenBlaster 3 current mode. |
|
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
192 Clones and any machine with monochrome monitor: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
193 Not supported. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
194 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
195 Gem video: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
196 Automatically used if xbios not available. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
197 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
198 All machines: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
199 Only the current resolution, if 8 bits or higher depth. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
200 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
201 IKBD keyboard, mouse and joystick driver: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
202 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
|
203 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
204 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
|
205 driver is disabled. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
206 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
207 Gemdos and bios keyboard driver: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
208 Available on all machines. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
209 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
210 Mouse and joystick xbios driver: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
211 Available on all machines (I think). |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
212 |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
213 Joypad driver: |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
214 Available if _MCH cookie is STE or Falcon. |
|
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
215 |
|
557
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
216 PTH timer driver: |
|
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
217 Available with multitasking OS. |
|
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
218 |
|
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
219 VBL timer driver: |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
220 Available on all machines (I think). |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
221 |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
222 Audio drivers: |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
223 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
|
224 capabilities. |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
225 |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
226 STE, Mega STE, TT: |
|
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
227 8 bits DMA (hardware access) |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
228 STFA, MCSN or GSXB driver if installed |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
229 Falcon: |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
230 8 bits DMA (hardware access) |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
231 Xbios functions |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
232 STFA, MCSN or GSXB driver if installed |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
233 Other machines: |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
234 STFA, MCSN or GSXB driver if installed |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
235 |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
236 STFA driver: |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
237 http://removers.free.fr/softs/stfa.html |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
238 GSXB driver: |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
239 http://assemsoft.atari.org/gsxb/ |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
240 MacSound driver: |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
241 http://jf.omnis.ch/software/tos/ |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
242 MagicSound driver (MCSN,GSXB compatible): |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
243 http://perso.wanadoo.fr/didierm/ |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
244 X-Sound driver (GSXB compatible): |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
245 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
|
246 |
|
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
247 -- |
|
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
248 Patrice Mandin <pmandin@caramail.com> |
|
314
bff64eba7721
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
305
diff
changeset
|
249 http://membres.lycos.fr/pmandin/ |