SDL-1.2.14
[sdl_omap.git] / docs / man3 / SDL_GL_GetProcAddress.3
CommitLineData
e14743d1 1.TH "SDL_GL_GetProcAddress" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference"
2.SH "NAME"
3SDL_GL_GetProcAddress \- Get the address of a GL function
4.SH "SYNOPSIS"
5.PP
6\fB#include "SDL\&.h"
7.sp
8\fBvoid *\fBSDL_GL_GetProcAddress\fP\fR(\fBconst char* proc\fR);
9.SH "DESCRIPTION"
10.PP
11Returns the address of the GL function \fBproc\fR, or \fBNULL\fR if the function is not found\&. If the GL library is loaded at runtime, with \fI\fBSDL_GL_LoadLibrary\fP\fR, then \fIall\fP GL functions must be retrieved this way\&. Usually this is used to retrieve function pointers to OpenGL extensions\&.
12.SH "EXAMPLE"
13.PP
14.nf
15\f(CWtypedef void (*GL_ActiveTextureARB_Func)(unsigned int);
16GL_ActiveTextureARB_Func glActiveTextureARB_ptr = 0;
17int has_multitexture=1;
18\&.
19\&.
20\&.
21/* Get function pointer */
22glActiveTextureARB_ptr=(GL_ActiveTextureARB_Func) SDL_GL_GetProcAddress("glActiveTextureARB");
23
24/* Check for a valid function ptr */
25if(!glActiveTextureARB_ptr){
26 fprintf(stderr, "Multitexture Extensions not present\&.
27");
28 has_multitexture=0;
29}
30\&.
31\&.
32\&.
33\&.
34if(has_multitexture){
35 glActiveTextureARB_ptr(GL_TEXTURE0_ARB);
36 \&.
37 \&.
38}
39else{
40 \&.
41 \&.
42}\fR
43.fi
44.PP
45.SH "SEE ALSO"
46.PP
47\fI\fBSDL_GL_LoadLibrary\fP\fR
48.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01