mission_task_cutscene¶
Source: base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl
Notes
Task that plays a camera cutscene.
MissionTaskCutscene¶
record global base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:3
global record MissionTaskCutscene is MissionInterface.TaskScript<MissionTaskCutscene.State, MissionTaskCutscene.Params>
Load: local cutscene = ug_require "::/mission/tasks/cutscene/cutscene.tl"
Notes
Task (cutscene) that plays a cutscene file when it starts (api.gui.mission.playCutscene) and completes when the cutscene ends or is skipped. Tool actions are disabled meanwhile; afterwards the game speed is set to gameSpeed.
Example
-- urbangames_campaign_mission_01
if taskKey == "build_path_task_cutscene" then
return {
taskScript = cutscene as MissionInterface.TaskScript<any, any>,
taskParams = { filePath = "urbangames_campaign_mission_01::/mission/keyframes/MISSION_01_CUTSCENE_BUILD_PATH.lua" },
allowSimultaneousUiTasks = {
mission_task_util.makeTaskKey("build_path_task", "urbangames_campaign_mission_01::/mission/mission.script")
},
}
end
MissionTaskCutscene.Params¶
record base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:4
record Params
Notes
Params of the task.
Used in the base game: 2 times in 1 file
base/content/mission/mission/tasks/cutscene/cutscene.tl:3
Fields
| Name | Type | Description |
|---|---|---|
filePath |
string |
Keyframe file of the cutscene. |
gameSpeed |
integer |
Game speed set when the cutscene is over (default 1). |
Functions
getEntityToEntityMap(getTaskState : function(uniqueTaskKey : string) : MissionInterface.TaskState<any, any>) : {Engine.Entity : Engine.Entity} base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:7
Notes
Returns a map that replaces entities of the cutscene file with runtime entities.
| Parameter | Type | Description |
|---|---|---|
getTaskState |
function(uniqueTaskKey : string) : MissionInterface.TaskState<any, any> |
Looks up a task by its unique key. |
Returns {Engine.Entity : Engine.Entity}: Entity in the file -> entity to use.
MissionTaskCutscene.State¶
enum base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:9
enum State
Notes
Playback state.
Used in the base game: 3 times in 1 file
base/content/mission/mission/tasks/cutscene/cutscene.tl:2
| Value | Description |
|---|---|
"Initial" |
Not started. |
"Playing" |
Playing. |
"Complete" |
Ended or skipped. |