glShaderBinary — load a precompiled shader binary
|const GLuint *shaders,|
|const void *binary,|
Specifies the number of shader object handles
Specifies a pointer to an array of shader object handles into which the shader binary will be loaded.
Specifies the shader binary format.
Specifies a pointer to the shader binary data in client memory.
Specifies the length of the shader binary data in bytes.
For implementations that support them,
glShaderBinary loads precompiled shader binaries.
shaders contains a list of
shader object handles. Each handle refers to a unique shader type (vertex shader or
binary points to precompiled binary
shader code in client memory, and
the format of the pre-compiled code.
The binary image is decoded according to the extension
specification defining the specified
OpenGL ES defines no specific binary formats, but does provide a mechanism
to obtain symbolic constants for such formats provided by extensions. The
number of shader binary formats supported can be obtained by querying the
GL_NUM_SHADER_BINARY_FORMATS. The list of
specific binary formats supported can be obtained by querying the value of
Depending on the types of the shader objects in
glShaderBinary will individually load binary vertex or
fragment shaders, or load an executable binary that contains an optimized
pair of vertex and fragment shaders stored in the same binary.
glShaderBinary fails, the old state of shader
objects for which the binary was being loaded will not be restored.
Shader binary support is optional and thus must be queried
before use by calling glGet
GL_INVALID_OPERATION on implementations
that do not support any shader binary formats. Such implementations instead
offer the glShaderSource
alternative for supplying OpenGL ES Shading Language shader source for compilation.
If shader binary formats are supported, then an implementation may
require that an optimized pair of vertex and fragment shader
binaries that were compiled together to be specified to
Not specifying an optimized pair my cause
to fail. Such a restriction, if it exists, will be documented in
the extension specification defining
OpenGL copies the shader binary data when
glShaderBinary is called, so an application
may free its copy of the data immediately after
the function returns.
GL_INVALID_ENUM is generated if
binaryformat is not a supported format returned in
GL_INVALID_VALUE is generated if any value in
shaders is not a vlue generated by OpenGL.
GL_INVALID_VALUE is generated if the format of the
data pointed to by
binary does not match
GL_INVALID_VALUE is generated if
length is negative.
GL_INVALID_OPERATION is generated if any value in
shaders is not a shader object, or if there
is more than one vertex shader object handle or more than one fragment shader
object handle in
Copyright © 2008 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. https://opencontent.org/openpub/.