cdrom.html
1
2
3
4
5
6
<HTML
><HEAD
><TITLE
>CD-ROM</TITLE
><META
NAME="GENERATOR"
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
"><LINK
REL="HOME"
TITLE="SDL Library Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="SDL Reference"
HREF="reference.html"><LINK
REL="PREVIOUS"
TITLE="SDL_CloseAudio"
HREF="sdlcloseaudio.html"><LINK
REL="NEXT"
TITLE="SDL_CDNumDrives"
HREF="sdlcdnumdrives.html"><META
NAME="KEYWORD"
CONTENT="cdrom"><META
NAME="KEYWORD"
CONTENT="function"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFF8DC"
TEXT="#000000"
LINK="#0000ee"
VLINK="#551a8b"
ALINK="#ff0000"
><DIV
CLASS="NAVHEADER"
><TABLE
35
SUMMARY="Header navigation table"
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>SDL Library Documentation</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="sdlcloseaudio.html"
53
ACCESSKEY="P"
54
55
56
57
58
59
60
61
62
63
64
65
66
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sdlcdnumdrives.html"
67
ACCESSKEY="N"
68
69
70
71
72
73
74
75
76
77
78
79
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="CDROM"
80
81
></A
>Chapter 11. CD-ROM</H1
82
83
84
85
86
87
88
89
90
91
92
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="sdlcdnumdrives.html"
>SDL_CDNumDrives</A
93
> -- Returns the number of CD-ROM drives on the system.</DT
94
95
96
97
><DT
><A
HREF="sdlcdname.html"
>SDL_CDName</A
98
> -- Returns a human-readable, system-dependent identifier for the CD-ROM.</DT
99
100
101
102
><DT
><A
HREF="sdlcdopen.html"
>SDL_CDOpen</A
103
> -- Opens a CD-ROM drive for access.</DT
104
105
106
107
><DT
><A
HREF="sdlcdstatus.html"
>SDL_CDStatus</A
108
> -- Returns the current status of the given drive.</DT
109
110
111
112
><DT
><A
HREF="sdlcdplay.html"
>SDL_CDPlay</A
113
> -- Play a CD</DT
114
115
116
117
><DT
><A
HREF="sdlcdplaytracks.html"
>SDL_CDPlayTracks</A
118
> -- Play the given CD track(s)</DT
119
120
121
122
><DT
><A
HREF="sdlcdpause.html"
>SDL_CDPause</A
123
> -- Pauses a CDROM</DT
124
125
126
127
><DT
><A
HREF="sdlcdresume.html"
>SDL_CDResume</A
128
> -- Resumes a CDROM</DT
129
130
131
132
><DT
><A
HREF="sdlcdstop.html"
>SDL_CDStop</A
133
> -- Stops a CDROM</DT
134
135
136
137
><DT
><A
HREF="sdlcdeject.html"
>SDL_CDEject</A
138
> -- Ejects a CDROM</DT
139
140
141
142
><DT
><A
HREF="sdlcdclose.html"
>SDL_CDClose</A
143
> -- Closes a SDL_CD handle</DT
144
145
146
147
><DT
><A
HREF="sdlcd.html"
>SDL_CD</A
148
> -- CDROM Drive Information</DT
149
150
151
152
><DT
><A
HREF="sdlcdtrack.html"
>SDL_CDtrack</A
153
> -- CD Track Information Structure</DT
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
></DL
></DIV
><P
>SDL supports audio control of up to 32 local CD-ROM drives at once.</P
><P
>You use this API to perform all the basic functions of a CD player,
including listing the tracks, playing, stopping, and ejecting the CD-ROM.
(Currently, multi-changer CD drives are not supported.)</P
><P
>Before you call any of the SDL CD-ROM functions, you must first call
"<TT
CLASS="FUNCTION"
>SDL_Init(SDL_INIT_CDROM)</TT
>", which scans the system for
CD-ROM drives, and sets the program up for audio control. Check the
return code, which should be <SPAN
CLASS="RETURNVALUE"
>0</SPAN
>, to see if there
were any errors in starting up.</P
><P
>After you have initialized the library, you can find out how many drives
are available using the <TT
CLASS="FUNCTION"
>SDL_CDNumDrives()</TT
> function.
The first drive listed is the system default CD-ROM drive. After you have
chosen a drive, and have opened it with <TT
CLASS="FUNCTION"
>SDL_CDOpen()</TT
>,
you can check the status and start playing if there's a CD in the drive.</P
><P
>A CD-ROM is organized into one or more tracks, each consisting of a certain
number of "frames". Each frame is ~2K in size, and at normal playing speed,
a CD plays 75 frames per second. SDL works with the number of frames on a
CD, but this can easily be converted to the more familiar minutes/seconds
format by using the <TT
CLASS="FUNCTION"
>FRAMES_TO_MSF()</TT
> macro.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
201
SUMMARY="Footer navigation table"
202
203
204
205
206
207
208
209
210
211
212
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sdlcloseaudio.html"
213
ACCESSKEY="P"
214
215
216
217
218
219
220
221
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
222
ACCESSKEY="H"
223
224
225
226
227
228
229
230
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sdlcdnumdrives.html"
231
ACCESSKEY="N"
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>SDL_CloseAudio</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="reference.html"
247
ACCESSKEY="U"
248
249
250
251
252
253
254
255
256
257
258
259
260
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>SDL_CDNumDrives</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>