Lightmap

Lightmap and Deluxemap of the Kain's mausoleum

Lightmap is generated texture that contains brightness of a map surface. It is applied additively to the surface texture. The color values of surface's texture get multiplied by lightmap color. Lightmaps are created each time map is compiled (by a LIGHT phase of the map compiler). In Q3BSP, lightmaps can only store static lightning, no flickering or moving lights (for this ones dynamic lights should be used).

Lightmap resolution

Lightmap resolution is different from the texture resolution. Default luxel (lightmap pixel) size is 8 game units. Higher lightmap resolution = lower luxel scale = more details = more memory used. There is a bunch of ways to control lightmap resolution:

• Global luxel scale (set in map build script)
• Entity's "_ls" or "_lightmapscale" field (works on func_group too)
• Material's q3map_lightmapSampleSize (alters default luxel size for this material)

Lowering luxel scale will make lightmap shadows sharper, but leads to larger map filesize, slightly slower rendering and exponentially slower compiles (that at very low scales start to eat up shocking amounts of system memory).

Deluxemapping

Deluxemaps are optional part of lightmaps, while lightmaps store light intensity, deluxemaps store light directions. Deluxemaps allows lightmapped surfaces to have normalmapping and specular effect applied, effectively making them more detailed and look just like dynamic lighting.

Lightmap types

There are two types of lightmaps - internal and external. Internal lightmaps are 128x128 pixel pages that are stored inside BSP file. External lightmaps is 24-bit TGA images stored outside of BSP file (in map/bspfilename/lm_<num>).

Map build script are used to configure whether map should use internal or external lightmaps.

External lightmaps have an advantage - they can be any size (256x256, 512x512, 1024x1024 and up to hardware limits). For big outdoor maps using external large lightmaps results in better packing and lesser map size. Ideally, one map should have exactly one big external lightmap.

There is no way to set explicitly what number of lightmaps map will have, it's calculated automatically - if map luxels can be mapped to one lightmap - compiler does it, otherwise it adds a second and more lightmap pages to fit.

Usage of lightmaps

Small objects:	Require high-resolution lightmaps or artifacts will occur
Foliage (grass, mushrooms etc.):	Likely to overwhelm map size, as each object adds to lightmap data
Brush models:	OK
Whole map:	OK
Terrain:	OK
Point entities:	not applicable

Console variables

 r_ambient : adds intensity to lightmap and lightgrid. Positive values makes map brighter (note: manual edit of this cvar via console does not work in Blood Omnicide, as cvar is controlled by gamecode).

 r_fullbright : disables static lighting.

See also

• Darkplaces lighting
• Vertex lighting
• Lightgrid