Qrow: 1 revision imported

2026-02-24T05:52:50Z

1 revision imported

← Older revision	Revision as of 22:52, 23 February 2026
(No difference)

luainter>Beherith at 11:15, 3 June 2022

2022-06-03T11:15:24Z

New page

[[Engine_Development|Development]] < [[Lua_Scripting|Lua Scripting]] < {{FULLPAGENAME}}

These functions are ONLY available if the graphics adapter supports GLSL. Please test in your scripts if one of them exists before you use them. In headless mode, the gl. callouts are nil.

{{LuaCallout
|prefix = gl.
|name = CreateShader
|arg1 = {{type|table}} shaderParams
|arg2 =
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|number}} shaderID
|info = Create a shader from shaderParams table:

({[ vertex = "glsl code" ,]
[ tcs = "glsl code" ,]
[ tes = "glsl code" ,]
[ geometry = "glsl code" ,]
[ fragment = "glsl code" ,]
[ uniform = { uniformName = number value, ...} ,] (specify a Lua array as an argument to uniformName to initialize GLSL arrays)
[ uniformInt = { uniformName = number value, ...} ,] (specify a Lua array as an argument to uniformName to initialize GLSL arrays)
[ uniformFloat = { uniformName = number value, ...} ,] (specify a Lua array as an argument to uniformName to initialize GLSL arrays)
[ uniformMatrix = { uniformName = number value, ...} ,]
[ geoInputType = number inType,]
[ geoOutputType = number outType,]
[ geoOutputVerts = number maxVerts,]
[ definitions = "string of shader #defines", ]
})

* The "Vertex" or vertex-shader is your GLSL-Code as string, its written in a C-Dialect. This shader is busy deforming the geometry of a unit but it can not create new polygons. Use it for waves, wobbling surfaces etc.

* The "Geometry" or Geometry-shader can create new vertices and vertice-stripes from points.

* The "TCS" or Tesselation Control Shader controls how much tessellation a particular patch gets; it also defines the size of a patch, thus allowing it to augment data. It can also filter vertex data taken from the vertex shader. The main purpose of the TCS is to feed the tessellation levels to the Tessellation primitive generator stage, as well as to feed patch data (as its output values) to the Tessellation Evaluation Shader stage. TCS shader can be used with spring version >= 104.0.1-596 (maintenance), it's also available in develop branch of spring.

* The "TES" or Tesselation Evaluation Shader takes the abstract patch generated by the tessellation primitive generation stage, as well as the actual vertex data for the entire patch, and generates a particular vertex from it. Each TES invocation generates a single vertex. It can also take per-patch data provided by the Tessellation Control Shader. TES shader can be used with spring version >= 104.0.1-596 (maintenance), it's also available in develop branch of spring.

* The "Fragment" or Fragment-shader (sometimes called pixel-Shader) is post processing the allready rendered picture (for example drawing stars on the sky)- remember textures are not always 2 dimensional pictures. They can contain information about the depth, or the third value marks areas and the strength at which these are processed.

* The Uniforms are the values, you send along with the shader-program. To use them in the shader-program declare them like this:
<syntaxhighlight lang="c">uniform float frame;</syntaxhighlight>

* From 101.0 onwards, the engine will automatically fill in an appropriately named uniform for team colour if it is declared;
<syntaxhighlight lang="c">uniform vec4 teamColor;</syntaxhighlight>
}}

{{LuaCallout
|prefix = gl.
|name = DeleteShader
|arg1 = {{type|number}} shaderID
|arg2 =
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Deletes a shader identified by shaderID
}}

{{LuaCallout
|prefix = gl.
|name = ActiveShader
|arg1 = {{type|number}} shaderID
|arg2 = {{type|function}} func {{bracket}}
|arg3 = {{type|arg1}} {{bracket}}
|arg4 = {{type|arg2}} ... {{rbracket}} {{rbracket}}
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Binds a shader program identified by shaderID, and calls the Lua func with the specified arguments. Can be used in NON-drawing events (to update uniforms etc.)!
}}

{{LuaCallout
|prefix = gl.
|name = UseShader
|arg1 = {{type|number}} shaderID
|arg2 =
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|bool}} linked
|info = Binds a shader program identified by shaderID. Pass 0 to disable the shader. Returns wether the shader was successfully bound.
}}

{{LuaCallout
|prefix = gl.
|name = GetShaderLog
|arg1 =
|arg2 =
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|string}} infoLog
|info = Returns the shader compilation error log. This is empty if the shader linking failed, in that case, check your in/out blocks and ensure they match.
}}

{{LuaCallout
|prefix = gl.
|name = SetGeometryShaderParameter
|arg1 = {{type|number}} shaderID
|arg2 = {{type|number}} param
|arg3 = {{type|number}} number
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Sets the Geometry shader parameters for shaderID. Needed by geometry shader programs (check the opengl GL_ARB_geometry_shader4 extension for glProgramParameteri) Was called SetShaderParameter before 104.0.1-596 (maintenance)
}}

{{LuaCallout
|prefix = gl.
|name = SetTesselationShaderParameter
|arg1 = {{type|number}} param
|arg2 = {{type|number}} number
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Sets the tesselation shader parameters for shaderID. Needed by tesselation shader programs (check the opengl GL_ARB_tessellation_shader extension for glProgramParameteri) Introduced in 104.0.1-596 (maintenance)
}}

{{LuaCallout
|prefix = gl.
|name = GetActiveUniforms
|arg1 = {{type|number}} shaderID
|arg2 =
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|table}} ActiveUniforms = { { name = "name", type = "type", length = number length, size = number size }, ...}
|info = Query the active (actually used) uniforms of a shader and identify their names, types (float, int, uint) and sizes (float, vec4, ...).
}}

{{LuaCallout
|prefix = gl.
|name = GetUniformLocation
|arg1 = {{type|number}} shaderID
|arg2 = {{type|string}} "name"
|arg3 =
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|number}} locationID
|info = Returns the locationID of a shaders uniform. Needed for changing uniform values with gl.Uniform.
}}

{{LuaCallout
|prefix = gl.
|name = Uniform
|arg1 = {{type|number}} locationID
|arg2 = {{type|number }} f1 {{bracket}}
|arg3 = {{type|number }} f2 {{bracket}}
|arg4 = {{type|number }} f3 {{bracket}}
|arg5 = {{type|number }} f4 {{rbracket}} {{rbracket}} {{rbracket}}
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Sets the uniform float value at the locationID for the currently active shader. Shader must be activated before setting uniforms.
}}

{{LuaCallout
|prefix = gl.
|name = UniformInt
|arg1 = {{type|number}} locationID
|arg2 = {{type|number }} int1 {{bracket}}
|arg3 = {{type|number }} int2 {{bracket}}
|arg4 = {{type|number }} int3 {{bracket}}
|arg5 = {{type|number }} int4 {{rbracket}} {{rbracket}} {{rbracket}}
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Sets the uniform int value at the locationID for the currently active shader. Shader must be activated before setting uniforms.
}}

{{LuaCallout
|prefix = gl.
|name = UniformArray
|arg1 = {{type|number}} locationID
|arg2 = {{type|number }} type
|arg3 = {{type|table }} uniforms
|arg4 =
|arg5 =
|arg6 =
|arg7 =
|arg8 =
|arg9 =
|return = {{type|nil}}
|info = Sets the an array of uniform values at the locationID for the currently active shader. Shader must be activated before setting uniforms. Type can be one of {1 = int, 2 = float, 3 = float matrix}. In 104.0 the maximum length of the uniforms table increased from 32 entries to 1024.
}}

{{LuaCallout
|prefix = gl.
|name = UniformMatrix
|arg1 = {{type|number}} locationID
|arg2 = {{type|string}} "shadows" {{pipe}} "camera" {{pipe}} "caminv" {{pipe}} "camprj" {{pipe}} {{type|number}} m1
|arg3 = {{type|number}} m2
|arg4 = {{type|number}} m3
|arg5 = {{type|number}} m4
|arg6 = {{type|number}} m5
|arg7 = {{type|number}} m6
|arg8 = {{type|number}} m7
|arg9 = {{type|number}} m8 ... , m16
|return = {{type|nil}}
|info = Sets the a uniform mat4 locationID for the currently active shader. Shader must be activated before setting uniforms. Can set one one common matrix like shadow, or by passing 16 additional numbers for the matrix.
}}

[[category: Lua]]

Lua GLSL Api - Revision history

Qrow: 1 revision imported

luainter>Beherith at 11:15, 3 June 2022