sdl-ios-xcode: README.MiNT annotate

annotate README.MiNT @ 2263:900c35d8e8fd

More work in progress, still doesn't compile...

author	Sam Lantinga <slouken@libsdl.org>
date	Fri, 17 Aug 2007 06:40:12 +0000
parents	8640d90b0406
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 6b3dfe0198bb Atari CD-ROM support Patrice Mandin <patmandin@gmail.com> parents: 651 diff changeset	62 Audio (Hardware, XBIOS, GSXB, MCSN, STFA, /dev/audio if threads enabled)
6b3dfe0198bb Atari CD-ROM support Patrice Mandin <patmandin@gmail.com> parents: 651 diff changeset	63 Threads (Multitasking OS only via GNU pth library)
6b3dfe0198bb Atari CD-ROM support Patrice Mandin <patmandin@gmail.com> parents: 651 diff changeset	64 Shared object loader (using LDG library from http://ldg.atari.org/)
6b3dfe0198bb Atari CD-ROM support Patrice Mandin <patmandin@gmail.com> parents: 651 diff changeset	65 Audio CD (MetaDOS)
978 3b1ba22f5a28 Add support for OpenGL on Atari using OSMesa, the offscreen rendering driver from Mesa Patrice Mandin <patmandin@gmail.com> parents: 963 diff changeset	66 OpenGL (using Mesa offscreen rendering driver)
281 c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	67
1112 6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	68 - Dependent driver combinations:
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	69 Video Kbd Mouse Timer Joysticks
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	70 xbios ikbd ikbd vbl(2) ikbd
2028 6dbe2a67b23b Update for recent changes Patrice Mandin <patmandin@gmail.com> parents: 1420 diff changeset	71 xbios gemdos xbios vbl(2) xbios
6dbe2a67b23b Update for recent changes Patrice Mandin <patmandin@gmail.com> parents: 1420 diff changeset	72 xbios bios xbios vbl(2) xbios
6dbe2a67b23b Update for recent changes Patrice Mandin <patmandin@gmail.com> parents: 1420 diff changeset	73 gem gem gem(1) vbl(2) xbios
1112 6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	74
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	75 Audio O/S Misc
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	76 dma8 All Uses MFP Timer A interrupt
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	77 xbios TOS Uses MFP Timer A interrupt
2028 6dbe2a67b23b Update for recent changes Patrice Mandin <patmandin@gmail.com> parents: 1420 diff changeset	78 xbios MiNT Uses MFP Timer A interrupt
1112 6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	79 xbios Magic Disabled
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	80 stfa All Uses MFP interrupt
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	81 mcsn TOS Uses MFP Timer A interrupt
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	82 mcsn MiNT Uses MiNT thread
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	83 mcsn Magic Disabled
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	84 gsxb All Uses GSXB callback
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	85
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	86 Joypad driver always uses hardware access.
6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	87 OpenGL driver always uses OSMesa.
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	88
557 0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	89 (1) GEM does not report relative mouse motion, so xbios mouse driver is used
2028 6dbe2a67b23b Update for recent changes Patrice Mandin <patmandin@gmail.com> parents: 1420 diff changeset	90 to report this type event.
1420 2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm) Patrice Mandin <patmandin@gmail.com> parents: 1237 diff changeset	91 A preliminary driver for /dev/mouse device driver is present, but is disabled
2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm) Patrice Mandin <patmandin@gmail.com> parents: 1237 diff changeset	92 till it can be used with other applications simultaneously.
281 c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	93
557 0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	94 (2) If you build SDL with threads using the GNU pth library, timers are
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	95 supported via the pth library.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	96
281 c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	97 ==============================================================================
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	98 V. Environment variables:
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	99
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	100 SDL_VIDEODRIVER:
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	101 Set to 'xbios' to force xbios video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	102 Set to 'gem' to force gem video driver
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	103
1007 335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	104 SDL_VIDEO_GL_DRIVER:
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	105 Set to filename to load as OpenGL library, if you use SDL_GL_LoadLibrary()
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	106
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	107 SDL_AUDIODRIVER:
644 594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	108 Set to 'mint_gsxb' to force Atari GSXB audio driver
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	109 Set to 'mint_mcsn' to force Atari MCSN audio driver
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	110 Set to 'mint_stfa' to force Atari STFA audio driver
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	111 Set to 'mint_xbios' to force Atari Xbios audio driver
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	112 Set to 'mint_dma8' to force Atari 8 bits DMA audio driver
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	113 Set to 'audio' to force Sun /dev/audio audio driver
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	114 Set to 'disk' to force disk-writing audio driver
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	115
281 c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	116 SDL_ATARI_EVENTSDRIVER
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	117 Set to 'ikbd' to force IKBD 6301 keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	118 Set to 'gemdos' to force gemdos keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	119 Set to 'bios' to force bios keyboard driver
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	120
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	121 SDL_JOYSTICK_ATARI:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	122 Use any of these strings in the environment variable to enable or
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	123 disable a joystick:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	124
305 9c6613983e85 Atari port cleanups from Patrice Sam Lantinga <slouken@libsdl.org> parents: 302 diff changeset	125 'ikbd-joy1-[on\|off]' for IKBD joystick on port 1 (hardware access)
9c6613983e85 Atari port cleanups from Patrice Sam Lantinga <slouken@libsdl.org> parents: 302 diff changeset	126 'xbios-joy1-[on\|off]' for IKBD joystick on port 1 (xbios access)
2029 8640d90b0406 Add teamtap support Patrice Mandin <patmandin@gmail.com> parents: 2028 diff changeset	127 'porta-pad-[on\|off]' for joypad and/or teamtap on port A
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	128 'porta-joy0-[on\|off]' for joystick 0 on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	129 'porta-joy1-[on\|off]' for joystick 1 on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	130 'porta-lp-[on\|off]' for lightpen on port A
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	131 'porta-anpad-[on\|off]' for analog paddle on port A
2029 8640d90b0406 Add teamtap support Patrice Mandin <patmandin@gmail.com> parents: 2028 diff changeset	132 'portb-pad-[on\|off]' for joypad and/or teamtap on port B
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	133 'portb-joy0-[on\|off]' for joystick 0 on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	134 'portb-joy1-[on\|off]' for joystick 1 on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	135 'portb-anpad-[on\|off]' for analog paddle on port B
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	136
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	137 Default configuration is:
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	138 'ikbd-joy1-on' (if IKBD events driver enabled)
305 9c6613983e85 Atari port cleanups from Patrice Sam Lantinga <slouken@libsdl.org> parents: 302 diff changeset	139 'xbios-joy1-on' (if gemdos/bios/gem events driver enabled)
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	140 'porta-pad-on portb-pad-on' (if available on the machine)
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	141
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	142 port[a\|b]-[pad\|joy?\|lp\|anpad]-* strings are mutually exclusives.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	143 On such a port, you can only use a joypad OR 1 or 2 joysticks OR
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	144 a lightpen OR an analog paddle. You must disable joypad before
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	145 setting another controller.
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	146
8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	147 The second joystick port on IKBD is used by the mouse, so not usable.
1087 8c44005e0979 Document IKBD hardware problem with mouse buttons and joystick fire buttons Patrice Mandin <patmandin@gmail.com> parents: 1083 diff changeset	148 Another problem with the IKBD: mouse buttons and joystick fire buttons
8c44005e0979 Document IKBD hardware problem with mouse buttons and joystick fire buttons Patrice Mandin <patmandin@gmail.com> parents: 1083 diff changeset	149 are wired together at the hardware level, it means:
1106 524fd51f5d2c Disable XBIOS in interrupt also under Magic Patrice Mandin <patmandin@gmail.com> parents: 1095 diff changeset	150 port 0 port 0 port 1
524fd51f5d2c Disable XBIOS in interrupt also under Magic Patrice Mandin <patmandin@gmail.com> parents: 1095 diff changeset	151 mouse left button = joystick fire 0 = joystick fire 1
524fd51f5d2c Disable XBIOS in interrupt also under Magic Patrice Mandin <patmandin@gmail.com> parents: 1095 diff changeset	152 mouse right button = joystick fire 1 = joystick fire 0
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	153
963 92c247cec42d No need to try to emulate analog axis when SDL support digital hats Patrice Mandin <patmandin@gmail.com> parents: 724 diff changeset	154 Descriptions of joysticks/joypads:
92c247cec42d No need to try to emulate analog axis when SDL support digital hats Patrice Mandin <patmandin@gmail.com> parents: 724 diff changeset	155 - Joypads: 1 hat, 17 buttons (Atari Jaguar console-like).
92c247cec42d No need to try to emulate analog axis when SDL support digital hats Patrice Mandin <patmandin@gmail.com> parents: 724 diff changeset	156 - Joysticks: 1 hat, 1 button.
92c247cec42d No need to try to emulate analog axis when SDL support digital hats Patrice Mandin <patmandin@gmail.com> parents: 724 diff changeset	157 - Lightpen, analog paddles: 2 axis, 2 buttons. The 2 buttons are those
92c247cec42d No need to try to emulate analog axis when SDL support digital hats Patrice Mandin <patmandin@gmail.com> parents: 724 diff changeset	158 affected to 1 button joysticks on the same port.
302 8a86bdf34f0f Added Atari joystick support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 281 diff changeset	159
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	160 ==============================================================================
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	161 VI. More informations about drivers:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	162
1007 335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	163 OpenGL:
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	164 The default is to use the Mesa offscreen driver (osmesa.ldg). If you want
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	165 to use an older OpenGL implementation, like mesa_gl.ldg or tiny_gl.ldg,
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	166 your program must use SDL_GL_LoadLibrary() to do so, and retrieve the
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	167 needed function pointers with SDL_LoadFunction(). In all cases, the OpenGL
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	168 context is taken care of by SDL itself, you just have to use gl* functions.
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	169
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	170 However, there is one OpenGL call that has a different prototype in the old
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	171 implementations: glOrtho(). In the old implementations, it has 6 float as
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	172 parameters, in the standard one, it has 6 double parameters. If you want
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	173 to compile testdyngl, or any other SDL program that loads its OpenGL
335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	174 library, you must change the glOrtho() prototype used in this program. In
1064 fba6b67b4d60 Add Centscreen extended modes support Patrice Mandin <patmandin@gmail.com> parents: 1061 diff changeset	175 osmesa.ldg, you can retrieve a glOrtho() with double parameters, by
fba6b67b4d60 Add Centscreen extended modes support Patrice Mandin <patmandin@gmail.com> parents: 1061 diff changeset	176 searching for the function "glOrtho6d".
1007 335d9376a2cd Document new OpenGL feature Patrice Mandin <patmandin@gmail.com> parents: 984 diff changeset	177
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	178 Xbios video:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	179 Video chip is detected using the _VDO cookie.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	180 Screen enhancers are not supported, but could be if you know how to
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	181 use them.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	182
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	183 ST, STE, Mega ST, Mega STE:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	184 320x200x4 bits, shades of grey, available only for the purpose
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	185 of testing SDL.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	186 TT:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	187 320x480x8 and 320x240x8 (software double-lined mode).
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	188 Falcon:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	189 All modes supported by the current monitor (RVB or VGA).
1064 fba6b67b4d60 Add Centscreen extended modes support Patrice Mandin <patmandin@gmail.com> parents: 1061 diff changeset	190 BlowUp and Centscreen extended modes, ScreenBlaster 3 current mode.
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	191 Clones and any machine with monochrome monitor:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	192 Not supported.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	193
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	194 Gem video:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	195 Automatically used if xbios not available.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	196
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	197 All machines:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	198 Only the current resolution, if 8 bits or higher depth.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	199
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	200 IKBD keyboard, mouse and joystick driver:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	201 Available if _MCH cookie is ST, Mega ST, STE, Mega STE, TT or Falcon.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	202
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	203 Hades has an IKBD, but xbios is not available for video, so IKBD
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	204 driver is disabled.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	205
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	206 Gemdos and bios keyboard driver:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	207 Available on all machines.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	208
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	209 Mouse and joystick xbios driver:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	210 Available on all machines (I think).
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	211
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	212 Joypad driver:
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	213 Available if _MCH cookie is STE or Falcon.
189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	214
557 0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	215 PTH timer driver:
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	216 Available with multitasking OS.
0ce5a68278fd Updated Atari port for new system headers (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 398 diff changeset	217
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	218 VBL timer driver:
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	219 Available on all machines (I think).
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	220
644 594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	221 Audio drivers:
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	222 Cookies _SND, MCSN, STFA and GSXB used to detect supported audio
1112 6ded3dd929f5 Document recent audio updates Patrice Mandin <patmandin@gmail.com> parents: 1106 diff changeset	223 capabilities.
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	224
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	225 STE, Mega STE, TT:
d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	226 8 bits DMA (hardware access)
644 594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	227 STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	228 Falcon:
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	229 8 bits DMA (hardware access)
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	230 Xbios functions
644 594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	231 STFA, MCSN or GSXB driver if installed
398 d219b0e02f5f Added Atari audio support (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: 319 diff changeset	232 Other machines:
644 594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	233 STFA, MCSN or GSXB driver if installed
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	234
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	235 STFA driver:
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	236 http://removers.free.fr/softs/stfa.html
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	237 GSXB driver:
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	238 http://assemsoft.atari.org/gsxb/
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	239 MacSound driver:
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	240 http://jf.omnis.ch/software/tos/
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	241 MagicSound driver (MCSN,GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	242 http://perso.wanadoo.fr/didierm/
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	243 X-Sound driver (GSXB compatible):
594422ab8f9f Atari MiNT: added more audio drivers Patrice Mandin <patmandin@gmail.com> parents: 557 diff changeset	244 http://www.uni-ulm.de/~s_thuth/atari/xsound_e.html
319 189a6a3416c7 * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 314 diff changeset	245
281 c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	246 --
c5010ab8ba35 Added initial support for Atari (thanks Patrice!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	247 Patrice Mandin <pmandin@caramail.com>
1420 2405517b5eab Added preliminary support for MiNT /dev/mouse driver (disabled atm) Patrice Mandin <patmandin@gmail.com> parents: 1237 diff changeset	248 http://pmandin.atari.org/

Mercurial > sdl-ios-xcode

annotate README.MiNT @ 2263:900c35d8e8fd