Creating LOD Models

From The DarkMod Wiki
Jump to: navigation, search


TDM from v1.03 onwards has a LOD system, where the engine can replace models that are far away with simpler versions. The same technique can also be applied manually, by placing decals at some distance to create the illusion of more details.

This article details how to create models that can be used for such purposes and what the performance gains are.

The tutorial assumes you use Gimp, but a similiar technique will work with Photoshop or any other image editing program.

Creating the model


Start with a suitable model

Select a model that:

  • has sufficiently high number of polys (anything > 100) OR has a many surfaces (> 2)
  • will be used in places that will be both far away and near the player in one mission
  • Is compact and possible symmetric from all sides

I started with the cattails4.low model as example, as I am using it in a map of my own.

Create screenshots from DR

Cattails green 4 with patch.png

I put the model into a map (see at the bottom for an archive with pre-made maps with black rooms), removing everything that was visible behind it.

Then either:

  • just use the grey background from the DR camera window if your model doesn't contain this sort of grey
  • OR then create a simple patch mesh behind it, and texture it with textures/sfx/white or textures/darkmod/sfx/black_matt. When you select this patch in DR, it gives a nice uniform brown color, or you can use the black version. Use the version where the background clashes the least with your model's colors.

The idea here is that which we can later separate the background from the model itself in Gimp easily be just selecting the background color.


  • Draw the camera view from DR as big as possible to capture the highest quality possible.
  • Use the "View => Camera => Center" option from the DR menu (or use END) to level the camera after moving it at the center line of the model.
  • If you use a patch, make sure you put the patch completely behind the model.
  • If your model has skins, it is best to switch skins and make one screenshot for each skin without adjusting the camera. This way all the skin screenshots will align perfectly without any extra work, and you only need to position the camera once for each shot.

Then I used the screen capture program from KDE to create screenshots and open them up in Gimp. One shot from the front, one from the side. Try to align the camera as level and at the center of the model as possible. The exact alignment isn't nec, but it simplifies things somewhat.


  • The KDE screenshot applet has a handy "Open with ... Gimp" button for this so you can take all screenshots and load them in Gimp without saving them first to disk).
  • If you model is somewhat symmetric, a front and side view are enough. If it looks too different from the front and back, f.i., you might also want to crate a back-side and a back view.

The texture

We now work in Gimp:

  1. Cut out the model, the size does not matter yet:
  2. Select "Select by similiar colors" and click on the brown or grey background, then fill the selection with black:
  3. Now "Resize the canvas". That means you change the dimensions of the image, but don't scale it! Select as a size that fits closely (but not pixel-perfect), and is either square, or in my case 2:1 or 1:2.
  4. Add a mask to the current layer.
  5. You should end up with a view like this.
  6. Now scale the image so it is a power of 2. Don't go higher than 512, as this is a texture for a model far away. Even 256 pixels might be sufficient.

Done for now in Gimp.

Step 1   Step 2   Step 2   Step 3   Step 4   Step 5   Step 6

Decal atlas.png

Note: To avoid having to redo some steps, create both views (side and front) in the same texture. This is called a "texture-atlas" and improves performance, see the section about Optimizing for more info:

The material definition

Create a material definition, here is an example:

    qer_editorimage textures/darkmod/decals/vegetation/cattail_flat_side
    description "foliage"

    // twosided  // See later section about optimizing!

        blend diffusemap
        map textures/darkmod/decals/vegetation/cattail_flat_side
        alphatest 0.5

    // TDM Ambient Method Related
        if (global5 == 1)
        blend add
        map             textures/darkmod/decals/vegetation/cattail_flat_side
        scale           1, 1
        red         global2
        green           global3
        blue            global4

Note: This section:

        if (global5 == 2)
        blend add
        program ambientEnvironment.vfp
        vertexParm      0       1, 1, 1, 1      // UV Scales for Diffuse and Bump
        vertexParm      1       1, 1, 1, 1  // (X,Y) UV Scale for specular, Z: ambient reflection scale
        vertexParm      2       global2, global3, global4, 1
        vertexParm      3       0
        fragmentMap     0       cubeMap env/gen1
        fragmentMap     1       _flat                                                 // Bump
        fragmentMap     2       textures/darkmod/decals/vegetation/cattail_flat_side  // Diffuse
        fragmentMap     3       _black                                                // Specular

has been removed as it is no longer needed as of TDM 2.0 (Standalone)

Note: If you make the material two-sided, then you can save creating the "backside" patch. However, D3 will do so when it loads any model using this material, and the "backside" is created as an extra surface. This means it will use up one extra drawcall. To avoid this, we create a one-sided material, and create the backside ourselves:

Create the patches, export as ASE

Now we are back to DR:

  1. Create a patch mesh (3x3) and place it inside your model, at the middle, and drag it out so it covers the model dimensions
  2. Select the newly made material, and in the surface inspector, press "Fit". You might also have to flip the texture vertically. If you created a texture atlas, you also need to scale the texture to 0.5 x 1.0 and use the Right and Left buttons on the surface inspector.
  3. Now repeat this step from the other side, e.g. 90°,creating the side-texture and a side patch.
  4. You will end up with something like this, the two patches, and the original model in the middle:
  5. If you have created a one-sided material (as you should :), select each of the patches, duplicate it with SPACE and then rotate them around the z-axis by 180°. This makes sure the model is visible from all angles.
  6. Now deselect the original model, and export all (two or four) patches as ASE model. The origin should match the origin of the original model (e.g. not be nec. at 0,0,0). The easiest way to select all patches is to draw a brush around the model (enclosing it completely), then select "Select inside". Don't forget to deselect the original model, you want only the patches! Re-import the model into DR and you are now almost done.

Step 1   Step 5   Step 6   Step 6

Done!   Done!

Note: In some of the screenshots above, the patches are not exactly center in the model, this was a mistake of mine and has been corrected after I took the screenshots.

The model in game

These shots show the models side by side in game. Note that the conditions here are unrealistic, the model will never be seen so close by the player, and in addition, one would choose a dark background/underground to hide the models better.

As you can see on the second shot, where the largest distance is 1000 units, the model will be indistinguishable in most conditions. (Note: The cattails screenshot are before color correction, this is why the LOD model looks quite a bit darker)

Done!   Done!

Original model in game   New model in game

Original model in game   New model in game

And here is a screenshot from a lily model:

Side by Side lilies

Color correction

When you look at your model in game, it might appear to dark compared to the original model. The cattails are f.i. ok, but the lily looks off:

Lily model before color correction

This can be corrected by adjusting the colors of the texture, f.i. by using the "Curves" tool. I used the original texture here a a rough guideline. The exact match is not that important, just get it close:

Collor coretion with the Curves tool


Lily model in game after color correction


If you haven't followed the steps about a texture atlas and created a two-sided material, you will notice that the model uses 4 drawcalls in game, compared to the original model. That means placing many of the new models is actually slower than placing the original models, despite the greatly reduced number of triangles.

The reasons are:

  • Without a texture atlas, each patch uses its own material, thus creating two surfaces, using one drawcall each.
  • With a two-sided material, D3 will upon load duplicate all surfaces and invert their side. This means you end up with 2 drawcalls instead of one.

Both issues together will create four drawcalls per model per light, instead one per model per light. Since each model is drawn multiple times (once for each light), this can add up very fast.

Here is how you can fix this:

Texture atlas

  1. Create both views (side and front) in the same texture.
  2. Select the newly made material, and in the surface inspector, enter "0.5 x 1.0" for the scale, then press "Fit". use the "Left" and "Right" buttons to shift the texture for the front and side, respectively.

Here are some tips for creating a good texture atlas:

The texture atlas should have equal space for each texture part. This makes it easier to positioning things in the editor when texturing the patches. However, sometimes this is not possible. Here is an example of the lily model,where one side view is quite a bit larger than the others:

Lily model in game before color correction

There are two ways to fix this:

  1. make everything the same size (in this case 1/4 of the texture). This means that the left three parts are sourounded by quite big empty spaces, wasting texture resolution.
  2. Make the "offending" part smaller. This means you need some scaling to get it back to size when texturing, and it also has not the same resolution as the other parts. The advantage is, however, that the other parts all use the resolution much better.

Here is how #2 looks:

Size corrected atlas

And the final texture atlas:

Final atlas

One-sided material with duplicated patches

  1. Uncomment the "twosided" line in your material.
  2. Select each of the two patches, duplicate it with SPACE and then rotate them around the z-axis by 180°. This makes sure the model is visible from all angles.


In my first test, I also did a "top-side" view, and placed this as patch at the bottom, horizontally. The theory was that there is something the player can see if he looks straight from the top.

However, in game tests showed that it only looked funky (often z-fighting with the floor), and since the player is far away from the model, anyway, he can't see it from straight top. If you view it high above, it will still look quite good due to the patch being vertical and thus partly visible. So, just having a front and side few is sufficient for high models.

However, if the model is very small (like only 20cm high) and the player can walk over the model and view it straight from the top, you should consider adding a horizontal plane, too. Make sure you lift if 0.0125 units above the floor, tho, or it will z-fight with the floor!

See also