DRAFT |
SDL_GL_SetAttribute
Use this function to set an OpenGL window attribute before window creation.
Contents
Syntax
int SDL_GL_SetAttribute(SDL_GLattr attr,
int value)
Function Parameters
attr |
the SDL_GLattr to set; see Remarks for details |
value |
the desired value for the attribute |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
*
SDL_GL_SetAttribute( SDL_GL_RED_SIZE, 5 );
SDL_GL_SetAttribute( SDL_GL_GREEN_SIZE, 5 );
SDL_GL_SetAttribute( SDL_GL_BLUE_SIZE, 5 );
SDL_GL_SetAttribute( SDL_GL_DEPTH_SIZE, 16 );
SDL_GL_SetAttribute( SDL_GL_DOUBLEBUFFER, 1 );
if ( (screen=SDL_SetVideoMode( 640, 480, 16, SDL_OPENGL )) == NULL ) {
fprintf(stderr, "Couldn't set GL mode: %s\n", SDL_GetError());
SDL_Quit();
return;
}
*
green
Remarks
*
This function sets the OpenGL attribute attr to value. The requested attributes will take effect after creating an OpenGL context. You should use SDL_GL_GetAttribute() to check the values after creating the context, since the values obtained can differ from the requested ones.
attr can be one of these values:
SDL_GL_RED_SIZE |
the minimum number of bits for the red channel of the color buffer; defaults to 3 |
SDL_GL_GREEN_SIZE |
the minimum number of bits for the green channel of the color buffer; defaults to 3 |
SDL_GL_BLUE_SIZE |
the minimum number of bits for the blue channel of the color buffer; defaults to 2 |
SDL_GL_ALPHA_SIZE |
the minimum number of bits for the alpha channel of the color buffer; defaults to 0 |
SDL_GL_BUFFER_SIZE |
the minimum number of bits for frame buffer size; defaults to 0 |
SDL_GL_DOUBLEBUFFER |
whether the output is single or double buffered; defaults to double buffering on |
SDL_GL_DEPTH_SIZE |
the minimum number of bits in the depth buffer; defaults to 16 |
SDL_GL_STENCIL_SIZE |
the minimum number of bits in the stencil buffer; defaults to 0 |
SDL_GL_ACCUM_RED_SIZE |
the minimum number of bits for the red channel of the accumulation buffer; defaults to 0 |
SDL_GL_ACCUM_GREEN_SIZE |
the minimum number of bits for the green channel of the accumulation buffer; defaults to 0 |
SDL_GL_ACCUM_BLUE_SIZE |
the minimum number of bits for the blue channel of the accumulation buffer; defaults to 0 |
SDL_GL_ACCUM_ALPHA_SIZE |
the minimum number of bits for the alpha channel of the accumulation buffer; defaults to 0 |
SDL_GL_STEREO |
whether the output is stereo 3D; defaults to off |
SDL_GL_MULTISAMPLEBUFFERS |
the number of buffers used for multisample anti-aliasing; defaults to 0; see Remarks for details |
SDL_GL_MULTISAMPLESAMPLES |
the number of samples used around the current pixel used for multisample anti-aliasing; defaults to 0; see Remarks for details |
SDL_GL_ACCELERATED_VISUAL |
set to 1 to require hardware acceleration, set to 0 to force software rendering; defaults to allow either |
SDL_GL_RETAINED_BACKING |
not used (deprecated) |
SDL_GL_CONTEXT_MAJOR_VERSION |
OpenGL context major version; see Remarks for details |
SDL_GL_CONTEXT_MINOR_VERSION |
OpenGL context minor version; see Remarks for details |
SDL_GL_CONTEXT_FLAGS |
some combination of 0 or more of elements of the SDL_GLcontextFlag enumeration; defaults to 0 |
SDL_GL_CONTEXT_PROFILE_MASK |
type of GL context (Core, Compatibility, ES). See SDL_GLprofile; default value depends on platform |
SDL_GL_SHARE_WITH_CURRENT_CONTEXT |
OpenGL context sharing; defaults to 0 |
SDL_GL_FRAMEBUFFER_SRGB_CAPABLE |
requests sRGB capable visual; defaults to 0 (>= SDL 2.0.1) |
SDL_GL_CONTEXT_RELEASE_BEHAVIOR |
sets context the release behavior; defaults to 1 (>= SDL 2.0.4) |
SDL_GL_CONTEXT_EGL |
not used (deprecated) |
