iw4L/docs/GSC-POSTFX.md

GSC post effects

GSC owns the presented post effects. Script presets and dvars pass through snapshot metadata to the GPU; user brightness, DoF, bloom and debug tweak settings do not suppress explicit script effects. State resets with the match. Native grading keeps disabled presets and parse refusals distinct; enable/disable transitions blend the grade with ungraded color.

• VisionSetNaked/Night/Pain/Thermal/MissileCam(name, seconds) and the self ...ForPlayer(name, seconds) methods select vision/<name>.vision. An empty name restores the map preset; global changes clear player overrides. Night follows the night vision flag. Pain blends with the base vision below half health and fades on recovery.
• self SetBlurForPlayer(radius, seconds) transitions Gaussian screen blur. Zero clears it; a new transition starts from the current blur.
• self SetDepthOfField(nearStart, nearEnd, farStart, farEnd, nearBlur, farBlur) controls focus and blur; zero distance ranges return to normal autofocus.
• SetDvar(name, value) applies globally; self SetClientDvar(s) overrides that client's values. Film supports enable, brightness, contrast, desaturation, dark desaturation, invert, and light/medium/dark RGB tints. Both r_film... and r_filmTweak... spellings are accepted.
• Bloom supports r_glow, radius0, bloom intensity0, cutoff and desaturation, including the r_glowTweak... spellings. DoF supports r_dof_enable, viewmodel/near/far start/end, near/far blur, and bias.
• IW4L also accepts r_hue / r_filmHue (degrees), r_gamma (>0), r_exposure (stops), r_saturation (1 is neutral), r_blur, r_brightness and r_contrast. These are dvars, not new GSC natives.
• SetExpFog(start, halfway, r, g, b, [opacity,] seconds) changes map fog. The 14-argument sun-fog form is supported. Transitions blend density and packed color from the current state; the first call applies immediately.
• Earthquake(scale, seconds, origin, radius) adds a timed camera shake. Calls overlap, attenuate linearly with distance and fade over their duration. Zero radius applies globally; each call clamps scale to 1 for camera angles. Shake is presentation only and does not change player aim or collision.

self SetClientDvars("r_filmBrightness", 0.1, "r_hue", 90, "r_gamma", 1.2);
self SetClientDvar("r_filmLightTint", (1, 0.5, 0.25));
self SetBlurForPlayer(6, 0.5);

The render chain grades color, blurs the scene, then applies film, DoF and bloom. HUD remains readable. Bloom preserves the material's authored sRGB writes. Blurred shellshock accumulates successive scene frames using the profile's bg_shock_screenBlurBlendTime and bg_shock_screenBlurBlendFadeTime. It desaturates the saved image; stop, respawn and map changes reset history. Thermal selection uses the scoped weapon and view gates. Scoped thermal vision switches instantly with the scope overlay for every weapon family. SetThermalBodyMaterial(name) selects the global body camera material. An empty first token selects thermalbody_default; Cold-Blooded bodies keep their material. thermalBlurFactorNoScope sets unscoped thermal accumulation time in milliseconds (default 250, range 0–10000). Scopes bypass thermalBlurFactorScope. cg_drawShellshock controls profile effects; thermal accumulation works while it is off. Snapshots use protocol 99; host and client must share that protocol.