An occlusion mesh is an extra resource object defining a low polygon mesh blocking the view. Each face in the mesh marks a view blocking polygon in space. In contrary to model resources resources occlusion meshes can be composed of faces with more than 3 corners as long as all corners of the face are coplanar. Faces can be double sided or single sided. By default faces are double sided.

Faces are not required to share vertices nor are they required to connect to each other or to defined a closed manifold mesh. You are free to place faces in an occlusion mesh the way you see fit. For most models creating the occlusion mesh is fast as it contains only a handful of faces taking no time to create.

Occlusion meshes support animation as do models. You can define bones and weights for vertices the same way. Occlusion meshes without bone weights are called static occlusion meshes while those with bone weights are called dynamic occlusion meshes.

A double sided face blocks the view from both directions. This is the choice for walls of any kind. Use double sided also for faces on room walls where no geometry is located outside. The reason is that Graphic Modules can decide to use occlusion meshes also for shadow casting optimization and missing a double sided face on such walls can result in unexpected behavior.

On the other hand single sided faces block the view only from the front side. The front side of the face is the side where the normal is pointing at you. From the back side the single sided face does not block the view. This can be used for situations where a texture blocks the view only from one side but not the other. An example would be a police interrogation room half-mirror window where you can see the inside from the outside but not vice versa. Using a double sided face the objects in the inside can be incorrectly culled.

Occlusion meshes are stored in own resource files. This allows to reuse occlusion meshes across different objects. You can export occlusion meshes using the Blender3D export scripts. Occlusion meshes are typically not found floating alone in a scene but belong to actual scene geometry. For this reason you attach occlusion meshes to components. In the World Editor you can do this by using the occlusionMesh object property where you set the path to the occlusion mesh to use. The name of this property can be different for special element classes if required.

Occlusion meshes assigned to components are moved, rotated and scaled together with the component. This way dynamic objects moving in the scene work equally well with occlusion meshes as do static objects. A typical use for this are doors where culling of props in a room is possible while the door is closed. If the occlusion mesh is a dynamic occlusion mesh and the component has a matching rig object assigned (bones in the rig and occlusion mesh match partially or fully) then the occlusion mesh deforms alongside the model. This can be used for multi-part doors with special shapes or open-closing patterns. This can be also used for large deformable objects to provide as much culling oppurtunity to the Graphic Module without causing wrong culling due to the occlusion mesh sticking out of the model.

• In general the less faces an occlusion mesh has the faster it is for culling no matter what culling technique the Graphic Module uses.
• Use double sided faces whenever possible. Single sided are for special situations providing only half the culling oppurtinities and can even lead to unexpected behavior.
• Use occlusion meshes only on larger objects suiting well for blocking the view in a large scale. Small occlusion meshes or thin occlusion meshes are usually inefficient.
• Avoid using one huge occlusion mesh but instead use more smaller ones. This allows Graphic Modules to skip occlusion meshes not affecting the view improving performance.

The Blender3D Export Scripts allow to export a mesh object as an occlusion mesh file (*.occmesh). You create the mesh the same way as you would create a mesh for exporting as a model. The difference is how materials are used. For occlusion meshes you need 1 or 2 materials which represent the double sided and single sided faces. You can reuse the materials for various meshes. A good name for them is “occmesh double” and “occmesh single”. Use the “Double Sided” property in the “Drag[en]gine Texture” object panel to mark the material either as single or double sided for use with occlusion meshes. Assign the double sided faces to the double sided marked material and the single sided faces to the single sided marked material. If done correctly the exporter write the occlusion mesh with the right faces.