Revision Difference
render.DepthRange#528614
<function name="DepthRange" parent="render" type="libraryfunc">
<description>Set's the depth range of the upcoming render.</description>
<realm>Client</realm>
<args>
<arg name="depthmin" type="number">The minimum depth of the upcoming render. `0.0` = render normally; `1.0` = render nothing.</arg>
<arg name="depthmax" type="number">The maximum depth of the upcoming render. `0.0` = render everything (through walls); `1.0` = render normally.</arg>
</args>
</function>
<example>
<description>Perform a downward screen wipe effect on all opaque objects once the client connects.</description>
<code>
local depthmin = 1.0
hook.Add( "PreDrawOpaqueRenderables", "simple_effect", function( bDrawingDepth, bDrawingSkybox )
render.DepthRange( depthmin, 1.0 )
if ( depthmin > 0.0 ) then
depthmin = depthmin - 0.001
end
end )
</code>
</example>
<example>
<description>Same effect as above but with a dark shadow skin present where the model is being drawn.</description>
<code>
local depthmin = 1.0
local spawn_copies = {} -- The shadow copies
local custom_white_color = Color( 255, 255, 255, 92 )
hook.Add( "PreDrawOpaqueRenderables", "advanced_effect", function( bDrawingDepth, bDrawingSkybox )
render.DepthRange( depthmin, 1.0 )
if ( !spawn_copies ) then return false end
if ( depthmin > 0.0 ) then
depthmin = depthmin - 0.001
else
local alpha = 0
local valid_copies = 0
-- Fade out the shadow copies and remove them.
for _, spawncopy in ipairs(spawn_copies) do
if ( IsValid( spawncopy ) ) then
alpha = spawncopy:GetColor().a
if ( alpha > 0 ) then
spawncopy:SetColor( Color( 255, 255, 255, alpha - 1 ) )
else
spawncopy:Remove()
end
valid_copies = valid_copies + 1
end
end
-- Nullify table since we aren't using it anymore.
if ( valid_copies == 0 ) then
spawn_copies = nil
end
end
end )
hook.Add( "OnEntityCreated", "advanced_effect", function( ent )
if ( !spawn_copies ) then return end
-- Prevents infinite loop and other errors.
if ( ent:GetClass() ~= "class C_BaseFlex" and
ent:GetRenderGroup() == RENDERGROUP_OPAQUE and
ent:GetClass() ~= "gmod_hands" ) then
local mdl = ent:GetModel()
-- Check that the entity is a model and not a brush.
if ( string.EndsWith( mdl, ".mdl" ) ) then
local spawncopy = ClientsideModel( mdl )
-- A material with $ignorez set to 1 works best here.
spawncopy:SetMaterial( "models/overlay_rendertarget" )
spawncopy:AddEffects( EF_BONEMERGE )
spawncopy:SetParent( ent )
spawncopy:SetRenderMode( RENDERMODE_TRANSALPHA )
spawncopy:SetColor( custom_white_color )
table.insert( spawn_copies, spawncopy )
end
end
end )
</code>
<output><upload src="DepthRange_example.webm" name="Example" /></output>
<output><upload src="DepthRange_example.webm" name="DepthRange_example.webm" /></output>
</example>