Mercurial > sdl-ios-xcode
annotate docs/html/sdlcdopen.html @ 172:37e3ca9254c7
Date: Sat, 8 Sep 2001 04:42:23 +0200
From: Max Horn <max@quendi.de>
Subject: SDL/OSX: Joystick; Better key handling
I just finished implementing improved keyhandling for OS X (in fact
the code should be easily ported to the "normal" MacOS part of SDL, I
just had no chance yet). Works like this:
First init the mapping table statically like before. Them, it queries
the OS for the "official" key table, then iterates over all 127
scancode and gets the associates ascii code. It ignores everythng
below 32 (has to, as it would lead to many problems if we did not...
e.g. both ESC and NUM LOCk produce an ascii code 27 on my keyboard),
and all stuff above 127 is mapped to SDLK_WORLD_* simply in the order
it is encountered.
In addition, caps lock is now working, too.
The code work flawless for me, but since I only have one keyboard, I
may have not encountered some serious problem... but I am pretty
confident that it is better than the old code in most cases.
The joystick driver works fine for me, too. I think it can be added
to CVS already. It would simply be helpful if more people would test
it. Hm, I wonder if Maelstrom or GLTron has Joystick support? That
would be a wonderful test application :)
I also took the liberty of modifying some text files like BUGS,
README.CVS, README.MacOSX (which now contains the OS X docs I long
promised)
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Tue, 11 Sep 2001 19:00:18 +0000 |
parents | 55f1f1b3e27d |
children | e5bc29de3f0a |
rev | line source |
---|---|
0 | 1 <HTML |
2 ><HEAD | |
3 ><TITLE | |
4 >SDL_CDOpen</TITLE | |
5 ><META | |
6 NAME="GENERATOR" | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64 |
0 | 8 "><LINK |
9 REL="HOME" | |
10 TITLE="SDL Library Documentation" | |
11 HREF="index.html"><LINK | |
12 REL="UP" | |
13 TITLE="CD-ROM" | |
14 HREF="cdrom.html"><LINK | |
15 REL="PREVIOUS" | |
16 TITLE="SDL_CDName" | |
17 HREF="sdlcdname.html"><LINK | |
18 REL="NEXT" | |
19 TITLE="SDL_CDStatus" | |
20 HREF="sdlcdstatus.html"></HEAD | |
21 ><BODY | |
22 CLASS="REFENTRY" | |
23 BGCOLOR="#FFF8DC" | |
24 TEXT="#000000" | |
25 LINK="#0000ee" | |
26 VLINK="#551a8b" | |
27 ALINK="#ff0000" | |
28 ><DIV | |
29 CLASS="NAVHEADER" | |
30 ><TABLE | |
31 WIDTH="100%" | |
32 BORDER="0" | |
33 CELLPADDING="0" | |
34 CELLSPACING="0" | |
35 ><TR | |
36 ><TH | |
37 COLSPAN="3" | |
38 ALIGN="center" | |
39 >SDL Library Documentation</TH | |
40 ></TR | |
41 ><TR | |
42 ><TD | |
43 WIDTH="10%" | |
44 ALIGN="left" | |
45 VALIGN="bottom" | |
46 ><A | |
47 HREF="sdlcdname.html" | |
48 >Prev</A | |
49 ></TD | |
50 ><TD | |
51 WIDTH="80%" | |
52 ALIGN="center" | |
53 VALIGN="bottom" | |
54 ></TD | |
55 ><TD | |
56 WIDTH="10%" | |
57 ALIGN="right" | |
58 VALIGN="bottom" | |
59 ><A | |
60 HREF="sdlcdstatus.html" | |
61 >Next</A | |
62 ></TD | |
63 ></TR | |
64 ></TABLE | |
65 ><HR | |
66 ALIGN="LEFT" | |
67 WIDTH="100%"></DIV | |
68 ><H1 | |
69 ><A | |
70 NAME="SDLCDOPEN" | |
71 >SDL_CDOpen</A | |
72 ></H1 | |
73 ><DIV | |
74 CLASS="REFNAMEDIV" | |
75 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
76 NAME="AEN6725" |
0 | 77 ></A |
78 ><H2 | |
79 >Name</H2 | |
80 >SDL_CDOpen -- Opens a CD-ROM drive for access.</DIV | |
81 ><DIV | |
82 CLASS="REFSYNOPSISDIV" | |
83 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
84 NAME="AEN6728" |
0 | 85 ></A |
86 ><H2 | |
87 >Synopsis</H2 | |
88 ><DIV | |
89 CLASS="FUNCSYNOPSIS" | |
90 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
91 NAME="AEN6729" |
0 | 92 ></A |
93 ><P | |
94 ></P | |
95 ><PRE | |
96 CLASS="FUNCSYNOPSISINFO" | |
97 >#include "SDL.h"</PRE | |
98 ><P | |
99 ><CODE | |
100 ><CODE | |
101 CLASS="FUNCDEF" | |
102 >SDL_CD *<B | |
103 CLASS="FSFUNC" | |
104 >SDL_CDOpen</B | |
105 ></CODE | |
106 >(int drive);</CODE | |
107 ></P | |
108 ><P | |
109 ></P | |
110 ></DIV | |
111 ></DIV | |
112 ><DIV | |
113 CLASS="REFSECT1" | |
114 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
115 NAME="AEN6735" |
0 | 116 ></A |
117 ><H2 | |
118 >Description</H2 | |
119 ><P | |
120 >Opens a CD-ROM drive for access. It returns a <A | |
121 HREF="sdlcd.html" | |
122 ><SPAN | |
123 CLASS="STRUCTNAME" | |
124 >SDL_CD</SPAN | |
125 ></A | |
126 > structure on success, or <TT | |
127 CLASS="LITERAL" | |
128 >NULL</TT | |
129 > if the drive was invalid or busy. This newly opened CD-ROM becomes the default CD used when other CD functions are passed a <TT | |
130 CLASS="LITERAL" | |
131 >NULL</TT | |
132 > CD-ROM handle. </P | |
133 ><P | |
134 >Drives are numbered starting with 0. | |
135 Drive 0 is the system default CD-ROM.</P | |
136 ></DIV | |
137 ><DIV | |
138 CLASS="REFSECT1" | |
139 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
140 NAME="AEN6743" |
0 | 141 ></A |
142 ><H2 | |
143 >Examples</H2 | |
144 ><PRE | |
145 CLASS="PROGRAMLISTING" | |
146 >SDL_CD *cdrom; | |
147 int cur_track; | |
148 int min, sec, frame; | |
149 SDL_Init(SDL_INIT_CDROM); | |
150 atexit(SDL_Quit); | |
151 | |
152 /* Check for CD drives */ | |
153 if(!SDL_CDNumDrives()){ | |
154 /* None found */ | |
155 fprintf(stderr, "No CDROM devices available\n"); | |
156 exit(-1); | |
157 } | |
158 | |
159 /* Open the default drive */ | |
160 cdrom=SDL_CDOpen(0); | |
161 | |
162 /* Did if open? Check if cdrom is NULL */ | |
163 if(!cdrom){ | |
164 fprintf(stderr, "Couldn't open drive: %s\n", SDL_GetError()); | |
165 exit(-1); | |
166 } | |
167 | |
168 /* Print Volume info */ | |
169 printf("Name: %s\n", SDL_CDName(0)); | |
170 printf("Tracks: %d\n", cdrom->numtracks); | |
171 for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){ | |
172 FRAMES_TO_MSF(cdrom->track[cur_track].length, &min, &sec, &frame); | |
173 printf("\tTrack %d: Length %d:%d\n", cur_track, min, sec); | |
174 } | |
175 | |
176 SDL_CDClose(cdrom);</PRE | |
177 ></DIV | |
178 ><DIV | |
179 CLASS="REFSECT1" | |
180 ><A | |
55
55f1f1b3e27d
Added new docs for SDL 1.2.1
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
181 NAME="AEN6746" |
0 | 182 ></A |
183 ><H2 | |
184 >See Also</H2 | |
185 ><P | |
186 ><A | |
187 HREF="sdlcd.html" | |
188 ><SPAN | |
189 CLASS="STRUCTNAME" | |
190 >SDL_CD</SPAN | |
191 ></A | |
192 >, | |
193 <A | |
194 HREF="sdlcdtrack.html" | |
195 ><SPAN | |
196 CLASS="STRUCTNAME" | |
197 >SDL_CDtrack</SPAN | |
198 ></A | |
199 >, | |
200 <A | |
201 HREF="sdlcdclose.html" | |
202 ><TT | |
203 CLASS="FUNCTION" | |
204 >SDL_CDClose</TT | |
205 ></A | |
206 ></P | |
207 ></DIV | |
208 ><DIV | |
209 CLASS="NAVFOOTER" | |
210 ><HR | |
211 ALIGN="LEFT" | |
212 WIDTH="100%"><TABLE | |
213 WIDTH="100%" | |
214 BORDER="0" | |
215 CELLPADDING="0" | |
216 CELLSPACING="0" | |
217 ><TR | |
218 ><TD | |
219 WIDTH="33%" | |
220 ALIGN="left" | |
221 VALIGN="top" | |
222 ><A | |
223 HREF="sdlcdname.html" | |
224 >Prev</A | |
225 ></TD | |
226 ><TD | |
227 WIDTH="34%" | |
228 ALIGN="center" | |
229 VALIGN="top" | |
230 ><A | |
231 HREF="index.html" | |
232 >Home</A | |
233 ></TD | |
234 ><TD | |
235 WIDTH="33%" | |
236 ALIGN="right" | |
237 VALIGN="top" | |
238 ><A | |
239 HREF="sdlcdstatus.html" | |
240 >Next</A | |
241 ></TD | |
242 ></TR | |
243 ><TR | |
244 ><TD | |
245 WIDTH="33%" | |
246 ALIGN="left" | |
247 VALIGN="top" | |
248 >SDL_CDName</TD | |
249 ><TD | |
250 WIDTH="34%" | |
251 ALIGN="center" | |
252 VALIGN="top" | |
253 ><A | |
254 HREF="cdrom.html" | |
255 >Up</A | |
256 ></TD | |
257 ><TD | |
258 WIDTH="33%" | |
259 ALIGN="right" | |
260 VALIGN="top" | |
261 >SDL_CDStatus</TD | |
262 ></TR | |
263 ></TABLE | |
264 ></DIV | |
265 ></BODY | |
266 ></HTML | |
267 > |