UnlitTwoTexture

• Two base textures are multiplied together and can be transformed independently. (Just like the Multiply blending mode in typical image editors.)
• Unrelated to WorldVertexTransition, which is used for making alpha fading transitions between two base textures on displacements.
  

Note:This Shader works on both Brushes and Models

Confirm: Do models require $model in branches before ?

Tip:The same effect can be created using $detailblendmode 8 on UnlitGeneric.

Parameters

$basetexture <texture>

Todo: This material shader parameter has not been described.

The first Texture that is used, how it is used depends on the effects which are enabled. By default $basetexture will be multiplied with $texture2.

$frame <integer>

The frame to start an animated $texture2 on.

$basetexturetransform <matrix>

Transforms the texture before use in the material.

The default position is center .5 .5 scale 1 1 rotate 0 translate 0 0.

1. center defines the point of rotation. Only useful if rotate is being used.
2. scale fits the texture into the material the given number of times. 2 1 is a 50% scale in the horizontal X axis while the vertical Y axis is still at original scale.
3. rotate rotates the texture counter-clockwise in degrees. Accepts any number, including negatives.
4. translate shifts the texture by the given numbers. .5 will shift it half-way. 1 will shift it once completely over, which is the same as not moving it at all.

Note:All values must be included!

Bug:Scaling the texture may cause odd issues where the Texture Lock tool in Hammer will not actually lock the texture in place.  [todo tested in ?]

Bug:Rotating textures applied on brushes will rotate around the map origin (confirm: Orangebox engine only?). A fix for this is to change the center position in the VMT to the brush's origin.  [todo tested in ?]

$texture2 <texture>

Todo: This material shader parameter has not been described.

Second Texture that is used in different ways depending on which effects are used. By default $basetexture will be multiplied with $texture2.

Note:First texture is applied via $basetexture.

$frame2 <integer>

The frame to start an animated $texture2 on.

$texture2transform <matrix>

Transforms the texture before use in the material.

The default position is center .5 .5 scale 1 1 rotate 0 translate 0 0.

1. center defines the point of rotation. Only useful if rotate is being used.
2. scale fits the texture into the material the given number of times. 2 1 is a 50% scale in the horizontal X axis while the vertical Y axis is still at original scale.
3. rotate rotates the texture counter-clockwise in degrees. Accepts any number, including negatives.
4. translate shifts the texture by the given numbers. .5 will shift it half-way. 1 will shift it once completely over, which is the same as not moving it at all.

Note:All values must be included!

Bug:Scaling the texture may cause odd issues where the Texture Lock tool in Hammer will not actually lock the texture in place.  [todo tested in ?]

Bug:Rotating textures applied on brushes will rotate around the map origin (confirm: Orangebox engine only?). A fix for this is to change the center position in the VMT to the brush's origin.  [todo tested in ?]

$color <RGB matrix>

tints the result, on brushes.

$color2 <RGB matrix>

tints the result, on models.

$beachfoam <boolean> (only in )

Introduced with Dangerzone, adds animated wave-like effects using a special texture

Important:This parameter is intended to be used with $additive.

On the Dangerzone Wave Model, both $texture2 and $basetexture use the 'Beachwaves' Texture.

Todo: Do both Parameters need to use the same Texture?

The 'Beachwaves' Texture uses the RGB channels for different purposes.

Todo: Find a better Name for the Texture...

• Red Channel : Waves Albedo Texture

Todo: Can this be tinted using $color/$color2?

• Green Channel : Distortion/Noise for the Red Channel
• Blue Channel : Distortion/Noise for the Red Channel

Todo: Further documentation required.

$CrosshairMode <boolean> (only in )

Enables "Crosshair mode" using $basetexture for the Crosshair

$texture2 is used for a framebuffer texture.

The result will be blended between Crosshair Texture + CrosshairTint and Crosshair Texture * CrosshairTint using Average Luminance of $texture2 * $CrosshairColorAdapt

$CrosshairTint <RGB matrix> (only in )

Tints the $basetexture when using $CrosshairMode

$CrosshairColorAdapt <float> (only in )

Used for multiplying the average Luminance of $texture2

Note:Default Value "0.4"

$translucent <boolean> (in all games since )

$translucent is a expensive translucency using a full Alpha mask, for very fine gradients. Uses $basetexture as the source alpha, and blends $texture2's alpha over whatever is opaque.

Example

The following are some stock VMTs from various games:

models/props_combine/portalball001_sheet.vmt

"UnlitTwoTexture"
{
	"$basetexture" "models/props_combine/portalball001_sheet"
	"$texture2" "models/props_combine/portalball001b_sheet"
 	"$model" 1
	"$nocull" "1"
	"$additive" "1"
	"Proxies"
	{

		"TextureScroll"
		{
			"texturescrollvar" "$texture2transform"
			"texturescrollrate" -.2
			"texturescrollangle" 60
		}
	}

}

liquids/!greenslime.vmt

"UnlitTwoTexture"
{
	"$basetexture"	"liquids/toxic_anim"
//	"$texture2"	"liquids/toxic_anim"
	"$texture2" 	"liquids/!radio"	
	"$texture2scale" 1
//	"$additive" 1

	"$tex2offset"	"[0 0]"
	"%compilewater" 1

	"$bottommaterial" "liquids/!greenslime_beneath"

	"$surfaceprop" "water"
	"$fogenable" 1
	"$fogcolor" "{96 255 0}"
	"$fogstart" 1.00
	"$fogend" 400.00

	"Proxies"
	{
		"LinearRamp"
		{
			"resultVar" "$tex2offset[0]"
			"rate" 0.001
		}
		"LinearRamp"
		{
			"resultVar" "$tex2offset[1]"
			"rate" -0.01
		}
		"TextureTransform"
		{
			"translateVar"	"$tex2offset"
			"resultVar"	"$texture2transform"
		}
		"AnimatedTexture"
		{
			"animatedtexturevar" "$basetexture"
			"animatedtextureframenumvar" "$frame"
			"animatedtextureframerate" 12
		}
	}
}

models/props/hr_massive/beachwaves/beachwaves.vmt

UnlitTwoTexture
{
    "$beachfoam"   "1"
    "$basetexture" "models/props/hr_massive/beachwaves/beachwaves"
    "$texture2"    "models/props/hr_massive/beachwaves/beachwaves"
    "$additive"    "1"
}

effects/smoke_plumes_anim.vmt

UnLitTwoTexture
{
"%tooltexture" "effects/smoke_plumes_00"
$basetexture "effects/smoke_plumes_scroll"
$texture2 "effects/smoke_plumes_00"

$translucent 1

$nocull 1
$no_fullbright 1
$nofog 1
$scale "[1 1]"
$scroll "[2 2]"
Proxies
{
LinearRamp
{
resultVar "$scroll[0]"
rate -.01
}
LinearRamp
{
resultVar "$scroll[1]"
rate .035
}
TextureTransform
{
scaleVar $scale
translateVar $scroll
resultVar $basetexturetransform
}
}
}

See also

• LightmappedTwoTexture