Render Manager

Initializes the Advanced Lighting (AL) render format token and MSAA copy PostEffect. Ensures driver MSAA does not interfere with deferred lighting passes.

Overview

Returns a standard M module with one initialization function. Also creates two scene objects at load time for the AL format resolve pipeline.

Public API

Scene Objects (Created at Load)

Scene Objects (Created by initRenderManager)

Format Token Configuration

local alFormatToken = createObject("RenderFormatToken")
alFormatToken.enabled = false
alFormatToken:setField("format", 0, "GFXFormatR8G8B8A8")
alFormatToken:setField("depthFormat", 0, getConsoleVariable("$GFXFormatDefaultDepth"))
alFormatToken.aaLevel = 0  -- No MSAA for deferred passes

-- Copy effects for format token transitions
alFormatToken:setField("copyEffect", 0, "AL_FormatCopy")
alFormatToken:setField("resolveEffect", 0, "AL_FormatCopy")

How It Works

1. AL_FormatToken creates a non-MSAA render target for deferred lighting
2. Before the token: AL_FormatCopy copies back buffer contents into $inTex
3. Deferred lighting renders to the non-MSAA target
4. After the token: AL_FormatCopy resolves back to the (potentially MSAA) device buffer

Notes

• AL_FormatCopy is never added to the PostEffectManager - it's used directly by the token
• Do not call enable() on AL_FormatCopy
• AL_FormatTokenState inherits from PFX_DefaultStateBlock
• The depth format is read from the console variable $GFXFormatDefaultDepth
• aaLevel = 0 disables MSAA; use -1 to match the back buffer

See Also

• PostFx SSAO - SSAO uses #ssaoMask within the AL pipeline
• PostFx Fog - Fog uses prepass textures from the AL pipeline