Mercurial > sdl-ios-xcode

comparison docs/html/sdlcd.html @ 0:74212992fb08

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial revision
author Sam Lantinga <slouken@lokigames.com>
date Thu, 26 Apr 2001 16:45:43 +0000
parents
children 55f1f1b3e27d
comparison
equal deleted inserted replaced
-1:000000000000 0:74212992fb08
1 <HTML
2 ><HEAD
3 ><TITLE
4 >SDL_CD</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.61
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_CDClose"
17 HREF="sdlcdclose.html"><LINK
18 REL="NEXT"
19 TITLE="SDL_CDtrack"
20 HREF="sdlcdtrack.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="sdlcdclose.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="sdlcdtrack.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="SDLCD"
71 >SDL_CD</A
72 ></H1
73 ><DIV
74 CLASS="REFNAMEDIV"
75 ><A
76 NAME="AEN6941"
77 ></A
78 ><H2
79 >Name</H2
80 >SDL_CD&nbsp;--&nbsp;CDROM Drive Information</DIV
81 ><DIV
82 CLASS="REFSECT1"
83 ><A
84 NAME="AEN6944"
85 ></A
86 ><H2
87 >Structure Definition</H2
88 ><PRE
89 CLASS="PROGRAMLISTING"
90 >typedef struct{
91 int id;
92 CDstatus status;
93 int numtracks;
94 int cur_track;
95 int cur_frame;
96 SDL_CDtrack track[SDL_MAX_TRACKS+1];
97 } SDL_CD;</PRE
98 ></DIV
99 ><DIV
100 CLASS="REFSECT1"
101 ><A
102 NAME="AEN6947"
103 ></A
104 ><H2
105 >Structure Data</H2
106 ><DIV
107 CLASS="INFORMALTABLE"
108 ><A
109 NAME="AEN6949"
110 ></A
111 ><P
112 ></P
113 ><TABLE
114 BORDER="0"
115 CLASS="CALSTABLE"
116 ><TBODY
117 ><TR
118 ><TD
119 ALIGN="LEFT"
120 VALIGN="TOP"
121 ><TT
122 CLASS="STRUCTFIELD"
123 ><I
124 >id</I
125 ></TT
126 ></TD
127 ><TD
128 ALIGN="LEFT"
129 VALIGN="TOP"
130 >Private drive identifier</TD
131 ></TR
132 ><TR
133 ><TD
134 ALIGN="LEFT"
135 VALIGN="TOP"
136 ><TT
137 CLASS="STRUCTFIELD"
138 ><I
139 >status</I
140 ></TT
141 ></TD
142 ><TD
143 ALIGN="LEFT"
144 VALIGN="TOP"
145 >Drive <A
146 HREF="sdlcdstatus.html"
147 >status</A
148 ></TD
149 ></TR
150 ><TR
151 ><TD
152 ALIGN="LEFT"
153 VALIGN="TOP"
154 ><TT
155 CLASS="STRUCTFIELD"
156 ><I
157 >numtracks</I
158 ></TT
159 ></TD
160 ><TD
161 ALIGN="LEFT"
162 VALIGN="TOP"
163 >Number of tracks on the CD</TD
164 ></TR
165 ><TR
166 ><TD
167 ALIGN="LEFT"
168 VALIGN="TOP"
169 ><TT
170 CLASS="STRUCTFIELD"
171 ><I
172 >cur_track</I
173 ></TT
174 ></TD
175 ><TD
176 ALIGN="LEFT"
177 VALIGN="TOP"
178 >Current track</TD
179 ></TR
180 ><TR
181 ><TD
182 ALIGN="LEFT"
183 VALIGN="TOP"
184 ><TT
185 CLASS="STRUCTFIELD"
186 ><I
187 >cur_frame</I
188 ></TT
189 ></TD
190 ><TD
191 ALIGN="LEFT"
192 VALIGN="TOP"
193 >Current frame offset within the track</TD
194 ></TR
195 ><TR
196 ><TD
197 ALIGN="LEFT"
198 VALIGN="TOP"
199 ><TT
200 CLASS="STRUCTFIELD"
201 ><I
202 >track</I
203 ></TT
204 >[SDL_MAX_TRACKS+1]</TD
205 ><TD
206 ALIGN="LEFT"
207 VALIGN="TOP"
208 >Array of track descriptions. (see <A
209 HREF="sdlcdtrack.html"
210 ><SPAN
211 CLASS="STRUCTNAME"
212 >SDL_CDtrack</SPAN
213 ></A
214 >)</TD
215 ></TR
216 ></TBODY
217 ></TABLE
218 ><P
219 ></P
220 ></DIV
221 ></DIV
222 ><DIV
223 CLASS="REFSECT1"
224 ><A
225 NAME="AEN6979"
226 ></A
227 ><H2
228 >Description</H2
229 ><P
230 >An <SPAN
231 CLASS="STRUCTNAME"
232 >SDL_CD</SPAN
233 > structure is returned by <A
234 HREF="sdlcdopen.html"
235 ><TT
236 CLASS="FUNCTION"
237 >SDL_CDOpen</TT
238 ></A
239 >. It represents an opened CDROM device and stores information on the layout of the tracks on the disc.</P
240 ><P
241 >A frame is the base data unit of a CD. <TT
242 CLASS="LITERAL"
243 >CD_FPS</TT
244 > frames is equal to 1 second of music. SDL provides two macros for converting between time and frames: <TT
245 CLASS="LITERAL"
246 >FRAMES_TO_MSF(f, M,S,F)</TT
247 > and <TT
248 CLASS="LITERAL"
249 >MSF_TO_FRAMES</TT
250 >.</P
251 ></DIV
252 ><DIV
253 CLASS="REFSECT1"
254 ><A
255 NAME="AEN6989"
256 ></A
257 ><H2
258 >Examples</H2
259 ><PRE
260 CLASS="PROGRAMLISTING"
261 >int min, sec, frame;
262 int frame_offset;
263
264 FRAMES_TO_MSF(cdrom-&#62;cur_frame, &#38;min, &#38;sec, &#38;frame);
265 printf("Current Position: %d minutes, %d seconds, %d frames\n", min, sec, frame);
266
267 frame_offset=MSF_TO_FRAMES(min, sec, frame);</PRE
268 ></DIV
269 ><DIV
270 CLASS="REFSECT1"
271 ><A
272 NAME="AEN6992"
273 ></A
274 ><H2
275 >See Also</H2
276 ><P
277 ><A
278 HREF="sdlcdopen.html"
279 ><TT
280 CLASS="FUNCTION"
281 >SDL_CDOpen</TT
282 ></A
283 >,
284 <A
285 HREF="sdlcdtrack.html"
286 ><SPAN
287 CLASS="STRUCTNAME"
288 >SDL_CDtrack</SPAN
289 ></A
290 ></P
291 ></DIV
292 ><DIV
293 CLASS="NAVFOOTER"
294 ><HR
295 ALIGN="LEFT"
296 WIDTH="100%"><TABLE
297 WIDTH="100%"
298 BORDER="0"
299 CELLPADDING="0"
300 CELLSPACING="0"
301 ><TR
302 ><TD
303 WIDTH="33%"
304 ALIGN="left"
305 VALIGN="top"
306 ><A
307 HREF="sdlcdclose.html"
308 >Prev</A
309 ></TD
310 ><TD
311 WIDTH="34%"
312 ALIGN="center"
313 VALIGN="top"
314 ><A
315 HREF="index.html"
316 >Home</A
317 ></TD
318 ><TD
319 WIDTH="33%"
320 ALIGN="right"
321 VALIGN="top"
322 ><A
323 HREF="sdlcdtrack.html"
324 >Next</A
325 ></TD
326 ></TR
327 ><TR
328 ><TD
329 WIDTH="33%"
330 ALIGN="left"
331 VALIGN="top"
332 >SDL_CDClose</TD
333 ><TD
334 WIDTH="34%"
335 ALIGN="center"
336 VALIGN="top"
337 ><A
338 HREF="cdrom.html"
339 >Up</A
340 ></TD
341 ><TD
342 WIDTH="33%"
343 ALIGN="right"
344 VALIGN="top"
345 >SDL_CDtrack</TD
346 ></TR
347 ></TABLE
348 ></DIV
349 ></BODY
350 ></HTML
351 >