Wrinkle Maps

From Valve Developer Community
Jump to navigation Jump to search
English (en)Translate (Translate)
Wrinkle maps add fine detail to the forehead.

Wrinkle maps are a component of DMX flex shapes used by the VertexLitGeneric shader to make per-vertex texture changes when the flex shape is applied. They were introduced in Source 2007 Source 2007.

They are typically used to add fine wrinkling detail to a character's skin.

The term "wrinkle map" is confusing, because it can refer to the act of adding or removing wrinkles. The terms "compress" and "stretch" are used to refer to these two effects.

Warning.pngWarning:HLMV++ HLMV++ (at least the L4D2 version) often times does not show wrinkle maps on custom models, while the default HLMV HLMV does show them just fine.

Generation

Wrinkle maps are generated programmatically before a model is compiled. The important value is the wrinkle "scale," which defines the upper limit of wrinkling. A scale of 1 means that only the vert which moves the furthest is fully wrinkled; a scale of 2 means that the top 50% of moving verts are fully wrinkled.

  • Positive wrinkle scales lead to the compress texture being applied.
  • Negative wrinkle scales lead to the stretch texture being applied.

It isn't possible for a single shape to both stretch and compress; if that effect is needed, make a flex controller which wraps multiple shapes.

dmxedit

The official SDK tool for creating wrinkle maps is dmxedit. It is run on an exported DMX using a simple Lua script like this:

Load("C:/heavy_morphs_high.dmx")

SetWrinkleScale("BrowInV", "WrinkleNose", -0.5) -- controller name, shape name, scale
SetWrinkleScale("BrowInV", "RaiseBrowIn", 2)
-- etc.

ComputeWrinkles()

Save("C:/heavy_morphs_high.dmx")

If you are using Source Filmmaker Source Filmmaker, you will find a collection of helper files at SourceFilmmaker\game\sdktools\lua\. These can be used to set up your model in the same way as Valve's.

Blender Blender Source Tools

The Blender Source Tools can generate wrinkle maps when exporting your model. Enable Advanced flex mode, generate a flex controller block, and set a non-zero wrinkleScales value in the relevant flex controller definitions.

Wall Worm Model Tools

Wall Worm Model Tools can now export wrinkle maps. Simply add a Vertex Paint Modifier to any morph target and name it "wrinkle." Paint the wrinkle weights into that vertex paint. Black is full compress. White is full stretch. Gray is no stretch or compress.

You can find the docs and a tutorial on doing wrinklemaps in 3ds Max here.

Materials and Textures

A $compress texture from Left 4 Dead 2 Left 4 Dead 2.

Implementing wrinkle maps requires a VertexLitGeneric material with $phong enabled.

There are four shader parameters involved:

Textures which are applied when a flex controller compresses or stretches the mesh.
Optional bump map textures for $compress and $stretch.