SA:O APIRenderer and distant lights

Refreshes the distant-light catalogue from San Andreas Online's startup capture and currently available world data.

Syntax

Copy signature

bool engineRebuildDistantLights()

Returns

Always true after requesting the rebuild.

Ownership and lifecycle

Renderer counters live for the current process. Distant lights start disabled, and each client resource can opt in.

Important behavior

• Static IPL lights captured during GTA startup remain available regardless of the player's current location.

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDEDd0a91316bRead the commit and why the change was made RELATED CATEGORY HARNESS project2dfx-test Category-level coverage · test-resources/project2dfx-test

RELATED SA:O APIS

Continue exploring

Read the system guide →

engineGetRendererStats Returns current, session-high-water, and capacity counters for San Andreas Online's expanded renderer arrays. engineResetRendererStats Resets renderer high-water measurements without changing capacities or active objects. engineSetDistantLightsEnabled Enables or disables San Andreas Online's native Project2DFX distant static lights.

← Previous in categoryengineSetDistantLightsDrawDistance Next in category →engineGetDistantLightStats

← Back to the SA:O Lua API · How Renderer and distant lights works →