Introduction

A cutscene in Alien: Isolation is scripting: cameras, a CAGEAnimation keying them, links that switch from one camera to the next, depth-of-field and motion-blur settings, and something to start it. Getting those right by hand is fiddly, and several ways of doing it that look right in the editor misbehave in game. The Cinematic Shot Builder (Create Entity > Create Cinematic... above a composite's flowgraph, which builds into that composite) builds a whole multi-shot cutscene from a shot list, wired the way the game needs it.

The Cinematic Shot Builder: name, composite, start, end, hide HUD, motion blur off, depth of field; the shot list on the left (Add, Copy, Remove, Up, Down, From Viewport); the selected shot's camera, lens and focus settings on the right; Plan, Build, Preview Shot, Read Back, Open, Save As; the report below.

Plan only reports (the timing of every shot, the keys, the events); Build makes or updates the cutscene as one undo step - Save and Build to see it in game. The shot list last built on a level opens with the window, and Save As / Open keep shot lists as files. The AI assistant tools are build_cinematic and get_cinematic.

The Shot List

Shots play one after the other, each for its Duration. Points are written x, y, z in the level's space, or as an entity's name (its resting position). From Viewport puts the selected shot's camera where the viewport camera is, looking where it looks.

Camera and Moves

  • Static: held at Position. Dolly: from Position to To. Path: through Position and the Path points on a smooth curve (Bank tilts it into the turns like a flying camera). Orbit: round Orbit Centre at a radius and height, from one bearing to another.
  • Look At a point or an entity (empty: along the move; an orbit looks at its centre); Look To pans the look point over the shot; Rotation fixes the view when nothing is looked at; Roll tilts it.
  • Ease how moves, pans, zooms and focus pulls start and stop; Shake adds a slow handheld wander (0.5-1.5 degrees reads as handheld).

Lens and Focus

  • Fov (vertical, degrees) and Fov To for a zoom over the shot. Clip Planes: MACRO .001-10 m, CLOSE .02-100 m, MID .05-1000 m (the default), WIDE .25-5000 m, ULTRA 1-10000 m - a shot of something far away needs WIDE.
  • Focus on a point, an entity or a distance (empty: the look point); the focus distance follows the camera as it moves. Focus To racks focus to another point over the shot. FNum is the aperture (2 shallow, 8 deep) and Focal Length the depth-of-field lens (empty: the one that gives the shot's fov on a 35 mm frame; longer blurs more).

Starting, Ending, Cues

  • Starts: level_start starts it when the composite has loaded and the delay has passed (a camera brought up while the level is still loading is lost); none leaves it to you - link anything to <name>_Begin.trigger; or type an output such as PlayerTriggerBox_1.on_entered.
  • End: return hands the view back to the player (with a blend out, if set); hold stays on the last shot; loop plays it again. <name>_End.triggered fires at the end: link the rest of the level's script from there.
  • Events in a shot become output pins on the timeline to link from; Cues call entities' pins at set times ([{"time": 2.5, "call": "Door_1.open"}]).

What it Builds

Everything is named <name>_... in the chosen composite; building again with the same name updates it in place (links you made into _Begin, out of _End and out of your events stay):

  • _Timeline, one CAGEAnimation keying every camera with sparse Bezier keys (only where the move needs one), plus the cut events.
  • One CameraResource per shot (_Cam01, _Cam02...). A camera's fov fed by a float reaches it a frame or two late, so a cut made inside one camera's keys shows the new position with the old lens; separate cameras cut cleanly. Each cut brings the next camera up and lets the previous one go 0.05 s later. Before its cut a camera holds its first pose, so the frame it comes up on is already right. A zooming shot's camera reads a keyed float (_Cam02_Fov).
  • Depth of field: a DepthOfFieldSettings (_DOF, priority 500) whose focus, focal length, f-number and intensity come from four linked, keyed VariableFloats - keying the settings entity's own values never reaches the game's depth-of-field stack. Intensity stays 1 (it is a blend weight, not a blur strength; the lens makes the blur), and each shot's values change 35 ms after its cut so the old shot's last frame never takes the new focus.
  • Motion blur off while it plays (a HighSpecMotionBlurSettings with no blur at priority 1000), the HUD hidden (Force_UI_Visibility), and the start: _Begin, and for level_start a ZoneLoaded and a delay.

In game: the second shot of a test cinematic - a posed figure framed by the shot's camera, in focus at its distance.

Preview Shot shows the selected shot's camera at its start, middle and end in the viewport (Build first; the viewport must be on). Read Back lists what was built, the events and what they call, and whether the timeline will play.

Characters in Shot

A character's clip plays on its own clock, and on a slow frame it falls behind a CAGEAnimation. Clip sync locks clips to the timeline instead: for each CMD_PlayAnimation listed ([{"entity": "Anim_1", "at": 1.0, "start": "Bind_1.trigger"}]) the builder keys a clock that reads 0 at at and runs at rate (from clip_start into the clip), links it to the command's ExternalTime, and calls start (for example the character's TriggerBindCharacter) at that moment. The clip then never drifts from the camera, and slow-motion is a rate below 1. Keep the clip's own setup (marker, character binding) as for any scripted clip.

Limits

  • Looking at or following an entity uses where it rests, not where an animation moves it.
  • Cuts happen on events, which the game shows a frame or two after the timeline passes them; the depth-of-field step is held to match.
  • The builder owns the timeline's tracks and events: edits made to _Timeline by hand are replaced on the next build (change the shot list instead).
  • Uncapped frame rates can show a camera and moving models a fraction of a frame apart; Launch Game's Cap FPS keeps cutscenes steady.