Difference between revisions of "Css"
(Created page with "== CSS == CSS is an experimental modification of q3map2 2.5.17 map compiler. It allows to selectively strip drawSurfaces from the bsp generated by q3map2. ...") |
(→Installation) |
||
Line 28: | Line 28: | ||
=== Installation === | === Installation === | ||
− | Download CSS. CSS is provided as a single patch file. | + | Download CSS. CSS is provided as a single patch file for q3map2 2.5.17 source (CSS modifies 2 files, eg, game_quake3.h and light.c). |
Place the downloaded file in your q3map2 source directory "tools/quake3/q3map2/" | Place the downloaded file in your q3map2 source directory "tools/quake3/q3map2/" |
Revision as of 14:40, 4 October 2011
Contents
CSS
CSS is an experimental modification of q3map2 2.5.17 map compiler. It allows to selectively strip drawSurfaces from the bsp generated by q3map2. CSS introduces a new shader surfaceparm directive called "strip". This directive instructs the q3map2 modified compiler to remove any surface textured with "strip" shaders from the bsp after the light stage.
Don't blame the tool if you waste hours of compilation for a broken bsp |
Use Case
An interesting application of CSS is for maps that use invisible, non solid, light emitting shaders like the one below (the stage defines a fully transparent surface):
textures/mytextures/light_white_1k { q3map_lightRGB 1.0 1.0 1.0 q3map_surfacelight 1000 surfaceparm nolightmap surfaceparm nonsolid surfaceparm trans { map $whiteimage alphaFunc GE128 alphaGen const 0 } }
Considering lights in Urbanterror are computed at compile time, surface painted with this shader have no effect ingame. With the addition of the surfaceparm strip, CSS can remove surface using this shader from the bsp generated by q3map in order to improve ingame performance (see test case below)
Internals
As of today, CSS does not remove the surface definitions from bsp files, It only invalidates references to stripped surfaces from the leaf nodes of the bsp trees.
Installation
Download CSS. CSS is provided as a single patch file for q3map2 2.5.17 source (CSS modifies 2 files, eg, game_quake3.h and light.c).
Place the downloaded file in your q3map2 source directory "tools/quake3/q3map2/"
Apply the patch to your q3map2 source using the patch command line tool (screw you windows' users)
patch -p0 css.patch
Recompile q3map2 (from the root directory of the source tree):
scons target=q3map2
Usage
Add the surfaceparm strip directive to shader to strip out of the bsp.
Compile the bsp and vis stage as usual. Add the "-strip" options for the light stage of your compilation:
q3map2 -threads X ... -light ... -strip path/to/map.bsp
Success Stories
The CSS modification has been used for the creation of various maps:
ut4_azurea_a1
This project is the main motivation for the creation of CSS.
screenshots etc