List of material proxies

Proxy list

The following proxies are defined in the client DLL for use in any Source game.

Proxy Name	Description	Variables
Add	Adds two variables together.	srcVar1 Name of the first source variable. srcVar2 Name of the second source variable. resultVar ( srcVar1 + srcVar2)
Multiply	Multiplies two variables together.	srcVar1 Name of the first source variable. srcVar2 Name of the second source variable. resultVar ( srcVar1 * srcVar2)
Subtract	Subtracts the second variable from the first.	srcVar1 Name of the first source variable. srcVar2 Name of the second source variable. resultVar ( srcVar1 - srcVar2)
Divide	Divides the first variable by the second.	srcVar1 Name of the first source variable. srcVar2 Name of the second source variable. resultVar ( srcVar1 / srcVar2)
Equals	Copies a variable to the result variable.	srcVar1 Name of the source variable. resultVar Set equal to srcVar1
Abs	Computes the absolute value of a variable.	srcVar1 Name of the source variable. resultVar abs( srcVar1)
Frac	Returns the fractional component of a number. Note:If a vector type variable is provided, this function will return the fractional component of each member of the array.	srcVar1 Number to find the fractional component of
Exponential	Computes ( A * e (srcVar1+B) ).	srcVar1 Name of the source variable. scale Specifies the value of A offset Specifies the value of B minVal Minimum clamping value maxVal Maximum clamping value resultVar ( A * e (srcVar1+B) )
Clamp	Clamps a variable to a specified range of values.	srcVar1 Name of the source variable. min Minimum clamping value max Maximum clamping value resultVar clamp( srcVar1, Min, Max )
LessOrEqual	Returns different values based relation of supplied variables.	srcVar1 Name of the first source variable. srcVar1 Name of the second source variable. lessEqualVar Name of material variable to copy to result if (srcVar1 <= srcVar2) greaterVar Name of material var to copy to result if (srcVar1 > srcVar2) resultVar Resulting value
Sine	Creates a sine wave.	sineperiod Period of the sine wave in seconds. sinemin Minimum value of the sine wave. sinemax Maximum value of the sine wave. timeoffset Used to start the sine wave at a different point in time resultVar Resulting value.
LinearRamp	Produces an ever increasing value.	rate Rate of increase of the value. initialValue Initial value to increase. resultVar Resulting value.
UniformNoise	Produces a noisy signal where each value is equally likely to occur	minVal Minimum value range. maxVal Maximum value range. resultVar Resulting value.
GaussianNoise	Produces a noisy signal where values are near the average.	mean The average random value. halfWidth The distance from the average at which it's only 30% likely to occur. minVal Minimum value range (clamped). maxVal Maximum value range (clamped). resultVar Resulting value.
MatrixRotate	Creates a rotation matrix from the provided axis and angle.	axisVar Axis of rotation (x,y,z) = (0,1,2). angle Degrees of rotation around axis. resultVar Rotation matrix.
PlayerProximity	Stores the distance from the entity the material is on to the player into a variable. Note:Does not work on world surfaces.	scale An amount to scale the distance by. resultVar Resulting value.
PlayerView	Stores the dot product of the view direction + the direction from the camera to the entity the material is on. Note:Does not work on world surfaces.	scale Amount to scale the dot product by. resultVar Resulting value.
PlayerSpeed	Stores the speed of the player into a variable.	scale Amount to scale the speed by. resultVar Resulting value.
PlayerPosition	Stores the player's position into a variable. Note:Only works for vector variables like $baseTextureOffset or $color.	scale An amount to scale the position by. resultVar Resulting value.
EntitySpeed	Stores the entity's speed into a variable. Note:Does not work on world surfaces.	scale An amount to scale the speed by. resultVar Resulting value.
TextureTransform	Generates a texture transform matrix.	centerVar Name of a variable holding the center of rotation and scaling. [Optional] scaleVar Name of scale variable (2D vector). [Optional] rotateVar Name of rotation angle variable (float). [Optional] translateVar Name of the translation variable (2D vector). resultVar Resulting value.
Empty	Used to comment out proxies. Surround a bunch of proxies with the empty proxy to cause those proxies to not operate.
TextureScroll	Returns a transform matrix or vector that will translate a texture at a given angle at a given rate.	textureScrollVar Destination for the resulting transformation. textureScrollRate Rate of scroll in units per second. textureScrollAngle Angle of rotation to move along. (90 = right, 180 = left, etc)
ToggleTexture	Toggles a texture based on the frame number set by the attached entity. Note:Must be attached to an entity.	toggleTextureVar Texture to modify based on frames. toggleTextureFrameNumVar Variable used for frame number. toggleShouldWrap Whether the animation should wrap over not.
EntityRandom	A proxy that returns a random number associated with the entity the material is applied to. Can be helpful for making animated textures not all be in sync.	scale Amount to scale the random number by. resultVar Resulting value.
CurrentTime	Returns the current time as a float.	resultVar The current time.
PlayerHealth	Stores the player health (0-1) in a variable.	scale Amount to scale the health value by. resultVar Resulting value.
PlayerDamageTime	Stores the time since the player was last damaged, in a variable.	scale Amount to scale the time by. resultVar Resulting value.
MaterialModify	Sets the base texture to a value held by the entity (used for entity controlled texture animations). Note:Only works when attached to an entity.	No return value.
WaterLOD	Coordinates water LOD values between the map's env_waterlod entity and the materials internal values.	$CHEAPWATERSTARTDISTANCE Start distance for cheap water Note:must be set outside of proxy block. $CHEAPWATERENDDISTANCE End distance for cheap water Note:must be set outside of proxy block. No return value.
BreakableSurface	Sets the base texture to a material name held by the entity (used for switching surface material on shatter) Note:Must be attached to a func_breakablesurface entity.	No return value.
ConveyorScroll	Returns the scroll parameters for a texture used as a conveyor. Note:Must be attached to func_conveyor entity.	textureScrollVar Name of variable to place result in. Note:must be a matrix or vector type variable (i.e. $baseTextureOffset).
LampBeam	Modulates the material's alpha value based on angle between the beam's direction and the viewer's eye point. This is used to make the beams of volumetric light on lights fade as you look at them dead on. Note:Must be attached to entity for angle use.	No return value.
LampHalo	Modulates the material's alpha value based on angle between the beam's direction and the viewer's eye point. Like the LampBeam proxy, but used for the halo at the beam's base. Note:Must be attached to entity for angle use.	No return value.
AnimatedTexture	Increments frame variable	animatedtexturevar Texture to increment frame for (i.e. $basetexture, $bumpmap, $normalmap (both $bumpmap and $normalmap use $bumpframe)) animatedtextureframenumvar Frame variable to increment (i.e. $frame, $bumpframe) animatedtextureframerate Framerate in frames per second
Camo	Note:Only used by material "Dev\dev_camo.vmt".	camopatterntexture camoboundingboxmin camoboundingboxmax surfaceprop
HeliBlade
ParticleSphereProxy	Note:Only used by material "particle\SmokeStack.vmt". Seems to be defined in particle_proxies.cpp. Valve remark: "FIXME: Is this even needed any more?"	No known parameters.
Shadow	Note:Only used by material "Decals\rendershadow.vmt".	No known parameters.
ShadowModel	Note:Only used by material "Decals\rendermodelshadow.vmt".	No known parameters.

See also

• Material Proxies
• Material Creation