This article's documentation is for anything that uses the Source engine. Click here for more information.

$additive

From Valve Developer Community
Jump to navigation Jump to search
English (en)Translate (Translate)
A world brush with additive material applied.
A model with additive material. Note that, when used as a prop_static, VRAD still creates a shadow for it, not accounting for $additive.

$additive is a material shader parameter available in all Source Source games. It specifies that the material should be rendered additively; that is, its colour values will be added to underlying pixels. This means, among other things, that the material will always brighten the world behind it. This is useful for effects like volumetric dust, light sprites, etc.

Note.pngNote:Additive blending is a form of transparency, and solids with $additive materials on them cannot be used to seal the map.

VMT Syntax Example

$additive <bool>
LightmappedGeneric
{
	$basetexture glass\window001a
	$additive 1
}

The amount of brightening depends on the brightness of the $basetexture. A fully black texture will become invisible, however, other texture effects (such as $detail, $emissiveblend, $envmap) can still be drawn (not implicitly additively).

This does work together with $color and $color2, allowing to control the strength of the additive blending, and change it with Proxies.

$additive is supported by most shaders, and does not require the texture to have an alpha channel. It also doesn't share the numerous caveats of $translucent and $alphatest, such as being mutually exclusive with $selfillum, or other shader parameters that make use of the alpha channel, for that matter.

Caveats

Flickering and reversed depth

Additive blending suffers from similar alpha sorting issues as regular alpha blended translucency ($translucent, $alpha, etc.). Unlike regular alpha blending, however, additive-blended surfaces will always blend correctly with other additive-blended surfaces.

Texture shadows

VRAD creates textures shadows for static props exclusively using the alpha channel of the $basetexture of materials containing $translucent and $alphatest. As additive blending doesn't use the alpha channel, VRAD will treat additive-blended surfaces as being opaque. As a workaround, either create a alpha channel and add $translucent ($additive will be prioritized in-game) or use the noshadow RAD file command.

See also