Skip to content
San Andreas Online Docs

setScriptCameraFixed

Client-side
SA:O APINative script camera

Place the camera at one position and make it look at another, using an immediate cut or GTA's camera transition.

Syntax

bool setScriptCameraFixed(int token, Vector3 position, Vector3 target [, float upOffset = 0, bool jumpCut = true])

Arguments

tokenint

Current lease token.

positionVector3

Finite camera position.

targetVector3

Finite look-at target.

upOffsetfloatoptional · default 0

Native vertical point-at offset.

jumpCutbooloptional · default true

Use an immediate cut rather than a transition.

Returns

true when the current lease accepted the fixed camera; false otherwise.

Ownership and lifecycle

Only one resource can own the global script camera. San Andreas Online rejects stale callbacks and releases ownership on stop, restart, disconnect, or an authoritative server camera RPC.

Where this comes from

SOURCECLuaCameraDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaCameraDefs.cpp INTRODUCED / EXTENDED8cf6cc3cbRead the commit and why the change was made RELATED CATEGORY HARNESS native-script-camera-test Category-level coverage · test-resources/native-script-camera-test
RELATED SA:O APIS

Continue exploring

Read the system guide →
acquireScriptCamera Acquires the resource-exclusive GTA script camera and returns a generation token. releaseScriptCamera Restores captured gameplay camera state and optionally leaves a successful scene under its black fade. isScriptCameraLeaseActive Reports whether the calling resource still owns the specified camera generation.

← Back to the SA:O Lua API · How Native script camera works →