glReleaseShaderCompiler

Name

glReleaseShaderCompiler — release resources allocated by the shader compiler

C Specification

void glReleaseShaderCompiler( void);

Description

For implementations that support a shader compiler, glReleaseShaderCompiler frees resources allocated by the shader compiler. This is a hint from the application that additional shader compilations are unlikely to occur, at least for some period of time, and that the resources consumed by the shader compiler may be released and put to better use elsewhere.

However, if a call to glCompileShader is made after a call to glReleaseShaderCompiler, the shader compiler must be restored to service the compilation request as if glReleaseShaderCompiler had never been called.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGet with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary alternative for supplying a pre-compiled shader binary.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

Associated Gets

glGet with argument GL_SHADER_COMPILER