SDL-1.2.14
[sdl_omap.git] / docs / html / sdlglloadlibrary.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >SDL_GL_LoadLibrary</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="Video"
14 HREF="video.html"><LINK
15 REL="PREVIOUS"
16 TITLE="SDL_ShowCursor"
17 HREF="sdlshowcursor.html"><LINK
18 REL="NEXT"
19 TITLE="SDL_GL_GetProcAddress"
20 HREF="sdlglgetprocaddress.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="sdlshowcursor.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="sdlglgetprocaddress.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="SDLGLLOADLIBRARY"
74 ></A
75 >SDL_GL_LoadLibrary</H1
76 ><DIV
77 CLASS="REFNAMEDIV"
78 ><A
79 NAME="AEN2648"
80 ></A
81 ><H2
82 >Name</H2
83 >SDL_GL_LoadLibrary&nbsp;--&nbsp;Specify an OpenGL library</DIV
84 ><DIV
85 CLASS="REFSYNOPSISDIV"
86 ><A
87 NAME="AEN2651"
88 ></A
89 ><H2
90 >Synopsis</H2
91 ><DIV
92 CLASS="FUNCSYNOPSIS"
93 ><A
94 NAME="AEN2652"
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_GL_LoadLibrary</B
108 ></CODE
109 >(const char *path);</CODE
110 ></P
111 ><P
112 ></P
113 ></DIV
114 ></DIV
115 ><DIV
116 CLASS="REFSECT1"
117 ><A
118 NAME="AEN2658"
119 ></A
120 ><H2
121 >Description</H2
122 ><P
123 >If you wish, you may load the OpenGL library at runtime, this must be done before <A
124 HREF="sdlsetvideomode.html"
125 ><TT
126 CLASS="FUNCTION"
127 >SDL_SetVideoMode</TT
128 ></A
129 > is called. The <TT
130 CLASS="PARAMETER"
131 ><I
132 >path</I
133 ></TT
134 > of the GL library is passed to <TT
135 CLASS="FUNCTION"
136 >SDL_GL_LoadLibrary</TT
137 > and it returns <SPAN
138 CLASS="RETURNVALUE"
139 >0</SPAN
140 > on success, or <SPAN
141 CLASS="RETURNVALUE"
142 >-1</SPAN
143 > on an error. You must then use <A
144 HREF="sdlglgetprocaddress.html"
145 ><TT
146 CLASS="FUNCTION"
147 >SDL_GL_GetProcAddress</TT
148 ></A
149 > to retrieve function pointers to GL functions.</P
150 ></DIV
151 ><DIV
152 CLASS="REFSECT1"
153 ><A
154 NAME="AEN2669"
155 ></A
156 ><H2
157 >See Also</H2
158 ><P
159 ><A
160 HREF="sdlglgetprocaddress.html"
161 ><TT
162 CLASS="FUNCTION"
163 >SDL_GL_GetProcAddress</TT
164 ></A
165 ></P
166 ></DIV
167 ><DIV
168 CLASS="NAVFOOTER"
169 ><HR
170 ALIGN="LEFT"
171 WIDTH="100%"><TABLE
172 SUMMARY="Footer navigation table"
173 WIDTH="100%"
174 BORDER="0"
175 CELLPADDING="0"
176 CELLSPACING="0"
177 ><TR
178 ><TD
179 WIDTH="33%"
180 ALIGN="left"
181 VALIGN="top"
182 ><A
183 HREF="sdlshowcursor.html"
184 ACCESSKEY="P"
185 >Prev</A
186 ></TD
187 ><TD
188 WIDTH="34%"
189 ALIGN="center"
190 VALIGN="top"
191 ><A
192 HREF="index.html"
193 ACCESSKEY="H"
194 >Home</A
195 ></TD
196 ><TD
197 WIDTH="33%"
198 ALIGN="right"
199 VALIGN="top"
200 ><A
201 HREF="sdlglgetprocaddress.html"
202 ACCESSKEY="N"
203 >Next</A
204 ></TD
205 ></TR
206 ><TR
207 ><TD
208 WIDTH="33%"
209 ALIGN="left"
210 VALIGN="top"
211 >SDL_ShowCursor</TD
212 ><TD
213 WIDTH="34%"
214 ALIGN="center"
215 VALIGN="top"
216 ><A
217 HREF="video.html"
218 ACCESSKEY="U"
219 >Up</A
220 ></TD
221 ><TD
222 WIDTH="33%"
223 ALIGN="right"
224 VALIGN="top"
225 >SDL_GL_GetProcAddress</TD
226 ></TR
227 ></TABLE
228 ></DIV
229 ></BODY
230 ></HTML
231 >