SDL-1.2.14
[sdl_omap.git] / docs / html / sdlinitsubsystem.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >SDL_InitSubSystem</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK
9 REL="HOME"
10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="General"
14 HREF="general.html"><LINK
15 REL="PREVIOUS"
16 TITLE="SDL_Init"
17 HREF="sdlinit.html"><LINK
18 REL="NEXT"
19 TITLE="SDL_QuitSubSystem"
20 HREF="sdlquitsubsystem.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 SUMMARY="Header navigation table"
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="sdlinit.html"
49 ACCESSKEY="P"
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="sdlquitsubsystem.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><H1
72 ><A
73 NAME="SDLINITSUBSYSTEM"
74 ></A
75 >SDL_InitSubSystem</H1
76 ><DIV
77 CLASS="REFNAMEDIV"
78 ><A
79 NAME="AEN510"
80 ></A
81 ><H2
82 >Name</H2
83 >SDL_InitSubSystem&nbsp;--&nbsp;Initialize subsystems</DIV
84 ><DIV
85 CLASS="REFSYNOPSISDIV"
86 ><A
87 NAME="AEN513"
88 ></A
89 ><H2
90 >Synopsis</H2
91 ><DIV
92 CLASS="FUNCSYNOPSIS"
93 ><A
94 NAME="AEN514"
95 ></A
96 ><P
97 ></P
98 ><PRE
99 CLASS="FUNCSYNOPSISINFO"
100 >#include "SDL.h"</PRE
101 ><P
102 ><CODE
103 ><CODE
104 CLASS="FUNCDEF"
105 >int <B
106 CLASS="FSFUNC"
107 >SDL_InitSubSystem</B
108 ></CODE
109 >(Uint32 flags);</CODE
110 ></P
111 ><P
112 ></P
113 ></DIV
114 ></DIV
115 ><DIV
116 CLASS="REFSECT1"
117 ><A
118 NAME="AEN520"
119 ></A
120 ><H2
121 >Description</H2
122 ><P
123 >After SDL has been initialized with <A
124 HREF="sdlinit.html"
125 ><TT
126 CLASS="FUNCTION"
127 >SDL_Init</TT
128 ></A
129 > you may initialize uninitialized subsystems with <TT
130 CLASS="FUNCTION"
131 >SDL_InitSubSystem</TT
132 >. The <TT
133 CLASS="PARAMETER"
134 ><I
135 >flags</I
136 ></TT
137 > parameter is the same as that used in <A
138 HREF="sdlinit.html"
139 ><TT
140 CLASS="FUNCTION"
141 >SDL_Init</TT
142 ></A
143 >.</P
144 ></DIV
145 ><DIV
146 CLASS="REFSECT1"
147 ><A
148 NAME="AEN529"
149 ></A
150 ><H2
151 >Examples</H2
152 ><PRE
153 CLASS="PROGRAMLISTING"
154 >/* Seperating Joystick and Video initialization. */
155 SDL_Init(SDL_INIT_VIDEO);
156 .
157 .
158 SDL_SetVideoMode(640, 480, 16, SDL_DOUBLEBUF|SDL_FULLSCREEN);
159 .
160 /* Do Some Video stuff */
161 .
162 .
163 /* Initialize the joystick subsystem */
164 SDL_InitSubSystem(SDL_INIT_JOYSTICK);
165
166 /* Do some stuff with video and joystick */
167 .
168 .
169 .
170 /* Shut them both down */
171 SDL_Quit();</PRE
172 ></DIV
173 ><DIV
174 CLASS="REFSECT1"
175 ><A
176 NAME="AEN532"
177 ></A
178 ><H2
179 >Return Value</H2
180 ><P
181 >Returns <SPAN
182 CLASS="RETURNVALUE"
183 >-1</SPAN
184 > on an error or <SPAN
185 CLASS="RETURNVALUE"
186 >0</SPAN
187 > on success.</P
188 ></DIV
189 ><DIV
190 CLASS="REFSECT1"
191 ><A
192 NAME="AEN537"
193 ></A
194 ><H2
195 >See Also</H2
196 ><P
197 ><A
198 HREF="sdlinit.html"
199 ><TT
200 CLASS="FUNCTION"
201 >SDL_Init</TT
202 ></A
203 >,
204 <A
205 HREF="sdlquit.html"
206 ><TT
207 CLASS="FUNCTION"
208 >SDL_Quit</TT
209 ></A
210 >,
211 <A
212 HREF="sdlquitsubsystem.html"
213 ><TT
214 CLASS="FUNCTION"
215 >SDL_QuitSubSystem</TT
216 ></A
217 ></P
218 ></DIV
219 ><DIV
220 CLASS="NAVFOOTER"
221 ><HR
222 ALIGN="LEFT"
223 WIDTH="100%"><TABLE
224 SUMMARY="Footer navigation table"
225 WIDTH="100%"
226 BORDER="0"
227 CELLPADDING="0"
228 CELLSPACING="0"
229 ><TR
230 ><TD
231 WIDTH="33%"
232 ALIGN="left"
233 VALIGN="top"
234 ><A
235 HREF="sdlinit.html"
236 ACCESSKEY="P"
237 >Prev</A
238 ></TD
239 ><TD
240 WIDTH="34%"
241 ALIGN="center"
242 VALIGN="top"
243 ><A
244 HREF="index.html"
245 ACCESSKEY="H"
246 >Home</A
247 ></TD
248 ><TD
249 WIDTH="33%"
250 ALIGN="right"
251 VALIGN="top"
252 ><A
253 HREF="sdlquitsubsystem.html"
254 ACCESSKEY="N"
255 >Next</A
256 ></TD
257 ></TR
258 ><TR
259 ><TD
260 WIDTH="33%"
261 ALIGN="left"
262 VALIGN="top"
263 >SDL_Init</TD
264 ><TD
265 WIDTH="34%"
266 ALIGN="center"
267 VALIGN="top"
268 ><A
269 HREF="general.html"
270 ACCESSKEY="U"
271 >Up</A
272 ></TD
273 ><TD
274 WIDTH="33%"
275 ALIGN="right"
276 VALIGN="top"
277 >SDL_QuitSubSystem</TD
278 ></TR
279 ></TABLE
280 ></DIV
281 ></BODY
282 ></HTML
283 >