Mercurial > sdl-ios-xcode
annotate docs/html/sdlcdstatus.html @ 320:66f815c147ed
Date: Thu, 28 Mar 2002 09:20:03 +0200
From: "Mike Gorchak" <mike@malva.ua>
Subject: New QNX patch.
Hi !
1. Removed warning (possible bug) with invalid type, passing to the function
in ph_WarpedMotion.
2. Rewritten handler of Ph_WM_RESIZE message, now works, but buggy (old
handler doesn't work at all).
3. Added stub handler for Ph_WM_MAX (maximize) message.
4. Added more #ifdef HAVE_OPENGL to disable OpenGL stuff when it not needed.
5. Added support for SDL_NOFRAME and SDL_RESIZABLE flags (in OpenGL windows
too).
6. Added cosmetic changes, if no SDL_RESIZABLE flag defined, disable resize
handlers in window border and maximize button at caption.
7. Fixed my bug with invalid arguments count passed to PtCreateWidget call.
8. Fixed some palette problems.
9. Updated README.QNX file.
And I changed testgl.c test application:
10. Added in testgl.c application support for SDL_NOFRAME flag and
option -noframe.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Thu, 28 Mar 2002 16:20:10 +0000 (2002-03-28) |
parents | e5bc29de3f0a |
children | 355632dca928 |
rev | line source |
---|---|
0 | 1 <HTML |
2 ><HEAD | |
3 ><TITLE | |
4 >SDL_CDStatus</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_CDOpen" | |
17 HREF="sdlcdopen.html"><LINK | |
18 REL="NEXT" | |
19 TITLE="SDL_CDPlay" | |
20 HREF="sdlcdplay.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="sdlcdopen.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="sdlcdplay.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="SDLCDSTATUS" | |
71 >SDL_CDStatus</A | |
72 ></H1 | |
73 ><DIV | |
74 CLASS="REFNAMEDIV" | |
75 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
76 NAME="AEN6920" |
0 | 77 ></A |
78 ><H2 | |
79 >Name</H2 | |
80 >SDL_CDStatus -- Returns the current status of the given drive.</DIV | |
81 ><DIV | |
82 CLASS="REFSYNOPSISDIV" | |
83 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
84 NAME="AEN6923" |
0 | 85 ></A |
86 ><H2 | |
87 >Synopsis</H2 | |
88 ><DIV | |
89 CLASS="FUNCSYNOPSIS" | |
90 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
91 NAME="AEN6924" |
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 >CDstatus <B | |
103 CLASS="FSFUNC" | |
104 >SDL_CDStatus</B | |
105 ></CODE | |
106 >(SDL_CD *cdrom);</CODE | |
107 ></P | |
108 ><PRE | |
109 CLASS="FUNCSYNOPSISINFO" | |
110 >/* Given a status, returns true if there's a disk in the drive */ | |
111 #define CD_INDRIVE(status) ((int)status > 0)</PRE | |
112 ><P | |
113 ></P | |
114 ></DIV | |
115 ></DIV | |
116 ><DIV | |
117 CLASS="REFSECT1" | |
118 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
119 NAME="AEN6931" |
0 | 120 ></A |
121 ><H2 | |
122 >Description</H2 | |
123 ><P | |
124 >This function returns the current status of the given drive. Status is described like so: | |
125 <PRE | |
126 CLASS="PROGRAMLISTING" | |
127 >typedef enum { | |
128 CD_TRAYEMPTY, | |
129 CD_STOPPED, | |
130 CD_PLAYING, | |
131 CD_PAUSED, | |
132 CD_ERROR = -1 | |
133 } CDstatus;</PRE | |
134 ></P | |
135 ><P | |
136 >If the drive has a CD in it, the table of contents of the CD and current | |
137 play position of the CD will be stored in the SDL_CD structure.</P | |
138 ><P | |
139 >The macro <TT | |
140 CLASS="LITERAL" | |
141 >CD_INDRIVE</TT | |
142 > is provided for convenience, | |
143 and given a status returns true if there's a disk in the drive.</P | |
144 ><DIV | |
145 CLASS="NOTE" | |
146 ><BLOCKQUOTE | |
147 CLASS="NOTE" | |
148 ><P | |
149 ><B | |
150 >Note: </B | |
151 ><TT | |
152 CLASS="FUNCTION" | |
153 >SDL_CDStatus</TT | |
154 > also updates the <A | |
155 HREF="sdlcd.html" | |
156 ><SPAN | |
157 CLASS="STRUCTNAME" | |
158 >SDL_CD</SPAN | |
159 ></A | |
160 > structure passed to it.</P | |
161 ></BLOCKQUOTE | |
162 ></DIV | |
163 ></DIV | |
164 ><DIV | |
165 CLASS="REFSECT1" | |
166 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
167 NAME="AEN6943" |
0 | 168 ></A |
169 ><H2 | |
170 >Example</H2 | |
171 ><PRE | |
172 CLASS="PROGRAMLISTING" | |
173 >int playTrack(int track) | |
174 { | |
175 int playing = 0; | |
176 | |
177 if ( CD_INDRIVE(SDL_CDStatus(cdrom)) ) { | |
178 /* clamp to the actual number of tracks on the CD */ | |
179 if (track >= cdrom->numtracks) { | |
180 track = cdrom->numtracks-1; | |
181 } | |
182 | |
183 if ( SDL_CDPlayTracks(cdrom, track, 0, 1, 0) == 0 ) { | |
184 playing = 1; | |
185 } | |
186 } | |
187 return playing; | |
188 }</PRE | |
189 ></DIV | |
190 ><DIV | |
191 CLASS="REFSECT1" | |
192 ><A | |
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
193 NAME="AEN6946" |
0 | 194 ></A |
195 ><H2 | |
196 >See Also</H2 | |
197 ><P | |
198 ><A | |
199 HREF="sdlcd.html" | |
200 ><TT | |
201 CLASS="FUNCTION" | |
202 >SDL_CD</TT | |
203 ></A | |
204 ></P | |
205 ></DIV | |
206 ><DIV | |
207 CLASS="NAVFOOTER" | |
208 ><HR | |
209 ALIGN="LEFT" | |
210 WIDTH="100%"><TABLE | |
211 WIDTH="100%" | |
212 BORDER="0" | |
213 CELLPADDING="0" | |
214 CELLSPACING="0" | |
215 ><TR | |
216 ><TD | |
217 WIDTH="33%" | |
218 ALIGN="left" | |
219 VALIGN="top" | |
220 ><A | |
221 HREF="sdlcdopen.html" | |
222 >Prev</A | |
223 ></TD | |
224 ><TD | |
225 WIDTH="34%" | |
226 ALIGN="center" | |
227 VALIGN="top" | |
228 ><A | |
229 HREF="index.html" | |
230 >Home</A | |
231 ></TD | |
232 ><TD | |
233 WIDTH="33%" | |
234 ALIGN="right" | |
235 VALIGN="top" | |
236 ><A | |
237 HREF="sdlcdplay.html" | |
238 >Next</A | |
239 ></TD | |
240 ></TR | |
241 ><TR | |
242 ><TD | |
243 WIDTH="33%" | |
244 ALIGN="left" | |
245 VALIGN="top" | |
246 >SDL_CDOpen</TD | |
247 ><TD | |
248 WIDTH="34%" | |
249 ALIGN="center" | |
250 VALIGN="top" | |
251 ><A | |
252 HREF="cdrom.html" | |
253 >Up</A | |
254 ></TD | |
255 ><TD | |
256 WIDTH="33%" | |
257 ALIGN="right" | |
258 VALIGN="top" | |
259 >SDL_CDPlay</TD | |
260 ></TR | |
261 ></TABLE | |
262 ></DIV | |
263 ></BODY | |
264 ></HTML | |
265 > |