Skip to content
San Andreas Online Docs

engineSetRadarMapTile

Client-side
SA:O APIExtended native radar

Registers or replaces a resource-owned TXD in one cell of San Andreas Online's sparse 40 × 40 native radar grid.

Syntax

bool engineSetRadarMapTile(int column, int row, txd tile)

Arguments

columnint

Logical radar column from 0 through 39.

rowint

Logical radar row from 0 through 39.

tiletxd

A TXD created by the calling resource and containing the radar tile texture.

Returns

true when the tile was accepted; false for an invalid/protected cell, foreign TXD, unreadable TXD data, or registration failure.

Ownership and lifecycle

The resource that creates the TXD owns its tiles. Destroy the TXD or stop the resource and San Andreas Online unregisters them.

Important behavior
  • The stock 12 × 12 San Andreas cells are protected.
  • Compressed source bytes are copied into engine-owned state; the source TXD still anchors ownership.

Example

local tile = engineLoadTXD("radar/radar00.txd")
assert(tile and engineSetRadarMapTile(30, 20, tile))

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDED766727162Read the commit and why the change was made RELATED CATEGORY HARNESS extended-radar-test Category-level coverage · test-resources/extended-radar-test
RELATED SA:O APIS

Continue exploring

Read the system guide →
engineResetRadarMapTile Removes a radar tile owned by the calling resource and restores the native ocean fallback. engineGetRadarMapStats Returns the current extended-radar hook, registration, loading, failure, and source-byte counters. setWorldSeaBedOuterBoundary Sets and synchronizes the square procedural-seabed boundary.

← Back to the SA:O Lua API · How Extended native radar works →