Revision Difference
render.SetLightmapTexture#524639
<function name="SetLightmapTexture" parent="render" type="libraryfunc">
<description>
Sets the texture to be used as the lightmap in upcoming rendering operations. This is required when rendering meshes using a material with a lightmapped shader such as LightmappedGeneric.
<rendercontext hook="false" type="3D"/>⤶
<rendercontext hook="false" type="2D"/>⤶
<rendercontext hook="false" type="3D"></rendercontext>⤶
<rendercontext hook="false" type="2D"></rendercontext>⤶
</description>
<realm>Client</realm>
<args>
<arg name="tex" type="ITexture">The texture to be used as the lightmap.</arg>
</args>
</function>
<example>
<description>Creates a mesh with LightmappedGeneric material on it</description>
<code>
-- LightmappedGeneric material that we'll use for our mesh
local meshMat = Material( "concrete/concretefloor001a" )
-- Mesh vertices (notice that it's not MeshVertex structure format, just something similar)
-- Notice that we have 2 UV coordinates channels, one for texture, one for lightmap
local meshVertices = {
{ pos = Vector( 0, 0, 0 ), u0 = 0, v0 = 0, u1 = 0, v1 = 0, n = Vector( 1, 0, 0 ) },
{ pos = Vector( 0, 100, 0 ), u0 = 1, v0 = 0, u1 = 3, v1 = 0, n = Vector( 1, 0, 0 ) },
{ pos = Vector( 0, 100, -100 ), u0 = 1, v0 = 1, u1 = 3, v1 = 3, n = Vector( 1, 0, 0 ) },
{ pos = Vector( 0, 0, -100 ), u0 = 0, v0 = 1, u1 = 0, v1 = 3, n = Vector( 1, 0, 0 ) },
}
-- Run this command while ingame to create the mesh at map origin
concommand.Add( "meshtest", function()
-- Creating a render target to be used as lightmap texture
meshLightmap = GetRenderTarget( "test_mesh_lightmap", 128, 128, false )
-- Filling the lightmap texture with some stuff for visualization
render.PushRenderTarget( meshLightmap )
cam.Start2D()
-- Resetting lightmap to be monotone gray
render.Clear( 128, 128, 128, 255 )
-- Drawing a dark rectangle
render.SetColorMaterial()
surface.SetDrawColor( 80, 80, 80, 255 )
surface.DrawRect( 32, 32, 64, 64 )
-- And some color text, why not! Lightmaps support RGB color
draw.SimpleText( "This is lightmap", "DermaDefault", 64, 64, Color( 255, 0, 0, 255 ), TEXT_ALIGN_CENTER, TEXT_ALIGN_CENTER )
cam.End2D()
render.PopRenderTarget()
-- Creating the mesh. Don't forget to pass the material you're gonna use with it!
-- Shader of the material defines some features of the mesh, vertex structure
-- specifically (LightmappedGeneric requires each vertex to store 2 UV channels,
-- for instance. This is important in this case)
myTestMesh = Mesh( meshMat )
-- Creating the mesh
mesh.Begin( myTestMesh, MATERIAL_QUADS, 1 )
for i, vertex in pairs( meshVertices ) do
mesh.Position( vertex.pos )
-- Texture coordinates go to channel 0
mesh.TexCoord( 0, vertex.u0, vertex.v0 )
-- Lightmap texture coordinates go to channel 1
mesh.TexCoord( 1, vertex.u1, vertex.v1 )
mesh.Normal( vertex.n )
mesh.AdvanceVertex()
end
mesh.End()
end )
hook.Add( "PostDrawOpaqueRenderables", "LightmappedMeshTest", function()
if myTestMesh and myTestMesh ~= NULL then
render.SetMaterial( meshMat )
render.SetLightmapTexture( meshLightmap )
myTestMesh:Draw()
end
end )
</code>
<output><image src="LightmappedGenericMeshPreview.jpeg" alt="512px|thumb"/></output>
</example>