mirror of
https://github.com/vladtrc/iw4L
synced 2026-10-26 02:11:39 -04:00
vtroc7
51 lines
3.4 KiB
Markdown
51 lines
3.4 KiB
Markdown
# 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.
|
||
```c
|
||
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.
|