glshaderbinary(3g) [centos man page]

GLSHADERBINARY(3G)						   OpenGL Manual						GLSHADERBINARY(3G)

NAME

       glShaderBinary - load pre-compiled shader binaries

C SPECIFICATION

       void glShaderBinary(GLsizei count, const GLuint *shaders, GLenum binaryFormat, const void *binary, GLsizei length);

PARAMETERS

       count
	   Specifies the number of shader object handles contained in shaders.

       shaders
	   Specifies the address of an array of shader handles into which to load pre-compiled shader binaries.

       binaryFormat
	   Specifies the format of the shader binaries contained in binary.

       binary
	   Specifies the address of an array of bytes containing pre-compiled binary shader code.

       length
	   Specifies the length of the array whose address is given in binary.

DESCRIPTION

       glShaderBinary loads pre-compiled shader binary code into the count shader objects whose handles are given in shaders.  binary points to
       length bytes of binary shader code stored in client memory.  binaryFormat specifies the format of the pre-compiled code.

       The binary image contained in binary will be decoded according to the extension specification defining the specified binaryFormat token.
       OpenGL does not define any specific binary formats, but it does provide a mechanism to obtain token vaues for such formats provided by such
       extensions.

       Depending on the types of the shader objects in shaders, 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.

ERRORS

       GL_INVALID_OPERATION is generated if more than one of the handles in shaders refers to the same shader object.

       GL_INVALID_ENUM is generated if binaryFormat is not an accepted value.

       GL_INVALID_VALUE is generated if the data pointed to by binary does not match the format specified by binaryFormat.

ASSOCIATED GETS

       glGet() with parameter GL_NUM_SHADER_BINARY_FORMATS.

       glGet() with parameter GL_SHADER_BINARY_FORMATS.

SEE ALSO

       glGetProgram(), glGetProgramBinary(), glProgramBinary()

COPYRIGHT

       Copyright (C) 2010 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.  http://opencontent.org/openpub/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014							GLSHADERBINARY(3G)

GLGETPROGRAMBINARY(3G)						   OpenGL Manual					    GLGETPROGRAMBINARY(3G)

NAME

       glGetProgramBinary - return a binary representation of a program object's compiled and linked executable source

C SPECIFICATION

       void glGetProgramBinary(GLuint program, GLsizei bufsize, GLsizei *length, GLenum *binaryFormat, void *binary);

PARAMETERS

       program
	   Specifies the name of a program object whose binary representation to retrieve.

       bufSize
	   Specifies the size of the buffer whose address is given by binary.

       length
	   Specifies the address of a variable to receive the number of bytes written into binary.

       binaryFormat
	   Specifies the address of a variable to receive a token indicating the format of the binary data returned by the GL.

       binary
	   Specifies the address an array into which the GL will return program's binary representation.

DESCRIPTION

       glGetProgramBinary returns a binary representation of the compiled and linked executable for program into the array of bytes whose address
       is specified in binary. The maximum number of bytes that may be written into binary is specified by bufSize. If the program binary is
       greater in size than bufSize bytes, then an error is generated, otherwise the actual number of bytes written into binary is returned in the
       variable whose address is given by length. If length is NULL, then no length is returned.

       The format of the program binary written into binary is returned in the variable whose address is given by binaryFormat, and may be
       implementation dependent. The binary produced by the GL may subsequently be returned to the GL by calling glProgramBinary(), with
       binaryFormat and length set to the values returned by glGetProgramBinary, and passing the returned binary data in the binary parameter.

ERRORS

       GL_INVALID_OPERATION is generated if bufSize is less than the size of GL_PROGRAM_BINARY_LENGTH for program.

       GL_INVALID_OPERATION is generated if GL_LINK_STATUS for the program object is false.

ASSOCIATED GETS

       glGetProgram() with argument GL_PROGRAM_BINARY_LENGTH

SEE ALSO

       glGetProgram(), glProgramBinary()

COPYRIGHT

       Copyright (C) 2010 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.  http://opencontent.org/openpub/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014						    GLGETPROGRAMBINARY(3G)