Css - Revision history

Gsigms: /* Success Stories */

2012-01-06T14:45:57Z

‎Success Stories

Gsigms: /* Usage */

2012-01-06T14:44:32Z

‎Usage

Gsigms: /* Usage */

2012-01-06T14:43:26Z

‎Usage

Gsigms: /* Use Case */

2012-01-06T14:42:59Z

‎Use Case

Rylius at 08:59, 4 December 2011

2011-12-04T08:59:36Z

Rylius at 08:58, 4 December 2011

2011-12-04T08:58:41Z

Gsigms at 16:23, 4 October 2011

2011-10-04T16:23:24Z

Gsigms: /* Installation */

2011-10-04T14:40:31Z

‎Installation

Gsigms: 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. ..."

2011-10-04T14:37:59Z

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. ..."

New page

== CSS ==
CSS is an experimental modification of [[Compiling:q3map2 | 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.

{{Warning|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.

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

@@ Line 48: / Line 48: @@
      q3map2 -threads X ... -light ... -strip path/to/map.bsp
-== Success Stories ==
+== Maps compiled with CSS ==
-The CSS modification has been used for the creation of various maps:
+* '''Azurea'''. ut4_azurea_a1 is a jump map and the main motivation for CSS.
 [[Category:Compiling]]

@@ Line 42: / Line 42: @@
 === Usage ===
-Add the surfaceparm strip directive to shader to strip out of the bsp.
+Add the '''surfaceparm strip''' directive to shader to strip out of the bsp. Beware, stripping structural or visible surfaces may hold unexpected results.
 Compile the bsp and vis stage as usual. Add the '''-strip''' options for the light stage of your compilation:

← Older revision		Revision as of 08:59, 4 December 2011
Line 58:		Line 58:
	screenshots etc		screenshots etc

−	[[Category:~~Compiler~~]]	+	[[Category:Compiling]]

← Older revision		Revision as of 08:58, 4 December 2011
Line 57:		Line 57:

	screenshots etc		screenshots etc
		+
		+	[[Category:Compiler]]

@@ Line 22: / Line 22: @@
+     }
-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)
+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''' directive, CSS can remove surface using this shader from the bsp generated by q3map in order to improve ingame performance (see test case below)
 === Internals ===

@@ Line 1: / Line 1: @@
 == CSS ==
-CSS is an experimental modification of [[Compiling:q3map2 | 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.
+CSS is an experimental modification of [[Compiling:q3map2 | q3map2]] 2.5.16 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.
 {{Warning|Don't blame the tool if you waste hours of compilation for a broken bsp}}
@@ Line 28: / Line 28: @@
 === 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).
+Download CSS. CSS is provided as a single patch file for q3map2 2.5.16 source (CSS modifies 2 files, eg, game_quake3.h and light.c).
 Place the downloaded file in your q3map2 source directory "tools/quake3/q3map2/"