User Guide (Version 1.18)

Using the Screen Fader Effect

You can use the screen fader effect to control all screen fade properties, including duration of the fade effect and the color or texture to use for the fade.

You can stack multiple screen fader effects; multiple screen faders are rendered concurrently and in order of post effect group priority. Screen fader effects do not blend the parameters between layers.

The following example demonstrates how to use the screen fader effect in an .xml file:

<PostEffectGroup priority="2" hold="1"> <Effect name="ScreenFader"> <Param name="Enable" floatValue="1.0"/> <Param name="FadeInTime" floatValue="2.5"/> <Param name="FadeOutTime" floatValue="1.0"/> <Param name="ScreenCoordinates" vec4Value="0.0,0.0,1.0,1.0"/> <Param name="FadeColor" vec4Value="0.2,0.7,0.7,0.5"/> <Param name="TextureName" stringValue="textures/StyleTown/_dev_Blue_Light.tif"/> </Effect> </PostEffectGroup>


You can set the following parameters:


Determines whether or not the ScreenFader is active for the post-processing effect group.

Valid values: 0 = Disable | 1 = Enable


Time, in seconds, for the screen fader to fade in, once enabled.


Time, in seconds, for the screen fader to fade out, once disabled.


Determines the rectangle where the screen fader is rendered. Specify the coordinates in the format (Left, Top, Right, Bottom). For example, a fullscreen quad is specified as (0.0, 0.0, 1.0, 1.0) and a quad that fills half of the screen is specified as (0.0, 0.0, 0.5, 1.0).

Valid values: 0.0 - 1.0


Sets the quad color by multiplying the color by the specified texture. If no texture is specified, the quad will be a solid color.


Path of the texture to use for the screen fader.

On this page: