glcreateshader(3g) [osx man page]

GLCREATESHADER(3G)						    OpenGL 3.3							GLCREATESHADER(3G)

NAME

       glCreateShader - Creates a shader object

C SPECIFICATION

       GLuint glCreateShader(GLenum shaderType);

PARAMETERS

       shaderType
	   Specifies the type of shader to be created. Must be one of GL_VERTEX_SHADER, GL_GEOMETRY_SHADER or GL_FRAGMENT_SHADER.

DESCRIPTION

       glCreateShader creates an empty shader object and returns a non-zero value by which it can be referenced. A shader object is used to
       maintain the source code strings that define a shader.  shaderType indicates the type of shader to be created. Three types of shaders are
       supported. A shader of type GL_VERTEX_SHADER is a shader that is intended to run on the programmable vertex processor. A shader of type
       GL_GEOMETRY_SHADER is a shader that is intended to run on the programmable geometry processor. A shader of type GL_FRAGMENT_SHADER is a
       shader that is intended to run on the programmable fragment processor.

       When created, a shader object's GL_SHADER_TYPE parameter is set to either GL_VERTEX_SHADER, GL_GEOMETRY_SHADER or GL_FRAGMENT_SHADER,
       depending on the value of shaderType.

NOTES

       Like buffer and texture objects, the name space for shader objects may be shared across a set of contexts, as long as the server sides of
       the contexts share the same address space. If the name space is shared across contexts, any attached objects and the data associated with
       those attached objects are shared as well.

       Applications are responsible for providing the synchronization across API calls when objects are accessed from different execution threads.

ERRORS

       This function returns 0 if an error occurs creating the shader object.

       GL_INVALID_ENUM is generated if shaderType is not an accepted value.

ASSOCIATED GETS

       glGetShader() with a valid shader object and the parameter to be queried

       glGetShaderInfoLog() with a valid shader object

       glGetShaderSource() with a valid shader object

       glIsShader()

SEE ALSO

       glAttachShader(), glCompileShader(), glDeleteShader(), glDetachShader(), glShaderSource()

COPYRIGHT

       Copyright (C) 2003-2005 3Dlabs Inc. Ltd. 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/.

OpenGL 3.3							    03/08/2011							GLCREATESHADER(3G)

GLGETSHADER(3G) 						    OpenGL 3.3							   GLGETSHADER(3G)

NAME

       glGetShaderiv - Returns a parameter from a shader object

C SPECIFICATION

       void glGetShaderiv(GLuint shader, GLenum pname, GLint *params);

PARAMETERS

       shader
	   Specifies the shader object to be queried.

       pname
	   Specifies the object parameter. Accepted symbolic names are GL_SHADER_TYPE, GL_DELETE_STATUS, GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH,
	   GL_SHADER_SOURCE_LENGTH.

       params
	   Returns the requested object parameter.

DESCRIPTION

       glGetShader returns in params the value of a parameter for a specific shader object. The following parameters are defined:

       GL_SHADER_TYPE

	   params returns GL_VERTEX_SHADER if shader is a vertex shader object, GL_GEOMETRY_SHADER if shader is a geometry shader object, and
	   GL_FRAGMENT_SHADER if shader is a fragment shader object.

       GL_DELETE_STATUS

	   params returns GL_TRUE if shader is currently flagged for deletion, and GL_FALSE otherwise.

       GL_COMPILE_STATUS

	   params returns GL_TRUE if the last compile operation on shader was successful, and GL_FALSE otherwise.

       GL_INFO_LOG_LENGTH

	   params returns the number of characters in the information log for shader including the null termination character (i.e., the size of
	   the character buffer required to store the information log). If shader has no information log, a value of 0 is returned.

       GL_SHADER_SOURCE_LENGTH

	   params returns the length of the concatenation of the source strings that make up the shader source for the shader, including the null
	   termination character. (i.e., the size of the character buffer required to store the shader source). If no source code exists, 0 is
	   returned.

NOTES

       If an error is generated, no change is made to the contents of params.

ERRORS

       GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

       GL_INVALID_OPERATION is generated if shader does not refer to a shader object.

       GL_INVALID_ENUM is generated if pname is not an accepted value.

ASSOCIATED GETS

       glGetShaderInfoLog() with argument shader

       glGetShaderSource() with argument shader

       glIsShader()

SEE ALSO

       glCompileShader(), glCreateShader(), glDeleteShader(), glGetProgram(), glShaderSource()

COPYRIGHT

       Copyright (C) 2003-2005 3Dlabs Inc. Ltd. 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/.

OpenGL 3.3							    03/08/2011							   GLGETSHADER(3G)