Skip to content
MTA:SA Neon Documentation

fadeFileCutscene

Client-side
NEON APINative file cutscenes

Available in Neon, not standard MTA

Runs GTA's native fade while the file-cutscene lease is active.

Syntax

bool fadeFileCutscene(int token, bool fadeIn, float durationSeconds [, int red, int green, int blue])

Arguments

tokenint

Current file-cutscene token.

fadeInbool

true to reveal the scene, false to fade to a color.

durationSecondsfloat

Finite duration from 0 through 60 seconds.

red, green, blueintoptional · default 0, 0, 0

Optional fade-out color channels from 0 through 255.

Returns

true when the fade was accepted; false for invalid ownership or duration.

Ownership and lifecycle

File cutscenes share GTA's exclusive camera lease. Release, resource shutdown, disconnect, or a camera takeover deletes the native cutscene before restoring gameplay state.

Where this comes from

SOURCECLuaCameraDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaCameraDefs.cpp INTRODUCED / EXTENDED4f2be00c1Read the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf
RELATED NEON APIS

Continue exploring

Read the system guide →
requestFileCutscene Acquires the exclusive camera lease, optionally owns GTA's visible world area, and starts loading a stock file cutscene. isFileCutsceneLeaseActive Reports whether the calling resource still owns this file-cutscene generation. isFileCutsceneLoaded Reports whether GTA has finished loading the owned DAT/CUT/IFP cutscene data.

← Back to the Neon Lua API · How Native file cutscenes works →