Lua GLSL Api - Revision history

Beherith at 11:15, 3 June 2022

2022-06-03T11:15:24Z

← Older revision		Revision as of 12:15, 3 June 2022
Line 50:		Line 50:
	<syntaxhighlight lang="c">uniform vec4 teamColor;</syntaxhighlight>		<syntaxhighlight lang="c">uniform vec4 teamColor;</syntaxhighlight>
	}}		}}


	{{LuaCallout		{{LuaCallout
Line 117:		Line 118:
	\|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.		\|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		{{LuaCallout
Line 150:		Line 152:
	\|info = Sets the tesselation shader parameters for shaderID. Needed by tesselation shader programs (check the opengl GL_ARB_tessellation_shader extension for glProgramParameteri) <br> Introduced in 104.0.1-596 (maintenance)		\|info = Sets the tesselation shader parameters for shaderID. Needed by tesselation shader programs (check the opengl GL_ARB_tessellation_shader extension for glProgramParameteri) <br> Introduced in 104.0.1-596 (maintenance)
	}}		}}


	{{LuaCallout		{{LuaCallout
Line 166:		Line 169:
	\|info = Query the active (actually used) uniforms of a shader and identify their names, types (float, int, uint) and sizes (float, vec4, ...).		\|info = Query the active (actually used) uniforms of a shader and identify their names, types (float, int, uint) and sizes (float, vec4, ...).
	}}		}}


	{{LuaCallout		{{LuaCallout
Line 199:		Line 203:
	\|info = Sets the uniform float value at the locationID for the currently active shader. Shader must be activated before setting uniforms.		\|info = Sets the uniform float value at the locationID for the currently active shader. Shader must be activated before setting uniforms.
	}}		}}


	{{LuaCallout		{{LuaCallout

Beherith: finish luacallout

2022-06-03T11:14:39Z

finish luacallout

@@ Line 1: / Line 1: @@
 [[Engine_Development|Development]] < [[Lua_Scripting|Lua Scripting]] < {{FULLPAGENAME}}
-<span class="warning">These functions are ONLY available if the graphic board supports GLSL.<br><br> Please test in your scripts if one of them exists before you use them!</span>
+These functions are ONLY available if the graphics adapter supports GLSL.<br><br> Please test in your scripts if one of them exists before you use them. In headless mode, the gl. callouts are nil.
-'''gl.CreateShader'''
+{{LuaCallout
    ({[ vertex   = "glsl code" ,]
      [ tcs      = "glsl code" ,]
@@ Line 18: / Line 32: @@
      [ geoOutputVerts = number maxVerts,]
      [ definitions = "string of shader #defines", ]
-   }) -> number shaderID
+   })
 * 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.
@@ Line 35: / Line 49: @@
 * 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
@@ Line 168: / Line 183: @@
 }}
-'''gl.UniformInt'''
+{{LuaCallout
-  ( number locationID, number int1 [,number int2 [,number int3 [,number int4]]] ) -> nil
+|prefix = gl.
-'''gl.UniformMatrix'''
+{{LuaCallout
-  ( number locationID,
+|prefix = gl.
-    "shadow" |
+|name = UniformArray
-    "camera" |
+|arg1 = {{type|number}} locationID
-    "caminv" |
+|arg2 = {{type|number }} type
-    "camprj" |
+|arg3 = {{type|table }} uniforms
-    number m1, number m2, number m3, number m4 |
+|arg4 =
-    number m1, ... , number m9 |
+|arg5 =
-    number m1, ... , number m16
+|arg6 =
-  ) -> nil
+|arg7 =
 [[category: Lua]]

Beherith: Move some bits to LuaCallout, clarify things

2022-06-03T09:05:40Z

Move some bits to LuaCallout, clarify things

Show changes

Ivand: none drawing event -> NON-drawing events

2019-10-05T23:38:07Z

none drawing event -> NON-drawing events

← Older revision		Revision as of 00:38, 6 October 2019
Line 39:		Line 39:
	( number shaderID ) -> nil		( number shaderID ) -> nil

	'''gl.ActiveShader''' <font color="#55ee99">can be used in ~~none~~ drawing events (to update uniforms etc.)!</font>		'''gl.ActiveShader''' <font color="#55ee99">can be used in NON-drawing events (to update uniforms etc.)!</font>
	( number shaderID, function [, arg1 [, arg2, ..]] ) -> nil		( number shaderID, function [, arg1 [, arg2, ..]] ) -> nil

Ivand at 17:37, 13 August 2018

2018-08-13T17:37:39Z

← Older revision		Revision as of 18:37, 13 August 2018
Line 75:		Line 75:
	'''gl.UniformArray''' {{new\|95.0}}		'''gl.UniformArray''' {{new\|95.0}}
	( number locationID, number type, table uniforms ) -> nil		( number locationID, number type, table uniforms ) -> nil
	<span class="note">type can be one of {1 = int, 2 = float}. In 104.0 the maximum length of the uniforms table increased from 32 entries to 1024.</span>		<span class="note">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.</span>

	'''gl.UniformMatrix'''		'''gl.UniformMatrix'''

Ivand at 17:36, 13 August 2018

2018-08-13T17:36:50Z

← Older revision		Revision as of 18:36, 13 August 2018
Line 75:		Line 75:
	'''gl.UniformArray''' {{new\|95.0}}		'''gl.UniformArray''' {{new\|95.0}}
	( number locationID, number type, table uniforms ) -> nil		( number locationID, number type, table uniforms ) -> nil
	<span class="note">type can be one of {0 = int, 1 = float}. In 104.0 the maximum length of the uniforms table increased from 32 entries to 1024.</span>		<span class="note">type can be one of {1 = int, 2 = float}. In 104.0 the maximum length of the uniforms table increased from 32 entries to 1024.</span>

	'''gl.UniformMatrix'''		'''gl.UniformMatrix'''

Ivand at 14:23, 12 August 2018

2018-08-12T14:23:07Z

← Older revision		Revision as of 15:23, 12 August 2018
Line 6:		Line 6:
	'''gl.CreateShader'''		'''gl.CreateShader'''
	({[ vertex = "glsl code" ,]		({[ vertex = "glsl code" ,]
			[ tcs = "glsl code" ,]
	[ tes = "glsl code" ,]		[ tes = "glsl code" ,]
	~~[ tcs = "glsl code" ,]~~
	[ geometry = "glsl code" ,]		[ geometry = "glsl code" ,]
	[ fragment = "glsl code" ,]		[ fragment = "glsl code" ,]

Ivand at 14:22, 12 August 2018

2018-08-12T14:22:37Z

← Older revision		Revision as of 15:22, 12 August 2018
Line 10:		Line 10:
	[ geometry = "glsl code" ,]		[ geometry = "glsl code" ,]
	[ fragment = "glsl code" ,]		[ fragment = "glsl code" ,]
	[ uniform = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>		[ uniform = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array as an argument to uniformName to initialize GLSL arrays)</span>
	[ uniformInt = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>		[ uniformInt = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array as an argument to uniformName to initialize GLSL arrays)</span>
	[ uniformFloat = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>		[ uniformFloat = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array as an argument to uniformName to initialize GLSL arrays)</span>
	[ uniformMatrix = { uniformName = number value, ...} ,]		[ uniformMatrix = { uniformName = number value, ...} ,]
	[ geoInputType = number inType,]		[ geoInputType = number inType,]

Ivand: Added info about tesselation, renames, and changes/updates w.r.t gl.CreateShader()

2018-08-12T14:22:05Z

Added info about tesselation, renames, and changes/updates w.r.t gl.CreateShader()

← Older revision		Revision as of 15:22, 12 August 2018
Line 5:		Line 5:

	'''gl.CreateShader'''		'''gl.CreateShader'''
	({ [ vertex = "glsl code" ,]		({[ vertex = "glsl code" ,]
			[ tes = "glsl code" ,]
			[ tcs = "glsl code" ,]
	[ geometry = "glsl code" ,]		[ geometry = "glsl code" ,]
	[ fragment = "glsl code" ,]		[ fragment = "glsl code" ,]
	[ uniform = { uniformName = number value, ...} ,]		[ uniform = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>
	[ uniformInt = { uniformName = number value, ...} ,]		[ uniformInt = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>
	[ ~~uniformArray~~ = { uniformName = number value, ...} ,] <span class=note>~~table with > 4 and <= 32 elements~~</span>		[ uniformFloat = { uniformName = number value, ...} ,] <span class=note>(specify a Lua array to as an argument to uniformName to initialize GLSL arrays)</span>
	[ uniformMatrix = { uniformName = number value, ...} ,]		[ uniformMatrix = { uniformName = number value, ...} ,]
	[ geoInputType = number inType,]		[ geoInputType = number inType,]
Line 21:		Line 23:

	* The "Geometry" or Geometry-shader can create new vertices and vertice-stripes from points.		* 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 "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.
Line 42:		Line 48:
	( ) -> string "infoLog"		( ) -> string "infoLog"

	'''gl.SetShaderParameter''' <font color="#55ee99">needed by geometry shader programs (check the opengl ~~shader4~~ extension for glProgramParameteri)</font>		'''gl.SetShaderParameter'''
			<font color="#ff0000">Renamed to SetGeometryShaderParameter in spring version >= 104.0.1-596 (maintenance).</font>
			<font color="#55ee99">needed by geometry shader programs (check the opengl GL_ARB_geometry_shader4 extension for glProgramParameteri)</font>
	( number shaderID, number param, number value ) -> nil		( number shaderID, number param, number value ) -> nil

			'''gl.SetTesselationShaderParameter'''
			<font color="#0000ee">Available for spring versions >= 104.0.1-596 (maintenance).</font>
			<font color="#55ee99">needed by tesselation shader programs (check the opengl GL_ARB_tessellation_shader extension for glProgramParameteri)</font>
			( number param, number value ) -> nil

	'''gl.GetActiveUniforms'''		'''gl.GetActiveUniforms'''

Flozi: 104.0 - bump gl.UniformArray length restriction from 32 to 1024

2017-12-22T09:58:43Z

104.0 - bump gl.UniformArray length restriction from 32 to 1024

← Older revision		Revision as of 10:58, 22 December 2017
Line 62:		Line 62:
	'''gl.UniformArray''' {{new\|95.0}}		'''gl.UniformArray''' {{new\|95.0}}
	( number locationID, number type, table uniforms ) -> nil		( number locationID, number type, table uniforms ) -> nil
	<span class="note">type can be one of {0 = int, 1 = float}</span>		<span class="note">type can be one of {0 = int, 1 = float}. In 104.0 the maximum length of the uniforms table increased from 32 entries to 1024.</span>

	'''gl.UniformMatrix'''		'''gl.UniformMatrix'''