Lua UnitRendering: Difference between revisions

From Spring
Jump to navigationJump to search
Jk (talk | contribs)
77b update
Jk (talk | contribs)
mNo edit summary
Line 13: Line 13:


'''Spring.UnitRendering.GetMaterial''' <font color=#55ee99>(creates a material userdata)</font>
'''Spring.UnitRendering.GetMaterial''' <font color=#55ee99>(creates a material userdata)</font>
   ( [[Lua_UnitRendering#MaterialType|string MaterialType]], [[Lua_UnitRendering#Material_Table|table Material]] ) -> [[Lua_UnitRendering#Material_UserData|userdata Material]]
   ( [[Lua_UnitRendering#MaterialTypes|string MaterialType]], [[Lua_UnitRendering#Material_Table|table Material]] ) -> [[Lua_UnitRendering#Material_UserData|userdata Material]]


'''Spring.UnitRendering.SetMaterial'''
'''Spring.UnitRendering.SetMaterial'''
   ( number unitID, int lod, [[Lua_UnitRendering#MaterialType|string MaterialType]], [[Lua_UnitRendering#Material_UserData|userdata Material]] | [[Lua_UnitRendering#Material_Table|table Material]] ) -> nil
   ( number unitID, int lod, [[Lua_UnitRendering#MaterialTypes|string MaterialType]], [[Lua_UnitRendering#Material_UserData|userdata Material]] | [[Lua_UnitRendering#Material_Table|table Material]] ) -> nil


'''Spring.UnitRendering.SetMaterialLastLOD'''
'''Spring.UnitRendering.SetMaterialLastLOD'''
   ( number unitID, s[[Lua_UnitRendering#MaterialType|string MaterialType]], int lastLOD ) -> nil
   ( number unitID, s[[Lua_UnitRendering#MaterialTypes|string MaterialType]], int lastLOD ) -> nil


'''Spring.UnitRendering.SetMaterialDisplayLists'''
'''Spring.UnitRendering.SetMaterialDisplayLists'''
   ( number unitID, int lod, [[Lua_UnitRendering#MaterialType|string MaterialType]], [[Lua_OpenGL_Api#Display_Lists|preDisplayList]], [[Lua_OpenGL_Api#Display_Lists|postDisplayList]] ) -> nil
   ( number unitID, int lod, [[Lua_UnitRendering#MaterialTypes|string MaterialType]], [[Lua_OpenGL_Api#Display_Lists|preDisplayList]], [[Lua_OpenGL_Api#Display_Lists|postDisplayList]] ) -> nil


'''Spring.UnitRendering.SetUnitUniform''' <font color=red>(unfinished)</font>
'''Spring.UnitRendering.SetUnitUniform''' <font color=red>(unfinished)</font>
   ( number unitID, [[Lua_UnitRendering#MaterialType|string MaterialType]], int lod, arg1, arg2, ... ) -> nil
   ( number unitID, [[Lua_UnitRendering#MaterialTypes|string MaterialType]], int lod, arg1, arg2, ... ) -> nil


'''Spring.UnitRendering.SetUnitLuaDraw''' <font color=#55ee99>(enables the DrawUnit callin)</font>
'''Spring.UnitRendering.SetUnitLuaDraw''' <font color=#55ee99>(enables the DrawUnit callin)</font>

Revision as of 21:08, 8 March 2009

Unit Rendering

Spring.UnitRendering.SetLODCount

 ( number unitID, int lodCount ) -> nil

Spring.UnitRendering.SetLODLength (`lod` is 1-indexed)

 ( number unitID, int lod, number lodLength ) -> nil

Spring.UnitRendering.SetLODDistance (same as SetLODLength(), but adjusted for 45deg FOV + 1024x768)

 (number unitID,  int lod, number lodDistance ) -> nil

Spring.UnitRendering.SetPieceList (displayList=nil reset to default)

 ( number unitID, int lod, int piece [, number displayList = nil ] ) -> nil

Spring.UnitRendering.GetMaterial (creates a material userdata)

 ( string MaterialType, table Material ) -> userdata Material

Spring.UnitRendering.SetMaterial

 ( number unitID, int lod, string MaterialType, userdata Material | table Material ) -> nil

Spring.UnitRendering.SetMaterialLastLOD

 ( number unitID, sstring MaterialType, int lastLOD ) -> nil

Spring.UnitRendering.SetMaterialDisplayLists

 ( number unitID, int lod, string MaterialType, preDisplayList, postDisplayList ) -> nil

Spring.UnitRendering.SetUnitUniform (unfinished)

 ( number unitID, string MaterialType, int lod, arg1, arg2, ... ) -> nil

Spring.UnitRendering.SetUnitLuaDraw (enables the DrawUnit callin)

 ( number unitID, boolean enabled ) -> nil

Spring.UnitRendering.Debug (prints some usefull debug informations)

 ( [ number unitID ] ) -> nil

MaterialTypes

"alpha"
"opaque"
"alpha_reflect"
"opaque_reflect"
"shadow"

Material UserData

none user accessible methods (yet)

Material Table

 material = {
   ["order"  = number ,]
   ["culling" = number face ,]
   ["shader" = lua_shader | string "3do" | string "s3o" ,]
   ["texunits" = {
       [ [0] = { ["tex" = see gl.Texture ,]
                 ["enable" = boolean true ] }, ]
       [ [3] = see gl.Texture, ]
       (upto [15] and supports holes in it)
     } ,]
   ["texunit0" = see gl.Texture ,]
    ...
   ["texunit7" = see gl.Texture ,]
   ["prelist"   = lua_displaylist ,]
   ["postlist"  = lua_displaylist ,]
   ["usecamera" = boolean ,]
   ["cameraloc" = number uniformLocation,]
   ["cameraposloc" = number uniformLocation,]
   ["shadowloc"       = number uniformLocation,]
   ["shadowparamsloc" = number uniformLocation,]
 }