Mercurial > sdl-ios-xcode
annotate docs/html/sdlcreatethread.html @ 2866:e532417a6977
Fixed SDL 1.2 compatibility problem.
The API specifies that SDL_OpenAudio() will fill out the 'desired' audio spec
with the correct samples and size set by the driver. This value is important
since it may be used by applications that size audio buffers, etc.
However, we want to allow advanced applications to call SDL_OpenAudioDevice()
which gets passed a const 'desired' parameter, and have the correct data filled
into the 'obtained' parameter, possibly allowing or not allowing format changes.
So... 'obtained' becomes the audio format the user callback is expected to use,
and we add flags to allow the application to specify which format changes are
allowed.
Note: We really need to add a way to query the 'obtained' audio spec.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Sat, 13 Dec 2008 06:36:47 +0000 |
parents | 355632dca928 |
children |
rev | line source |
---|---|
0 | 1 <HTML |
2 ><HEAD | |
3 ><TITLE | |
4 >SDL_CreateThread</TITLE | |
5 ><META | |
6 NAME="GENERATOR" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
0 | 8 "><LINK |
9 REL="HOME" | |
10 TITLE="SDL Library Documentation" | |
11 HREF="index.html"><LINK | |
12 REL="UP" | |
13 TITLE="Multi-threaded Programming" | |
14 HREF="thread.html"><LINK | |
15 REL="PREVIOUS" | |
16 TITLE="Multi-threaded Programming" | |
17 HREF="thread.html"><LINK | |
18 REL="NEXT" | |
19 TITLE="SDL_ThreadID" | |
20 HREF="sdlthreadid.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 | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
31 SUMMARY="Header navigation table" |
0 | 32 WIDTH="100%" |
33 BORDER="0" | |
34 CELLPADDING="0" | |
35 CELLSPACING="0" | |
36 ><TR | |
37 ><TH | |
38 COLSPAN="3" | |
39 ALIGN="center" | |
40 >SDL Library Documentation</TH | |
41 ></TR | |
42 ><TR | |
43 ><TD | |
44 WIDTH="10%" | |
45 ALIGN="left" | |
46 VALIGN="bottom" | |
47 ><A | |
48 HREF="thread.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
49 ACCESSKEY="P" |
0 | 50 >Prev</A |
51 ></TD | |
52 ><TD | |
53 WIDTH="80%" | |
54 ALIGN="center" | |
55 VALIGN="bottom" | |
56 ></TD | |
57 ><TD | |
58 WIDTH="10%" | |
59 ALIGN="right" | |
60 VALIGN="bottom" | |
61 ><A | |
62 HREF="sdlthreadid.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
63 ACCESSKEY="N" |
0 | 64 >Next</A |
65 ></TD | |
66 ></TR | |
67 ></TABLE | |
68 ><HR | |
69 ALIGN="LEFT" | |
70 WIDTH="100%"></DIV | |
71 ><H1 | |
72 ><A | |
73 NAME="SDLCREATETHREAD" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
74 ></A |
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
75 >SDL_CreateThread</H1 |
0 | 76 ><DIV |
77 CLASS="REFNAMEDIV" | |
78 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
79 NAME="AEN7701" |
0 | 80 ></A |
81 ><H2 | |
82 >Name</H2 | |
83 >SDL_CreateThread -- Creates a new thread of execution that shares its parent's properties.</DIV | |
84 ><DIV | |
85 CLASS="REFSYNOPSISDIV" | |
86 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
87 NAME="AEN7704" |
0 | 88 ></A |
89 ><H2 | |
90 >Synopsis</H2 | |
91 ><DIV | |
92 CLASS="FUNCSYNOPSIS" | |
93 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
94 NAME="AEN7705" |
0 | 95 ></A |
96 ><P | |
97 ></P | |
98 ><PRE | |
99 CLASS="FUNCSYNOPSISINFO" | |
100 >#include "SDL.h" | |
101 #include "SDL_thread.h"</PRE | |
102 ><P | |
103 ><CODE | |
104 ><CODE | |
105 CLASS="FUNCDEF" | |
106 >SDL_Thread *<B | |
107 CLASS="FSFUNC" | |
108 >SDL_CreateThread</B | |
109 ></CODE | |
110 >(int (*fn)(void *), void *data);</CODE | |
111 ></P | |
112 ><P | |
113 ></P | |
114 ></DIV | |
115 ></DIV | |
116 ><DIV | |
117 CLASS="REFSECT1" | |
118 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
119 NAME="AEN7711" |
0 | 120 ></A |
121 ><H2 | |
122 >Description</H2 | |
123 ><P | |
124 ><TT | |
125 CLASS="FUNCTION" | |
126 >SDL_CreateThread</TT | |
127 > creates a new thread of execution | |
128 that shares all of its parent's global memory, signal handlers, | |
129 file descriptors, etc, and runs the function <TT | |
130 CLASS="PARAMETER" | |
131 ><I | |
132 >fn</I | |
133 ></TT | |
134 > | |
135 passed the void pointer <TT | |
136 CLASS="PARAMETER" | |
137 ><I | |
138 >data</I | |
139 ></TT | |
140 > | |
141 The thread quits when this function returns.</P | |
142 ></DIV | |
143 ><DIV | |
144 CLASS="REFSECT1" | |
145 ><A | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
146 NAME="AEN7717" |
0 | 147 ></A |
148 ><H2 | |
149 >See Also</H2 | |
150 ><P | |
151 ><A | |
152 HREF="sdlkillthread.html" | |
153 ><TT | |
154 CLASS="FUNCTION" | |
155 >SDL_KillThread</TT | |
156 ></A | |
157 ></P | |
158 ></DIV | |
159 ><DIV | |
160 CLASS="NAVFOOTER" | |
161 ><HR | |
162 ALIGN="LEFT" | |
163 WIDTH="100%"><TABLE | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
164 SUMMARY="Footer navigation table" |
0 | 165 WIDTH="100%" |
166 BORDER="0" | |
167 CELLPADDING="0" | |
168 CELLSPACING="0" | |
169 ><TR | |
170 ><TD | |
171 WIDTH="33%" | |
172 ALIGN="left" | |
173 VALIGN="top" | |
174 ><A | |
175 HREF="thread.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
176 ACCESSKEY="P" |
0 | 177 >Prev</A |
178 ></TD | |
179 ><TD | |
180 WIDTH="34%" | |
181 ALIGN="center" | |
182 VALIGN="top" | |
183 ><A | |
184 HREF="index.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
185 ACCESSKEY="H" |
0 | 186 >Home</A |
187 ></TD | |
188 ><TD | |
189 WIDTH="33%" | |
190 ALIGN="right" | |
191 VALIGN="top" | |
192 ><A | |
193 HREF="sdlthreadid.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
194 ACCESSKEY="N" |
0 | 195 >Next</A |
196 ></TD | |
197 ></TR | |
198 ><TR | |
199 ><TD | |
200 WIDTH="33%" | |
201 ALIGN="left" | |
202 VALIGN="top" | |
203 >Multi-threaded Programming</TD | |
204 ><TD | |
205 WIDTH="34%" | |
206 ALIGN="center" | |
207 VALIGN="top" | |
208 ><A | |
209 HREF="thread.html" | |
803
355632dca928
Updated SDL HTML documentation
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
210 ACCESSKEY="U" |
0 | 211 >Up</A |
212 ></TD | |
213 ><TD | |
214 WIDTH="33%" | |
215 ALIGN="right" | |
216 VALIGN="top" | |
217 >SDL_ThreadID</TD | |
218 ></TR | |
219 ></TABLE | |
220 ></DIV | |
221 ></BODY | |
222 ></HTML | |
223 > |