Initial bulk commit for "Git on MSys"
[msysgit/historical-msysgit.git] / mingw / man / man3 / SDL_GL_GetProcAddress.3
blob3a34cbd52cc6f031cf1f1d25525c55b73f1e7ea7
1 .TH "SDL_GL_GetProcAddress" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
2 .SH "NAME"
3 SDL_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
11 Returns 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);
16 GL_ActiveTextureARB_Func glActiveTextureARB_ptr = 0;
17 int has_multitexture=1;
18 \&.
19 \&.
20 \&.
21 /* Get function pointer */
22 glActiveTextureARB_ptr=(GL_ActiveTextureARB_Func) SDL_GL_GetProcAddress("glActiveTextureARB");
24 /* Check for a valid function ptr */
25 if(!glActiveTextureARB_ptr){
26   fprintf(stderr, "Multitexture Extensions not present\&.
27 ");
28   has_multitexture=0;
30 \&.
31 \&.
32 \&.
33 \&.
34 if(has_multitexture){
35   glActiveTextureARB_ptr(GL_TEXTURE0_ARB);
36   \&.
37   \&.
39 else{
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