lit2: update docs

This commit is contained in:
Eric Wasylishen 2015-05-17 00:28:56 -06:00
parent 29bbd06d61
commit 2711da8984
2 changed files with 38 additions and 1 deletions

View File

@ -308,10 +308,16 @@ main(int argc, const char **argv)
write_litfile |= WRITE_LIT;
} else if (!strcmp(argv[i], "-lit2")) {
write_litfile |= WRITE_LIT2;
} else if ( !strcmp( argv[ i ], "-lmscale" ) ) {
} else if ( !strcmp( argv[ i ], "-lmscale" ) || !strcmp( argv[ i ], "-lightmapscale" ) ) {
int j;
int lightmapscale = atof(argv[++i]) * 16;
if (lightmapscale < 1) {
lightmapscale = 1;
} else if (lightmapscale > 256) {
lightmapscale = 256;
}
for (j = 1, lmshift_override = 0; j < lightmapscale;) {
j *= 2;
lmshift_override++;

View File

@ -59,6 +59,10 @@ surface (more detailed explanation in the "_anglescale" key below).
Force generation of a .lit file, even if your map does not have any coloured
lights. By default, light will automatically generate the .lit file when
needed.
.IP "\fB\-lit2\fP"
Force generation of a .lit2 file, which allow variable lightmap
resolution as well as storing light direction data. By default, light
will automatically generate the .lit2 file when needed.
.IP "\fB\-dirt\fP"
Globally enables dirtmapping (ambient occlusion), overriding the "_dirt" worldspawn
key. See "_dirt" for more details.
@ -73,6 +77,10 @@ Enables light to pass through transparent pixels in fence textures
(textures with a "{" prefix). Typically, shadow-casting fences should
be a func_wall entity with the "_shadow" "1" key set. Default is for
transparent pixels to block light.
.IP "\fB\-lightmapscale n\fP | \fB\-lmscale n\fP"
Force the given lightmap scale for the entire map, overriding any
values set in the map via the "_lightmapscale" entity key. See
"_lightmapscale". Default 1.0.
.SH "MODEL ENTITY KEYS"
@ -190,6 +198,29 @@ bmodel touches or sticks into the world, and you want to those ares from
turning black. Default 0.
.SS "Func_Group/Func_Detail Keys"
.PP
The following keys can be used on any entity with a brush model,
worldspawn, as well as special entities func_group and func_detail,
which are processed by qbsp.
Note: these keys are read by qbsp and passed to light through a temporary file.
.IP "\fB""_lightmapscale"" ""n""\fP"
Customize the lightmap scale for brush faces of this entity:
.nf
0.0625 => 16 times default resolution (finest)
0.125 => eight times default resoluton
0.25 => four times default resolution
0.5 => two times default resolution
1 => default
2 => half default resolution
4 => quarter default resolution
8 => eigth default resolution
16 => 1/16 default resolution (coarsest)
.fi
Using this key imples -lit2.
.SH "LIGHT ENTITY KEYS"
.PP