glShaderSource 3G
glShaderSource Replaces the source code in a shader object

## C Specification

void `glShaderSource` GLuint shader GLsizei count const GLchar **string const GLint *length

## Parameters

shader

  Specifies the handle of the shader object whose source code is to be replaced.

count

  Specifies the number of elements in the string and length arrays.

string

  Specifies an array of pointers to strings containing the source code to be loaded into the shader.

length

  Specifies an array of string lengths.

## Description

`glShaderSource` sets the source code in shader to the source code in the array of strings specified by string. Any source code previously stored in the shader object is completely replaced. The number of strings in the array is specified by count. If length is `NULL`, each string is assumed to be null terminated. If length is a value other than `NULL`, it points to an array containing a string length for each of the corresponding elements of string. Each element in the length array may contain the length of the corresponding string (the null character is not counted as part of the string length) or a value less than 0 to indicate that the string is null terminated. The source code strings are not scanned or parsed at this time; they are simply copied into the specified shader object.

## Notes

`glShaderSource` is available only if the GL version is 2.0 or greater.

OpenGL copies the shader source code strings when `glShaderSource` is called, so an application may free its copy of the source code strings immediately after the function returns.

## Errors

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

`GL_INVALID_OPERATION` is generated if shader is not a shader object.

`GL_INVALID_VALUE` is generated if count is less than 0.

`GL_INVALID_OPERATION` is generated if `glShaderSource` is executed between the execution of glBegin and the corresponding execution of glEnd.

## Associated Gets

glGetShader with arguments shader and `GL_SHADER_SOURCE_LENGTH`

glGetShaderSource with argument shader

glIsShader

## See Also

glCompileShader, glCreateShader, glDeleteShader

## Copyright

Copyright 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/.