Lua OpenGL Api

From Spring
Jump to navigationJump to search

Development < Lua Scripting < Lua OpenGL Api

Spring

gl.GetSun ( )
return: number sunPosX, number sunPosY, number sunPosZ

or

gl.GetSun ( string "pos" )
return: number sunPosX, number sunPosY, number sunPosZ

or

gl.GetSun ( string "shadowDensity" [, string "unit" ] )
return: number shadowDensity

or

gl.GetSun ( string "diffuse" [, string "unit" ] )
return: nil | number r, number g, number b

or

gl.GetSun ( string "ambient" [, string "unit" ] )
return: nil | number r, number g, number b

or

gl.GetSun ( string "specular" [, string "unit" ] )
return: nil | number r, number g, number b


gl.GetAtmosphere ( string name )
return: number r, number g, number b

New in version 101.0
See Spring.SetAtmosphere for details.


gl.GetWaterRendering ( string name )
return: nil | number r, number g, number b | string texName | bool active

New in version 104.0
See Spring.SetWaterParams for details.


gl.GetMapRendering ( string name )
return: nil | number r, number g, number b | bool active

New in version 104.0
See Spring.SetMapRenderingParams for details.


gl.ConfigScreen ( number screenWidth, number screenDistance )
return: nil

Used for Unit LODs.


gl.DrawMiniMap ( bool transform = true )
return: nil


gl.SlaveMiniMap ( bool mode )
return: nil


gl.ConfigMiniMap ( number intPX, number intPY, number intSX, number intSY )
return: nil


gl.GetViewSizes ( )
return: number x, number y

Matrices & Viewport

gl.Viewport ( number x, number y, number w, number h )
return: nil


gl.PushMatrix ( )
return: nil


gl.PopMatrix ( )
return: nil


gl.Translate ( number x, number y, number z )
return: nil


gl.Scale ( number x, number y, number z )
return: nil


gl.Scale ( number angle, number x, number y, number z )
return: nil


gl.Billboard ( )
return: nil

Use this to draw 2d primitives in DrawWorld().
To render a 2D billboarded quad in the gameworld at world position x,y,z, you do the following (at a minimum; I am skipping blending / depthtesting) here:
  gl.PushMatrix()
  gl.Texture(read what you need here)
  gl.Translate(x,y,z)
  gl.Billboard()			
  gl.TexRect(x1,y1,x2,y2)
  gl.PopMatrix()


gl.MatrixMode ( number mode )
return: nil


gl.LoadIdentity ( )
return: nil


gl.LoadMatrix ( 16 numbers or a matrix name )
return: nil


gl.MultMatrix ( ??? )
return: ???


gl.Ortho ( number left, number right, number bottom, number top, number near, number far )
return: nil


gl.Frustum ( number left, number right, number bottom, number top, number near, number far )
return: nil


gl.PushPopMatrix ( ??? )
return: ???


gl.ClipPlane ( number intPlane, bool enable | number A, number B, number C, number D )
return: nil

Note: intPlane can only be 1 or 2.

Clear

gl.Clear ( GL.DEPTH_BUFFER_BIT [, number cleardepth ] )
return: nil

or

gl.Clear ( GL.STENCIL_BUFFER_BIT [, number intClearStencil ] )
return: nil

or

gl.Clear ( GL.COLOR_BUFFER_BIT | GL.ACCUM_BUFFER_BIT [, number r, number g, number b, number a ] )
return: nil


gl.SwapBuffers ( )
return: nil

New in version 104.0
Available only in LuaMenu, meant for frame-limited LuaMenu's that want identical content in both buffers.

ResetState/Matrices

gl.ResetState ( )
return: nil

DON'T USE IT UNLESS YOU KNOW WHAT YOU ARE DOING! Each call-in has different default states, but this function resets all states to the states below no matter what!
  ShadeModel = GL.SMOOTH
  Scissor    = false
  Texture    = false
  Lighting    = false,
  ColorMask  = true, true, true, true
  DepthMask  = false
  DepthTest  = false  (GL.LEQUAL)
  Culling    = false  (GL.BACK)
  LogicOp    = false  (GL.INVERT)
  AlphaTest  = false  (GL.GREATER, 0.5f)
  Blending   = true (GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA)


gl.ResetMatrices ( )
return: nil 

  Resets GL.TEXTURE matrix stack
  Resets GL.MODELVIEW matrix stack
  Resets GL.PROJECTION matrix stack

Draw Basics

gl.BeginEnd ( number GLType, function [, arg1, ... ] )
return: nil


gl.Color ( number r, number g, number b [, number a ] | table colors = { number r, number g, number b [, number a ] } )
return: nil


gl.Vertex ( table vertex = { number x, number y, [, number z [, number w ]] } )
return: nil

or

gl.Vertex ( number x, number y )
return: nil

or

gl.Vertex ( number x, number y, number z )
return: nil

or

gl.Vertex ( number x, number y, number z, number w )
return: nil


gl.Normal ( table normal = { number x, number y, number z } | number x, number y, number z )
return: nil


gl.EdgeFlag ( bool enable )
return: nil


gl.Rect ( number x1, number y1, number x2, number y2 )
return: nil


gl.TexRect ( number x1, number y1, number x2, number y2 [, bool flip_s, bool flip_t | number s1, number t1, number s2, number t2 ] )
return: nil

Texture rect.


gl.Shape ( number GLtype, table elements )
return: nil

Elements contains:
   elements = {
     [1] = { v | vertex   = { number x, number y, number z },           <font color="#55ee99">required</font>
             n | normal   = { number x, number y, number z },           <font color="#55ee99">optional</font>
             t | texcoord = { number x, number y },                     <font color="#55ee99">optional</font>
             c | color    = { number r, number g, number b, number a }  <font color="#55ee99">optional</font>
     },
     etc ...
   }


gl.SecondaryColor ( table color = { number r, number g, number b } | number r, number g, number b )
return: nil


gl.FogCoord ( number value )
return: nil

Display Lists

Display Lists save given vertex attributes in a static buffer, so the GPU can directly read them (without the CPU). Display Lists are a lot faster (10-60x) than standard drawing with glShape/glBeginEnd, so try to use them when ever you can. If you want to learn more about them, g00gle is your friend ;)

gl.CreateList ( function [, arg1 [, arg2 ... ]] )
return: number listID


gl.CallList ( number listID )
return: nil


gl.DeleteList ( number listID )
return: nil

Vertex Array Objects

Only available in "develop" branch of spring (the future 105.0+). This is conceptually similar and serve as modern OpenGL replacement to deprecated Display Lists.

gl.CreateVertexArray ( number numElements, number numIndices [, bool persistentBuffer = false ] )
return: number bufferID 

See what elements and indices are here: http://www.opengl-tutorial.org/intermediate-tutorials/tutorial-9-vbo-indexing/ 
numElements and numIndices define the size of for elements and indices respectively. if indices are not going to be used, then set numIndices to 0
Persistent buffers (persistentBuffer = true) are more efficient for dynamically/often updated geometry.


gl.UpdateVertexArray ( number bufferID, number elementPos, number indexPos, table tbl | function func )
return: bool success 

{elementPos, indexPos} define starting element in {element, index} VBO corresponding to 1st element of the supplied vertex data
4 elements table example:
  local verts = {
    p  = {0,0,0,1,  4,0,0,1,  4,4,0,1,  0,4,0,1},
    n  = {0,1,0  ,  0,1,0  ,  0,1,0  ,  0,1,0  },
    uv = {0,0,0,0,  1,0,0,0,  1,1,0,0,  0,1,0,0},
    c0 = {1,0,0,1,  0,1,0,1,  0,0,1,1,  1,1,1,0},
    i = {0, 1, 2, 2, 1, 3},            optional, use in case of indexed VBO
    c1 = {...} }

Alternatively Lua func can use gl.Vertex/gl.Color/gl.Normal/gl.TexCoord to define vertices, similarly how it used to be done in gl.BeginEnd.Note there is no function yet to define indices.


gl.RenderVertexArray ( number bufferID, number primType [, number firstIndex = 0, number count = numElements ] )
return: bool success 

primType can be GL.POINTS, GL.LINE_STRIP, GL.LINE_LOOP, GL.LINES, GL.LINE_STRIP_ADJACENCY, GL.LINES_ADJACENCY, GL.TRIANGLE_STRIP, GL.TRIANGLE_FAN, GL.TRIANGLES, GL.TRIANGLE_STRIP_ADJACENCY, GL.TRIANGLES_ADJACENCY and GL.PATCHES
firstIndex specifies the starting index in the enabled arrays.
count specifies the number of indices to be rendered.


gl.DeleteVertexArray ( number bufferID )
return: bool success

Releases previously allocated VAO

Text

gl.Text ( string "text", number x, number y, number size [, string "options" ] )
return: nil 

  options are:
    horizontal alignment:
       'c' = center
       'r' = right
    vertical alignment:
       'a' = ascender
       't' = top
       'v' = vertical center
       'x' = baseline
       'b' = bottom
       'd' = descender
    decorations:
       'o' = black outline
       'O' = white outline
       's' = shadow
    other:
       'n' = don't round vertex coords to nearest integer (font may get blurry)


gl.GetTextWidth ( string "text" )
return: number width

Width in pixels, with a font size of 1.0.


gl.GetTextHeight ( string "text" )
return: nil | number height, number descender, number numlines

Height in pixels, with a font size of 1.0. Further descriptions here: GetTextHeight


gl.BeginText ( )
return: nil

If you have multiple gl.Text calls, then you can bunch them between a gl.BeginText and gl.EndText to speedup the rendering.


gl.EndText ( )
return: nil

Unit/Feature Draw Functions

gl.Unit ( number unitID [, bool rawdraw, number intLOD ] )
return: nil

Draws a unit - on default it uses LOD, with lod<0 it is turned off, else it defines a specific level.


gl.UnitRaw ( number unitID [, bool rawdraw, number intLOD ] )
return: nil

Doesn't apply worldspace->unit transformation! only works if rawdraw is true.


gl.UnitShape ( number unitDefID, number teamID, bool rawState, bool toScreen, bool opaque )
return: nil

New in version 101.0
The three extra boolean arguments make it so that calling only these functions is enough to get correctly rendered models; pass in 'false' for the THIRD argument to get the fixed behavior, omit it or pass in 'true' [default] to render with your own custom state instead. The FOURTH argument should be 'true' if in DrawScreen and 'false' (default) if in DrawWorld; any transforms for these two functions *MUST* include a gl.LoadIdentity call when argument #3 is false (whether they are used in DrawWorld or in DrawScreen) the FIFTH argument determines whether the model is drawn opaque ('true' [default]) or with translucency ('false'); only has an effect when argument #3 is false.


gl.UnitMultMatrix ( number unitID )
return: nil

world space -> unit space


gl.UnitPieceMultMatrix ( number unitID, number intPiece )
return: nil

unit space -> piece space


gl.UnitPiece ( number unitID, number intPiece )
return: nil

Draws the unit piece.


gl.UnitPieceMatrix ( number unitID, number intPiece )
return: nil

Use gl.UnitPieceMultMatrix instead!


gl.Feature ( number featureID )
return: nil


gl.FeatureRaw ( number featureID [, bool rawdraw, number intLOD ] )
return: nil

New in version 101.0


gl.FeatureShape ( number featureDefID, number teamID, bool custom, bool drawScreen, bool opaque )
return: nil


gl.FeatureMultMatrix ( number featureID )
return: nil

New in version 101.0
world space -> feature space


gl.FeaturePieceMultMatrix ( number featureID, number intPiece )
return: nil

New in version 101.0
feature space -> piece space


gl.FeaturePiece ( number featureID, number intPiece )
return: nil

New in version 101.0
Draws the Feature piece.


gl.FeaturePieceMatrix ( number featureID, number intPiece )
return: nil

New in version 101.0
Use gl.FeaturePieceMultMatrix instead!


gl.DrawListAtUnit ( number unitID, number listID [, bool midPos, number scaleX, number scaleY, number scaleZ, number degrees, number rotX, number rotY, number rotZ ] )
return: nil


gl.DrawFuncAtUnit ( number unitID, bool midPos, function [, arg1, ... ] )
return: nil

States (Blending,AlphaTest...)

gl.Blending ( bool enable | number srcmode, number dstmode )
return: nil

or

gl.Blending ( string mode )
return: nil

Mode can be set to:
"add"
 = GL.ONE, GL.ONE

 "alpha_add"
 = GL.SRC_ALPHA, GL.ONE

 "alpha"
 = GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA

 "reset"
 = GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA

 "color"
 = GL.SRC_COLOR, GL.ONE_MINUS_SRC_ALPHA

 "modulate"
 = GL.DST_COLOR, GL.ZERO

 "disable"
 = GL.SRC_ALPHA, GL.ONE_MINUS_SRC_ALPHA


gl.BlendEquation ( number mode )
return: nil


gl.BlendFunc ( number srcmode, number dstmode )
return: nil


gl.BlendEquationSeparate ( number modeRGB, number modeAlpha )
return: nil

Needs openGL2.0!


gl.BlendFuncSeparate ( number srcRGB, number [Lua_ConstGL#BlendingFactorDest, number srcAlpha, number dstAlpha )
return: nil

Needs openGL2.0!


gl.AlphaTest ( bool enable | number func, number threshold )
return: nil


gl.DepthTest ( bool enable | number func )
return: nil


gl.Culling ( bool enable | number face )
return: nil


gl.DepthClamp ( bool enable )
return: nil

Not always available, needs GL.NV_depth_clamp!


gl.DepthMask ( bool enable )
return: nil


gl.ColorMask ( bool masked )
return: nil

or

gl.ColorMask ( bool r, bool g, bool b, bool a )
return: nil

gl.LogicOp ( bool enable | number func )
return: nil


gl.Fog ( bool enable )
return: nil


gl.Smoothing ( bool enable | number point, bool enable | number line, bool enable | number polygon )
return: nil

Removed from version 104.0


gl.EdgeFlag ( bool enable )
return: nil


gl.Scissor ( bool enable )
return: nil

or

gl.Scissor ( number intX, number intY, number intW, number intH )
return: nil


gl.LineStipple ( string any )
return: nil

Use springs default line stipple.

or

gl.LineStipple ( bool enable )
return: nil

or

gl.LineStipple ( number intFactor, number pattern )
return: nil


gl.PolygonMode ( number face, number mode )
return: nil


gl.PolygonOffset ( bool enable | number factor, number units )
return: nil


gl.PushAttrib ( [ number attrib ] )
return: nil


gl.PopAttrib ( )
return: nil

Stencil

gl.StencilTest ( bool enable )
return: nil


gl.StencilMask ( number mask )
return: nil


gl.StencilFunc ( number func, number ref, number mask )
return: nil


gl.StencilOp ( number fail, number zfail, number zpass )
return: nil


gl.StencilMaskSeparate ( number face, number mask )
return: nil

Needs OpenGL2.0!


gl.StencilFuncSeparate ( number face, number func, number ref, number mask )
return: nil

Needs OpenGL2.0!


gl.StencilOpSeparate ( number face, number fail, number zfail, number zpass )
return: nil

Needs OpenGL2.0!

LineWidth & PointSize

gl.LineWidth ( number width )
return: nil


gl.PointSize ( number size )
return: nil

Values != 1 can break severely on ATI cards, see http://springrts.com/mantis/view.php?id=2390


gl.PointSprite ( bool enable [, bool coord_replace, bool coord_origin_upper ] )
return: nil

Needs OpenGL2.0!


gl.PointParameter ( number v1, number v2, number v3 [, number sizeMin, number sizeMax, number sizeFade ] )
return: nil

Needs OpenGL2.0!

Textures

gl.Texture ( [ number texNum, ] bool enable | string name )
return: nil | bool loaded

This is the only call-out that is needed to load and draw any texture in a Lua script. All you have to do is pass it a valid path to a valid png and it will use that image for drawing any subsequent textured rectangles. This is shown in the last line of the following list of valid strings for the name parameter.

name may be:

  1. 12

= unitDef 12 buildpic

%34:1 = unitDef 34 s3o tex2 (:0->tex1,:1->tex2)

%-102:0 = featureDef 102 s3o tex1

!56 = lua generated texture 56 (= return value of gl.CreateTexture)

$units = 3do textureatlas tex1

$units1 = 3do textureatlas tex1

$units2 = 3do textureatlas tex2

$shadow = shadowmap

$specular = specular cube map (removed in the latest develop)

$reflection = reflection cube map (can be mipmaped starting from 104.0.1-714-ga29177f. Set CubeTexGenerateMipMaps=1 in settings)

$shading = ground shading texture

$grass = grass shading texture

$heightmap = heightmap, the height in elmos is in the R channel (needs HeightMapTexture=1 set in spring config)

$minimap = minimap texture

$map_reflection = same as "$reflection" New in version 101.0

$sky_reflection = defined for SSMF maps that have a skyReflectModTex New in version 101.0

$detail = detail texture New in version 101.0

$normals = auto generated normals texture, X normal component is in r,g and b channels, Z normal component is in the A channel. If you need Y you'll need to reconstruct it form X and Z. New in version 101.0

$ssmf_normals = SSMF normals texture New in version 101.0

$ssmf_specular = SSMF specular texture New in version 101.0

$ssmf_splat_distr = SSMF splat distribution texture New in version 101.0

$ssmf_splat_detail = SSMF splat detail texture New in version 101.0

$ssmf_splat_normals = SSMF splat normals texture New in version 101.0, used as "$ssmf_splat_normals" or "$ssmf_splat_normals:X", 'X' can be a value between 0 and 3, defaults to 0 if ":X" is omitted

$ssmf_emission = SSMF emission texture New in version 101.0

$ssmf_parallax = SSMF parallax texture New in version 101.0

$info = currently active info texture (los, airlos, radar, jammer)
Note that textures contain no data until user switches to their respective modes and non-active textures are not updated in the background, so will go stale

$info_losmap = los texture (L-view)

$info_mtlmap = metal map texture (F4-view)

$info_hgtmap = height map texture (F1-view)

$info_blkmap = blocking map texture (F2-view)

$map_gbuffer_normtex = contains the smoothed normals buffer of the map in view in world space coordinates (note that to get true normal vectors from it, you must multiply the vector by 2 and subtract 1) New in version 95

$map_gbuffer_difftex = contains the diffuse texture buffer of the map in view New in version 95

$map_gbuffer_spectex = contains the specular textures of the map in view New in version 95

$map_gbuffer_emittex = for emissive materials (bloom would be the canonical use) New in version 95

$map_gbuffer_misctex = for arbitrary shader data New in version 95

$map_gbuffer_zvaltex = contains the depth values (z-buffer) of the map in view. New in version 95
To translate this to world position coordinates, use: 

 No clip control / clipspace for depth is [-1,1]
 vec4 worldpos= viewProjectionInv * vec4(vec3(gl_TexCoord[0].st, 
 texture2D( map_gbuffer_zvaltex,gl_TexCoord[0].st ).x) * 2.0 - 1.0, 1.0);

 Default if clip control is supported / clipspace for depth is [0,1].
 vec4 worldpos= viewProjectionInv * vec4(gl_TexCoord[0].st * 2.0 - 1.0, 
 texture2D( map_gbuffer_zvaltex,gl_TexCoord[0].st ).x, 1.0);

 worldpos.xyz = worldpos.xyz / worldpos.w;

$model_gbuffer_normtex = contains the smoothed normals buffer of the models in view in world space coordinates (note that to get true normal vectors from it, you must multiply the vector by 2 and subtract 1) New in version 95

$model_gbuffer_difftex = contains the diffuse texture buffer of the models in view New in version 95

$model_gbuffer_spectex = contains the specular textures of the models in view New in version 95

$model_gbuffer_emittex = for emissive materials (bloom would be the canonical use) New in version 95

$model_gbuffer_misctex = for arbitrary shader data New in version 95

$model_gbuffer_zvaltex = contains the depth values (z-buffer) of the models in view. New in version 95

${opt}:/LuaUI/images/image.png = load a texture from the VFS 


  possible ${opt}'s are:
     'n' = nearest
     'l' = linear
     'a' = aniso
     'i' = invert
     'g' = greyed
     'c' = clamped
     'b' = border
     't%r,%g,%b' = tint
     'r%width,%height' = resize
  The above ${opt}'s are NOT available for .DDS textures! .dds will load faster than other image formats.

   example: ":iac:/LuaUI/images/image.png"
   example: ":cr16,16:/LuaUI/images/image.png"
   example2: ":t1.0,0.5,0:/LuaUI/images/image.png"  (orange tint)


gl.CreateTexture ( number intXSize, number intYSize [, table texProps ] )
return: string texture

texProps contains:
texProps = {
    [target     = number,](like GL.TEXTURE_1D,GL.TEXTURE_2D,...)(Added support for GL_TEXTURE_2D_MULTISAMPLE in 104.0.1-1015-g8e36ef2 maintenance)
    [format     = number,]
    [min_filter = [[Lua_ConstGL#Texture_Filtering|number]],]
    [mag_filter = [[Lua_ConstGL#Texture_Filtering|number]],]
    [wrap_s     = [[Lua_ConstGL#Texture_Clamping|number]],]
    [wrap_t     = [[Lua_ConstGL#Texture_Clamping|number]],]
    [wrap_r     = [[Lua_ConstGL#Texture_Clamping|number]],]
    [aniso      = number,]
    [border     = boolean,]
    [fbo        = boolean,] (needs GLEW_EXT_framebuffer_object!)
    [fboDepth   = boolean,] (needs GLEW_EXT_framebuffer_object!)
    [samples    = number,] specify any number here and target = GL_TEXTURE_2D_MULTISAMPLE to create multisample texture (Added in 104.0.1-1015-g8e36ef2 maintenance)
  }


gl.DeleteTexture ( string texture )
return: bool deleted


gl.DeleteTextureFBO ( string texture )
return: bool deleted

Needs GLEW_EXT_framebuffer_object!


gl.TextureInfo ( string texture )
return: nil | table texInfo

texInfo contains:
 texInfo = {
      xsize = number,
      ysize = number,
      alpha = boolean, //not used yet
      type  = number,  //not used yet
    }

The format of the texture string is the same as in gl.Texture().


gl.MultiTexCoord ( number x [, number y [, number z [, number w ]]] | table texCoords = { number x [, number y [, number z [, number w ]]] } )
return: nil


gl.TexEnv ( number target, number pname, number value )
return: nil

or

gl.TexEnv ( number target, number pname, number var1, number var2, number var3 )
return: nil


gl.MultiTexEnv ( number texNum, number target, number pname, number value )
return: nil

or

gl.MultiTexEnv ( number texNum, number target, number pname, number var1, number var2, number var3 )
return: nil


gl.TexGen ( number target, bool state )
return: nil

or

gl.TexGen ( number target, number pname, number value )
return: nil

or

gl.TexGen ( number target, bool pname, number var1, number var2, number var3 )
return: nil


gl.MultiTexGen ( number intTexNum, number target, bool state )
return: nil

or

gl.MultiTexGen ( number intTexNum, number target, number pname, number value )
return: nil

or

gl.MultiTexGen ( number intTexNum, number target, number pname, number var1, number var2, number var3 )
return: nil


gl.CopyToTexture ( string texture, number intXOff, number intYOff, number intX, number intY, number intW, number intH [, number target, number level ] )
return: nil


gl.RenderToTexture ( string fbotexture, function lua_func )
return: nil

Needs GLEW_EXT_framebuffer_object!


gl.GenerateMipmap ( string texture )
return: bool created

Needs glGenerateMipmapEXT!
The following are primarily intended to be used in conjunction with
     gl.{Unit,Feature}(objID, ..., raw=true)
     gl.{Unit,Feature}Shape(defID, ..., raw=true)
and apply a model's default textures; easier than gl.Texture("$%...")


gl.UnitTextures ( number unitID, bool enable )
return: bool enabled


gl.UnitShapeTextures ( number unitDefID, bool enable )
return: bool enabled


gl.FeatureTextures ( number featureID, bool enable )
return: bool enabled


gl.FeatureShapeTextures ( number featureDefID, bool enable )
return: bool enabled

PixelReadback

gl.SaveImage ( number x, number y, number w, number h, string filename [, table imgProps = { alpha=bool, yflip=bool, grayscale16bit=bool, readbuffer=number } ] )
return: nil | bool success

grayscale16bit is New in version 99.0 and allows to save single color 16bit PNG

readbuffer is New in version 104+ and allows to choose the attachment of MRT FBO, use GL_COLOR_ATTACHMENT0_EXT and further as index


gl.ReadPixels ( number x, number y, number w, number h [, number format = GL.RGBA ] )
return: nil | number r [, g [, b [, a {rbracket

{rbracket}}{rbracket}} | table readPixels = { { { 1 = number r, 2 = number g, 3 = number b, 4 = number a}, ... }, ... }

|info = This reads back pixels from the final rendered screen. E.g. you can make a screenshot by grabbing the whole view. }}

Lights

gl.Lighting ( bool enable )
return: nil


gl.ShadeModel ( number mode )
return: nil


gl.Light ( number intLight, bool enable )
return: nil

or

gl.Light ( number intLight, number pname, number param )
return: nil

or

gl.Light ( number intLight, number pname, number param1, number param2, number param3 )
return: nil


gl.Material ( table material )
return: nil

material contains:
material = {
    ambient   = {number r, number g, number b[, number a]},
    diffuse   = {number r, number g, number b[, number a]},
    ambidiff  = {number r, number g, number b[, number a]},
    emission  = {number r, number g, number b[, number a]},
    specular  = {number r, number g, number b[, number a]},
    shininess = number specularExponent
  }

Hardware relevant

gl.HasExtension ( string extname )
return: bool hasExtension


gl.GetNumber ( number ext, number intCount )
return: number number1 [, number number2, number number3, ... #count ]


gl.GetString ( number ext )
return: string extString

DrawGroundPrimitives

gl.DrawGroundCircle ( number x, number y, number z, number radius, number divs [, number slope ] )
return: nil

Note: Number divs is the number of sides the circle will have. The higher the smoother the circle (and more GPU intensive).


gl.DrawGroundQuad ( number x1, number z1, number x2, number z2 [, bool useNorm [, number tu1, number tv1, number tu2, number tv2 ] | [ bool useTextureCoord ] ] )
return: nil

Note: x1, z1, x2 & z2 are rounded, so don't use it for very small or moving objects. x and z correspond to the coordinates displayed by the tooltip.
Also note: useNorm does nothing!

Queries

gl.CreateQuery ( )
return: nil | userdata query

Needs >=OpengGL2.0!


gl.DeleteQuery ( userdata query )
return: nil

Needs >=OpengGL2.0!


gl.RunQuery ( userdata query, function func, arg1, arg2, ... )
return: nil

Needs >=OpengGL2.0!


gl.GetQuery ( userdata query )
return: nil | number renderedFragments

Extended

gl.ActiveTexture ( number intTexNum, function func [, arg1, ... ] )
return: nil


gl.GetGlobalTexNames ( )
return: table texNames = { [1] = string texture, etc ... }


gl.GetGlobalTexCoords ( string 3doTextureName )
return: number xstart, number ystart, number xend, number yend

Gets the texcoord of a 3do texture in the 3do texture atlas.


gl.UnsafeState ( number state [, bool disable_state ], bool func, arg1, arg2, ... )
return: nil

Calls glEnable(state) or glDisable(state) (if disable_state==true) and
then calls the lua_function and afterwards reverts the state.


gl.GetShadowMapParams ( )
return: number xmid, number ymid, number p17, number p18


gl.GetMatrixData ( GL.PROJECTION [, number intI )
return: nil | number number1, etc... | number Matrix[i]

or

gl.GetMatrixData ( GL.MODELVIEW [, number intI )
return: nil | number number1, etc... | number Matrix[i]

or

gl.GetMatrixData ( GL.TEXTURE [, number intI )
return: nil | number number1, etc... | number Matrix[i]

or

gl.GetMatrixData ( string "shadow" )
return: nil | number number1, etc...

or

gl.GetMatrixData ( string "camera" )
return: nil | number number1, etc...

gl.GetMatrixData ( string "caminv" )
return: nil | number number1, etc...

or

gl.GetMatrixData ( string "camprj" )
return: nil | number number1, etc...

or

gl.GetMatrixData ( string "billboard" )
return: nil | number number1, etc...


gl.Flush ( )
return: nil


gl.Finish ( )
return: nil

Shaders (GLSL)

 Lua_GLSL_Api
Retrieved from "https://springrts.com/mediawiki/index.php?title=Lua_OpenGL_Api&oldid=31648"