Garry's Mod Wiki

Home / History for render.SetBlend

Revision Difference

render.SetBlend#561680

<function name="SetBlend" parent="render" type="libraryfunc"> <description> Sets the alpha blending for every upcoming render operation. ⤶ <bug issue="3166">This does not affect non-model `render.Draw*` functions.</bug>⤶ Sets the alpha blending (or transparency) for upcoming render operations. ⤶ By itself, this will cause visible overlapping on parts of a model that are in front of other parts of the same model. ⤶ For a solution to this, see the examples below.⤶ ⤶ <bug issue="3166">This does not affect non-model `render.Draw*` functions.</bug>⤶ </description> <realm>Client</realm> <args> <arg name="blending" type="number">Blending value from `0-1`.</arg>⤶ <arg name="blending" type="number">⤶ The alpha (transparency) for upcoming draw operations. ⤶ A value in the range `(0-1)` where `0` is fully transparent, `0.5` is 50% visible, and `1` is fully opaque.⤶ </arg>⤶ </args> </function> ⤶ <example>⤶ <description>Creating custom client side blending for ghosts that do not support color alpha channel.</description>⤶ ⤶ <example name="Basic Usage (With overlaps)">⤶ <description>⤶ This example demonstrates the basic usage of <page>render.SetBlend</page> and the overlapping effect mentioned above.⤶ </description>⤶ <code>⤶ -- Draw at a 75% opacity, so it's mostly opaque.⤶ render.SetBlend( 0.75 )⤶ ⤶ -- Draw the model using the blend we just set.⤶ self:DrawModel()⤶ ⤶ -- Draw at a normal opacity again.⤶ render.SetBlend( 1 )⤶ </code>⤶ <output>⤶ <image src="b2b4c/8dc575936095ba3.png" size="436279" name="WithoutDepthExample.png" />⤶ </output>⤶ </example>⤶ ⤶ <example name="Avoiding Overlap Issues">⤶ <description>⤶ This example demonstrates how the overlapping effect can be avoided with the use of <page>render.OverrideColorWriteEnable</page>⤶ </description>⤶ <code> local function BlendGhost(self)⤶ local num = render.GetBlend() ⤶ render.SetBlend(0.8) self:DrawModel()⤶ render.SetBlend(num) end⤶ ⤶ local function MakeGhost(model, pos, ang) local ghost = ents.CreateClientProp(model) if (not IsValid(ghost)) then return end⤶ ⤶ ghost.RenderOverride = BlendGhost⤶ ghost:SetPos(pos)⤶ ghost:SetAngles(ang) ghost:PhysicsDestroy() ghost:SetNoDraw(true) ghost:SetNotSolid(true) ghost:DrawShadow(false) ghost:SetSolid(SOLID_NONE) ghost:SetMoveType(MOVETYPE_NONE) ghost:SetCollisionGroup(COLLISION_GROUP_NONE)⤶ ghost:SetRenderMode(RENDERMODE_TRANSALPHA)⤶ ghost:SetColor(color_white)⤶ ghost:Spawn()⤶ ⤶ return ghost⤶ end⤶ -- Prevent drawing to the Color Channel of the currently active Render Target so⤶ -- that when we draw the model, it only sets the Depth Buffer values. render.OverrideColorWriteEnable( true, false ) ⤶ -- Draw the model to set the Depth Buffer values⤶ self:DrawModel() ⤶ -- Start drawing normally again⤶ render.OverrideColorWriteEnable( false, false ) ⤶ -- Draw at a 75% opacity, so it's mostly opaque. render.SetBlend( 0.75 )⤶ ⤶ -- Draw the model using the blend we just set.⤶ -- Because we previously set the Depth Buffer values by drawing the model, and⤶ -- because pixels are only drawn when the pixel's current Depth Buffer value is -- less-than or equal-to the draw operation's new Depth value, only the parts of -- the model that are closest to the player's view will be drawn. -- This will prevent the overlapping that normally happens. self:DrawModel() ⤶ -- Draw at a normal opacity again. render.SetBlend( 1 ) </code> <output>⤶ <image src="b2b4c/8dc57594556b659.png" size="431723" name="WithDepthExample.png" />⤶ </output>⤶ </example>

Account Management

Special Pages

Wiki List