Mercurial > sdl-ios-xcode
annotate README.MiNT @ 4427:eada7e321df6 SDL-1.2
Fixed bug #943
Ozkan Sezer 2010-02-06 12:31:06 PST
Hi:
Here are some small fixes for compiling SDL against mingw-w64.
(see http://mingw-w64.sourceforge.net/ . Despite the name, it
supports both win32 and win64.) Two patches, one for SDL-1.2
and one for SDL-1.3 attached.
src/audio/windx5/directx.h and src/video/windx5/directx.h (both
SDL-1.2 and SDL-1.3.) I get compilation errors about some union
not having a member named u1 and alike, because of other system
headers being included before this one and them already defining
DUMMYUNIONNAME and stuff. This header probably assumes that those
stuff are defined in windef.h, but mingw-w64 headers define them
in _mingw.h. Easily fixed by moving NONAMELESSUNION definition to
the top of the file. SDL_dx5yuv.c (SDL-1.2-only) also needs to
include the header before SDL_video.h to avoid the same problem.
src/thread/win32/SDL_systhread.c (both SDL-1.2 and SDL-1.3.) :
The __GNUC__ case for pfnSDL_CurrentBeginThread is 32-bit centric
because _beginthreadex returns uintptr_t, not unsigned long which
is 32 bits in win64. Changing the return type to uintptr_t fixes
it.
Hope these are useful. Thanks.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Wed, 10 Mar 2010 15:04:13 +0000 |
parents | a1a337237d42 |
children |
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) |
1420
2405517b5eab
Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents:
1237
diff
changeset
|
58 Mouse (XBIOS, GEM, Ikbd, /dev/mouse (non working atm, disabled)) |
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
59 Video (XBIOS (Fullscreen), GEM (Windowed and Fullscreen)) |
557
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
60 Timer (VBL vector, GNU pth library) |
963
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
61 Joysticks and joypads (Ikbd, Hardware) |
724 | 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 |
3862
3c4ccd884117
Update to reflect driver changes
Patrice Mandin <patmandin@gmail.com>
parents:
3850
diff
changeset
|
71 xbios gemdos xbios vbl(2) xbios |
3c4ccd884117
Update to reflect driver changes
Patrice Mandin <patmandin@gmail.com>
parents:
3850
diff
changeset
|
72 xbios bios xbios vbl(2) xbios |
3c4ccd884117
Update to reflect driver changes
Patrice Mandin <patmandin@gmail.com>
parents:
3850
diff
changeset
|
73 gem gem gem(1) vbl(2) xbios |
1112
6ded3dd929f5
Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents:
1106
diff
changeset
|
74 |
6ded3dd929f5
Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents:
1106
diff
changeset
|
75 Audio O/S Misc |
6ded3dd929f5
Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents:
1106
diff
changeset
|
76 dma8 All Uses MFP Timer A interrupt |
6ded3dd929f5
Document recent audio updates
Patrice Mandin <patmandin@gmail.com>
parents:
1106
diff
changeset
|
77 xbios TOS Uses MFP Timer A interrupt |
3862
3c4ccd884117
Update to reflect driver changes
Patrice Mandin <patmandin@gmail.com>
parents:
3850
diff
changeset
|
78 xbios MiNT Uses MFP Timer A interrupt |
4176
d19539d96198
Enable Xbios audio for Magic
Patrice Mandin <patmandin@gmail.com>
parents:
4160
diff
changeset
|
79 xbios Magic Uses MFP Timer A interrupt |
1112
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 |
3862
3c4ccd884117
Update to reflect driver changes
Patrice Mandin <patmandin@gmail.com>
parents:
3850
diff
changeset
|
90 to report this type event. |
1420
2405517b5eab
Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents:
1237
diff
changeset
|
91 A preliminary driver for /dev/mouse device driver is present, but is disabled |
2405517b5eab
Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents:
1237
diff
changeset
|
92 till it can be used with other applications simultaneously. |
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
93 |
557
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
94 (2) If you build SDL with threads using the GNU pth library, timers are |
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
95 supported via the pth library. |
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
96 |
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
97 ============================================================================== |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
98 V. Environment variables: |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
99 |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
100 SDL_VIDEODRIVER: |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
101 Set to 'xbios' to force xbios video driver |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
102 Set to 'gem' to force gem video driver |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
103 |
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
104 SDL_VIDEO_GL_DRIVER: |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
105 Set to filename to load as OpenGL library, if you use SDL_GL_LoadLibrary() |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
106 |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
107 SDL_AUDIODRIVER: |
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
108 Set to 'mint_gsxb' to force Atari GSXB audio driver |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
109 Set to 'mint_mcsn' to force Atari MCSN audio driver |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
110 Set to 'mint_stfa' to force Atari STFA audio driver |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
111 Set to 'mint_xbios' to force Atari Xbios audio driver |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
112 Set to 'mint_dma8' to force Atari 8 bits DMA audio driver |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
113 Set to 'audio' to force Sun /dev/audio audio driver |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
114 Set to 'disk' to force disk-writing audio driver |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
115 |
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
116 SDL_ATARI_EVENTSDRIVER |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
117 Set to 'ikbd' to force IKBD 6301 keyboard driver |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
118 Set to 'gemdos' to force gemdos keyboard driver |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
119 Set to 'bios' to force bios keyboard driver |
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
120 |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
121 SDL_JOYSTICK_ATARI: |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
122 Use any of these strings in the environment variable to enable or |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
123 disable a joystick: |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
124 |
305
9c6613983e85
Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents:
302
diff
changeset
|
125 'ikbd-joy1-[on|off]' for IKBD joystick on port 1 (hardware access) |
9c6613983e85
Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents:
302
diff
changeset
|
126 'xbios-joy1-[on|off]' for IKBD joystick on port 1 (xbios access) |
3850
28db418c7573
Add teamtap support (4 joypads adapter on 1 port)
Patrice Mandin <patmandin@gmail.com>
parents:
1420
diff
changeset
|
127 'porta-pad-[on|off]' for joypad and/or teamtap on port A |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
128 'porta-joy0-[on|off]' for joystick 0 on port A |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
129 'porta-joy1-[on|off]' for joystick 1 on port A |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
130 'porta-lp-[on|off]' for lightpen on port A |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
131 'porta-anpad-[on|off]' for analog paddle on port A |
3850
28db418c7573
Add teamtap support (4 joypads adapter on 1 port)
Patrice Mandin <patmandin@gmail.com>
parents:
1420
diff
changeset
|
132 'portb-pad-[on|off]' for joypad and/or teamtap on port B |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
133 'portb-joy0-[on|off]' for joystick 0 on port B |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
134 'portb-joy1-[on|off]' for joystick 1 on port B |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
135 'portb-anpad-[on|off]' for analog paddle on port B |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
136 |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
137 Default configuration is: |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
138 'ikbd-joy1-on' (if IKBD events driver enabled) |
305
9c6613983e85
Atari port cleanups from Patrice
Sam Lantinga <slouken@libsdl.org>
parents:
302
diff
changeset
|
139 'xbios-joy1-on' (if gemdos/bios/gem events driver enabled) |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
140 'porta-pad-on portb-pad-on' (if available on the machine) |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
141 |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
142 port[a|b]-[pad|joy?|lp|anpad]-* strings are mutually exclusives. |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
143 On such a port, you can only use a joypad OR 1 or 2 joysticks OR |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
144 a lightpen OR an analog paddle. You must disable joypad before |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
145 setting another controller. |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
146 |
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
147 The second joystick port on IKBD is used by the mouse, so not usable. |
1087
8c44005e0979
Document IKBD hardware problem with mouse buttons and joystick fire buttons
Patrice Mandin <patmandin@gmail.com>
parents:
1083
diff
changeset
|
148 Another problem with the IKBD: mouse buttons and joystick fire buttons |
8c44005e0979
Document IKBD hardware problem with mouse buttons and joystick fire buttons
Patrice Mandin <patmandin@gmail.com>
parents:
1083
diff
changeset
|
149 are wired together at the hardware level, it means: |
1106
524fd51f5d2c
Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents:
1095
diff
changeset
|
150 port 0 port 0 port 1 |
524fd51f5d2c
Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents:
1095
diff
changeset
|
151 mouse left button = joystick fire 0 = joystick fire 1 |
524fd51f5d2c
Disable XBIOS in interrupt also under Magic
Patrice Mandin <patmandin@gmail.com>
parents:
1095
diff
changeset
|
152 mouse right button = joystick fire 1 = joystick fire 0 |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
153 |
963
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
154 Descriptions of joysticks/joypads: |
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
155 - Joypads: 1 hat, 17 buttons (Atari Jaguar console-like). |
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
156 - Joysticks: 1 hat, 1 button. |
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
157 - Lightpen, analog paddles: 2 axis, 2 buttons. The 2 buttons are those |
92c247cec42d
No need to try to emulate analog axis when SDL support digital hats
Patrice Mandin <patmandin@gmail.com>
parents:
724
diff
changeset
|
158 affected to 1 button joysticks on the same port. |
302
8a86bdf34f0f
Added Atari joystick support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
281
diff
changeset
|
159 |
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
160 ============================================================================== |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
161 VI. More informations about drivers: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
162 |
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
163 OpenGL: |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
164 The default is to use the Mesa offscreen driver (osmesa.ldg). If you want |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
165 to use an older OpenGL implementation, like mesa_gl.ldg or tiny_gl.ldg, |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
166 your program must use SDL_GL_LoadLibrary() to do so, and retrieve the |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
167 needed function pointers with SDL_LoadFunction(). In all cases, the OpenGL |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
168 context is taken care of by SDL itself, you just have to use gl* functions. |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
169 |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
170 However, there is one OpenGL call that has a different prototype in the old |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
171 implementations: glOrtho(). In the old implementations, it has 6 float as |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
172 parameters, in the standard one, it has 6 double parameters. If you want |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
173 to compile testdyngl, or any other SDL program that loads its OpenGL |
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
174 library, you must change the glOrtho() prototype used in this program. In |
1064
fba6b67b4d60
Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents:
1061
diff
changeset
|
175 osmesa.ldg, you can retrieve a glOrtho() with double parameters, by |
fba6b67b4d60
Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents:
1061
diff
changeset
|
176 searching for the function "glOrtho6d". |
1007
335d9376a2cd
Document new OpenGL feature
Patrice Mandin <patmandin@gmail.com>
parents:
984
diff
changeset
|
177 |
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
178 Xbios video: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
179 Video chip is detected using the _VDO cookie. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
180 Screen enhancers are not supported, but could be if you know how to |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
181 use them. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
182 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
183 ST, STE, Mega ST, Mega STE: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
184 320x200x4 bits, shades of grey, available only for the purpose |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
185 of testing SDL. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
186 TT: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
187 320x480x8 and 320x240x8 (software double-lined mode). |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
188 Falcon: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
189 All modes supported by the current monitor (RVB or VGA). |
1064
fba6b67b4d60
Add Centscreen extended modes support
Patrice Mandin <patmandin@gmail.com>
parents:
1061
diff
changeset
|
190 BlowUp and Centscreen extended modes, ScreenBlaster 3 current mode. |
4335
a1a337237d42
Add a note for experimental Milan support.
Patrice Mandin <patmandin@gmail.com>
parents:
4176
diff
changeset
|
191 Milan: |
a1a337237d42
Add a note for experimental Milan support.
Patrice Mandin <patmandin@gmail.com>
parents:
4176
diff
changeset
|
192 Experimental support |
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
193 Clones and any machine with monochrome monitor: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
194 Not supported. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
195 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
196 Gem video: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
197 Automatically used if xbios not available. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
198 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
199 All machines: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
200 Only the current resolution, if 8 bits or higher depth. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
201 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
202 IKBD keyboard, mouse and joystick driver: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
203 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
|
204 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
205 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
|
206 driver is disabled. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
207 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
208 Gemdos and bios keyboard driver: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
209 Available on all machines. |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
210 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
211 Mouse and joystick xbios driver: |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
212 Available on all machines (I think). |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
213 |
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
214 Joypad driver: |
3850
28db418c7573
Add teamtap support (4 joypads adapter on 1 port)
Patrice Mandin <patmandin@gmail.com>
parents:
1420
diff
changeset
|
215 Available if _MCH cookie is STE or Falcon. Supports teamtap. |
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
216 |
557
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
217 PTH timer driver: |
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
218 Available with multitasking OS. |
0ce5a68278fd
Updated Atari port for new system headers (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
219 |
319
189a6a3416c7
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
314
diff
changeset
|
220 VBL timer driver: |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
221 Available on all machines (I think). |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
222 |
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
223 Audio drivers: |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
224 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
|
225 capabilities. |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
226 |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
227 STE, Mega STE, TT: |
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
228 8 bits DMA (hardware access) |
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
229 STFA, MCSN or GSXB driver if installed |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
230 Falcon: |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
231 8 bits DMA (hardware access) |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
232 Xbios functions |
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
233 STFA, MCSN or GSXB driver if installed |
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
319
diff
changeset
|
234 Other machines: |
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
235 STFA, MCSN or GSXB driver if installed |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
236 |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
237 STFA driver: |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
238 http://removers.free.fr/softs/stfa.html |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
239 GSXB driver: |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
240 http://assemsoft.atari.org/gsxb/ |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
241 MacSound driver: |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
242 http://jf.omnis.ch/software/tos/ |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
243 MagicSound driver (MCSN,GSXB compatible): |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
244 http://perso.wanadoo.fr/didierm/ |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
245 X-Sound driver (GSXB compatible): |
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
557
diff
changeset
|
246 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
|
247 |
281
c5010ab8ba35
Added initial support for Atari (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
248 -- |
4160 | 249 Patrice Mandin <patmandin@gmail.com> |
1420
2405517b5eab
Added preliminary support for MiNT /dev/mouse driver (disabled atm)
Patrice Mandin <patmandin@gmail.com>
parents:
1237
diff
changeset
|
250 http://pmandin.atari.org/ |