# GLSL Programming/GLUT/Lighting of Bumpy Surfaces

This tutorial covers **normal mapping**.

It's the first of two tutorials about texturing techniques that go beyond two-dimensional surfaces (or layers of surfaces). In this tutorial, we start with normal mapping, which is a very well established technique to fake the lighting of small bumps and dents — even on coarse polygon meshes. The code of this tutorial is based on the tutorial on smooth specular highlights and the tutorial on textured spheres.

### Perceiving Shapes Based on Lighting[edit]

The painting by Caravaggio that is depicted to the left is about the incredulity of Saint Thomas, who did not believe in Christ's resurrection until he put his finger in Christ's side. The furrowed brows of the apostles not only symbolize this incredulity but clearly convey it by means of a common facial expression. However, why do we know that their foreheads are actually furrowed instead of being painted with some light and dark lines? After all, this is just a flat painting. In fact, viewers intuitively make the assumption that these are furrowed instead of painted brows — even though the painting itself allows for both interpretations. The lesson is: bumps on smooth surfaces can often be convincingly conveyed by the lighting alone without any other cues (shadows, occlusions, parallax effects, stereo, etc.).

### Normal Mapping[edit]

Normal mapping tries to convey bumps on smooth surfaces (i.e. coarse triangle meshes with interpolated normals) by changing the surface normal vectors according to some virtual bumps. When the lighting is computed with these modified normal vectors, viewers will often perceive the virtual bumps — even though a perfectly flat triangle has been rendered. The illusion can certainly break down (in particular at silhouettes) but in many cases it is very convincing.

More specifically, the normal vectors that represent the virtual bumps are first **encoded** in a texture image (i.e. a normal map). A fragment shader then looks up these vectors in the texture image and computes the lighting based on them. That's about it. The problem, of course, is the encoding of the normal vectors in a texture image. There are different possibilities and the fragment shader has to be adapted to the specific encoding that was used to generate the normal map.

### Normal Mapping[edit]

We will use the normal map to the left and write a GLSL shader to use it.

Normal maps can be tested and created with Blender (among others); see the description in the Blender 3D: Noob to Pro wikibook.

For this tutorial, you should use a cube mesh instead of the UV sphere that was used in the tutorial on textured spheres. Apart from that you can follow the same steps to assign a material and the texture image to the object. Note that you should specify a default **UV Map** in the **Properties window > Object Data tab**. Furthermore, you should specify **Coordinates > UV** in the **Properties window > Textures tab > Mapping**.

When decoding the normal information, it would be best to know how the data was encoded. However, there are not so many choices; thus, even if you don't know how the normal map was encoded, a bit of experimentation can often lead to sufficiently good results. First of all, the RGB components are numbers between 0 and 1; however, they usually represent coordinates between -1 and 1 in a local surface coordinate system (since the vector is normalized, none of the coordinates can be greater than +1 or less than -1). Thus, the mapping from RGB components to coordinates of the normal vector **n** could be:

, , and

However, the coordinate is usually positive (because surface normals are not allowed to point inwards). This can be exploited by using a different mapping for :

, , and

If in doubt, the latter decoding should be chosen because it will never generate surface normals that point inwards. Furthermore, it is often necessary to normalize the resulting vector.

An implementation in a fragment shader that computes the normalized vector **n** in the variable `localCoords`

could be:

vec4 encodedNormal = texture2D(normalmap, texCoords); vec3 localCoords = 2.0 * encodedNormal.rgb - vec3(1.0);

Usually, a local surface coordinate systems for each point of the surface is used to specify normal vectors in the normal map. The axis of this local coordinates system is given by the smooth, interpolated normal vector **N** and the plane is a tangent plane to the surface as illustrated in the image to the left. Specifically, the axis is specified by the tangent attribute **T** that the 3D engine provides to vertices. Given the and axis, the axis can be computed by a cross product in the vertex shader, e.g. **B** = **T** × **N**. (The letter **B** refers to the traditional name “binormal” for this vector.)

Note that the normal vector **N** is transformed with the transpose of the inverse model-view matrix from object space to view space (because it is orthogonal to a surface; see “Applying Matrix Transformations”) while the tangent vector **T** specifies a direction between points on a surface and is therefore transformed with the model-view matrix. The binormal vector **B** represents a third class of vectors which are transformed differently. (If you really want to know: the skew-symmetric matrix B corresponding to “**B**×” is transformed like a quadratic form.) Thus, the best choice is to first transform **N** and **T** to view space, and then to compute **B** in view space using the cross product of the transformed vectors.

Also note that the configuration of these axes depends on the tangent data that is provided, the encoding of the normal map, and the texture coordinates. However, the axes are practically always orthogonal and a bluish tint of the normal map indicates that the blue component is in the direction of the interpolated normal vector.

With the normalized directions **T**, **B**, and **N** in view space, we can easily form a matrix that maps any normal vector **n** of the normal map from the local surface coordinate system to view space because the columns of such a matrix are just the vectors of the axes; thus, the 3×3 matrix for the mapping of **n** to view space is:

These calculations are performed by the vertex shader, for example this way:

attribute vec3 v_tangent; varying mat3 localSurface2View; // mapping from // local surface coordinates to view coordinates varying vec4 texCoords; // texture coordinates varying vec4 position; // position in view coordinates void main() { mat4 mvp = p*v*m; position = m * v_coord; // the signs and whether tangent is in localSurface2View[1] or // localSurface2View[0] depends on the tangent attribute, texture // coordinates, and the encoding of the normal map localSurface2World[0] = normalize(vec3(m * vec4(v_tangent, 0.0))); localSurface2World[2] = normalize(m_3x3_inv_transp * v_normal); localSurface2World[1] = normalize(cross(localSurface2World[2], localSurface2World[0])); varyingNormal = normalize(m_3x3_inv_transp * v_normal); texCoords = v_texcoords; gl_Position = mvp * v_coord; }

In the fragment shader, we multiply this matrix with **n** (i.e. `localCoords`

). For example, with this line:

vec3 normalDirection = normalize(localSurface2World * localCoords);

With the new normal vector in view space, we can compute the lighting as in the tutorial on smooth specular highlights.

### Complete Shader Code[edit]

The complete fragment shader simply integrates all the snippets and the per-pixel lighting from the tutorial on smooth specular highlights.

attribute vec4 v_coord; attribute vec3 v_normal; attribute vec2 v_texcoords; attribute vec3 v_tangent; uniform mat4 m, v, p; uniform mat3 m_3x3_inv_transp; varying vec4 position; // position of the vertex (and fragment) in world space varying vec2 texCoords; varying mat3 localSurface2World; // mapping from local surface coordinates to world coordinates void main() { mat4 mvp = p*v*m; position = m * v_coord; // the signs and whether tangent is in localSurface2View[1] or // localSurface2View[0] depends on the tangent attribute, texture // coordinates, and the encoding of the normal map localSurface2World[0] = normalize(vec3(m * vec4(v_tangent, 0.0))); localSurface2World[2] = normalize(m_3x3_inv_transp * v_normal); localSurface2World[1] = normalize(cross(localSurface2World[2], localSurface2World[0])); texCoords = v_texcoords; gl_Position = mvp * v_coord; }

uniform mat4 m, v, p; uniform mat4 v_inv; uniform sampler2D normalmap; varying vec4 position; // position of the vertex (and fragment) in world space varying vec2 texCoords; // the texture coordinates varying mat3 localSurface2World; // mapping from local surface coordinates to world coordinates struct lightSource { vec4 position; vec4 diffuse; vec4 specular; float constantAttenuation, linearAttenuation, quadraticAttenuation; float spotCutoff, spotExponent; vec3 spotDirection; }; lightSource light0 = lightSource( vec4(0.0, 2.0, -1.0, 1.0), vec4(1.0, 1.0, 1.0, 1.0), vec4(1.0, 1.0, 1.0, 1.0), 0.0, 1.0, 0.0, 180.0, 0.0, vec3(0.0, 0.0, 0.0) ); vec4 scene_ambient = vec4(0.2, 0.2, 0.2, 1.0); struct material { vec4 ambient; vec4 diffuse; vec4 specular; float shininess; }; material frontMaterial = material( vec4(0.2, 0.2, 0.2, 1.0), vec4(0.920, 0.471, 0.439, 1.0), vec4(0.870, 0.801, 0.756, 0.5), 50.0 ); void main() { vec4 encodedNormal = texture2D(normalmap, texCoords); vec3 localCoords = 2.0 * encodedNormal.rgb - vec3(1.0); vec3 normalDirection = normalize(localSurface2World * localCoords); vec3 viewDirection = normalize(vec3(v_inv * vec4(0.0, 0.0, 0.0, 1.0) - position)); vec3 lightDirection; float attenuation; if (0.0 == light0.position.w) // directional light? { attenuation = 1.0; // no attenuation lightDirection = normalize(vec3(light0.position)); } else // point light or spotlight (or other kind of light) { vec3 positionToLightSource = vec3(light0.position - position); float distance = length(positionToLightSource); lightDirection = normalize(positionToLightSource); attenuation = 1.0 / (light0.constantAttenuation + light0.linearAttenuation * distance + light0.quadraticAttenuation * distance * distance); if (light0.spotCutoff <= 90.0) // spotlight? { float clampedCosine = max(0.0, dot(-lightDirection, light0.spotDirection)); if (clampedCosine < cos(radians(light0.spotCutoff))) // outside of spotlight cone? { attenuation = 0.0; } else { attenuation = attenuation * pow(clampedCosine, light0.spotExponent); } } } vec3 ambientLighting = vec3(scene_ambient) * vec3(frontMaterial.ambient); vec3 diffuseReflection = attenuation * vec3(light0.diffuse) * vec3(frontMaterial.diffuse) * max(0.0, dot(normalDirection, lightDirection)); vec3 specularReflection; if (dot(normalDirection, lightDirection) < 0.0) // light source on the wrong side? { specularReflection = vec3(0.0, 0.0, 0.0); // no specular reflection } else // light source on the right side { specularReflection = attenuation * vec3(light0.specular) * vec3(frontMaterial.specular) * pow(max(0.0, dot(reflect(-lightDirection, normalDirection), viewDirection)), frontMaterial.shininess); } gl_FragColor = vec4(ambientLighting + diffuseReflection + specularReflection, 1.0); }

### Summary[edit]

Congratulations! You finished this tutorial! We have looked at:

- How human perception of shapes often relies on lighting.
- What normal mapping is.
- How to decode common normal maps.
- How a fragment shader can decode a normal map and use it for per-pixel lighting.

### Further Reading[edit]

If you still want to know more

- about texture mapping (including tiling and offseting), you should read the tutorial on textured spheres.
- about per-pixel lighting with the Phong reflection model, you should read the tutorial on smooth specular highlights.
- about transforming normal vectors, you should read “Applying Matrix Transformations”.
- about normal mapping, you could read Mark J. Kilgard: “A Practical and Robust Bump-mapping Technique for Today’s GPUs”, GDC 2000: Advanced OpenGL Game Development, which is available online.

Back to OpenGL Programming - Lighting section |
Back to GLSL Programming - GLUT section |