AI tools: Cameras and cinematics

Cameras, lenses, focus, sequences and renders. 11 tools. You see every step your AI takes and can undo any of them.

anti_aliasing

Image stability report and settings: 4x MSAA plus temporal anti-aliasing (a sub-pixel jitter every frame resolved against the history, reprojected by depth and per-object motion vectors, clipped to each pixel's neighbourhood, so ceiling grids, wires, fixture rims, glints and distant detail stop crawling as the camera moves), its sharpening, map mip bias and the render scale. Set temporal / sharpen / jitter_spread / mip_bias / history_blend / clip to change the renderer for this session (A/B; the person's View menu keeps the saved Temporal Anti-Aliasing setting). Judge changes on a moving camera (record a pan), never on one still. A scene that must look the same without it sets camera_look anti_aliasing "msaa_only"; "taa" forces it on.

camera_gear

Physical cinema cameras: with no arguments, every camera body (sensor: super35, full_frame, large_format, 65mm, imax, super16, phone...) and lens kit (modern_primes, classic_primes, super_speed, anamorphic_2x, anamorphic_1_5x, large_format_primes, cine_zoom, doc_zoom, macro, ultra_wide, phone, drone, action_cam) with what each looks like. With kit (and body, focal mm, t_stop, focus_distance m): the camera worked out as on set: the lens the kit gives for that focal length, the field of view across and high at 16:9, the full-frame equivalent, what is sharp (near and far limits, hyperfocal), breathing at that focus, coverage. Use the names in sequences (camera_body, lens_kit, lens, t_stop on a sequence or a cut) or a cine_camera component on a camera object.

color_grade

Colour grades (3D LUTs) for the camera: list the built-in looks (film_print, bleach_bypass, teal_orange, cold_moonlight, sodium_vapor, sickly_green, vintage_fade, noir, horror_red) and the project's .cube LUTs; apply one to the scene (camera_look lut / lut_strength); make a new one with colour wheels (lift / gamma / gain, contrast, saturation, shadow and highlight tints, optionally on top of a base look); or match: grade the current view to look like a reference picture (Grade Match writes Assets/LUTs/<name>.cube). Per-area grades: a grade_zone object with its own lut. Take a screenshot to judge.

focus_camera

Move the editor camera to frame an object or look at a point. With Follow AI off, only override_follow: true moves the person's view once without re-enabling AI follow; editor_command view.reset always escapes a trapped camera.

look

See the scene as a text report instead of a picture: what fills the view, how bright each part of the frame is, problems the engine finds itself (blown-out or black frames, headless characters, glare, stuck enemies) and the game's state. Fast and cheap; use screenshot only to judge looks.

make_boss_intro

Make a boss intro: the cutscene when the hero enters a boss arena, as AAA adventure games do. The door seals behind (door sent "seal"); the arena's silence, then it reacts (a low hand-held shot, a rumble); the boss arrives its own way (arrive: "emerge": hidden, then bursting up out of the ground on its Emerge clip; "drop": from above; "stand": already there, waking); the roar (its roar clip) slowed to half speed at the peak; the name card (title, sub) as the boss theme starts (music); back behind the hero, the boss and every script sent "boss_fight_start". Framed from the boss's real size. Saved as Sequences/<name>.sequence.json to refine. Letterboxed, holds the player, skippable.

make_reveal

Make an arrival reveal: the cutscene that presents a big place (a temple, a landmark, a city) the first time the hero comes to it, as AAA adventure games do. Framed from the real size and place of subject and of the hero (from, or the player): the camera leaves the hero's shoulder in a slow crane up and back while the focus pulls from the hero to the subject; a push in on the door (if given) while the wake objects' lights come up one after another and a rumble plays (the door is sent "open"); the title card (title, sub) on the swell; a blend back down behind the hero, and the objective. Saved as Sequences/<name>.sequence.json to refine with the other sequence tools; play it from a trigger (a cutscene trigger, or a script's game.cutscene). Letterboxed, holds the player, skippable.

render_sequence

Render a sequence as it is watched (slow motion stretches it), stepped at the fixed simulation rate, through its cameras into numbered PNG frames (video: true also makes an mp4) in the project's Renders/<name>/ folder (or times: a still at each story time), on a copy of the scene. Returns a contact sheet of a few frames. fps default 24; from/to are story seconds. movie: true renders each frame as a film camera exposes it: many whole renders across the open shutter (the cut's shutter angle), the lens's iris and the pixel, averaged before the post (true depth of field with occlusion, every moving thing's real motion blur, supersampled edges); movie_samples renders a frame (default 64).

scrub_sequence

See a sequence at any story time without playing it: every track put where it is then (objects, bones, lights, clips at their exact frame) on a copy of the scene, shown through the sequence's camera (camera: "editor" for the editor's view, or eye + look for any view), with the motion paths drawn (paths: false hides them). show: true also puts that moment in the editor's viewport until scrub_sequence {show: false} or Play.

upscaler

Temporal upscaler: the scene renders at a share of the output's pixels per axis (scale; 0.67 draws about 45% of them) with a sub-pixel jitter, and the temporal resolve rebuilds full resolution from this frame's samples (weighted by their jittered distance) and the reprojected history (YCoCg variance clipping, depth disocclusion, luminance-weighted blend, per-pixel confidence). Settings apply live for this session. debug_view draws over the viewport: confidence (history length: dark red fresh to white converged), rejection (red dropped, yellow clipped, magenta firefly held), motion (where each pixel's history came from: hue direction, brightness length), jitter (this frame's sample coverage, the sequence in the corner), flicker (cyan where the clip was widened for a pixel that keeps flickering on a still view). capture renders a converged still at a scale to a PNG; sequence renders a camera move frame by frame to PNGs (for PSNR/SSIM, ghosting and sparkle checks). In the editor the viewport's Retina target already holds 2x its scene pixels per axis, so scale 1 there draws one scene pixel per point.

write_cutscene

Create or replace a cutscene (an intro, a story beat) in the project's Cutscenes folder: a JSON timeline (format "ttr.cutscene") of keyframed fields, camera shots, timed events and a hand-off to the player. It is checked first; every mistake comes back named. Start it with a cutscene { file "name.cutscene.json" } component (autoplay) or game.playCutscene("name") in a script. The format is in script_reference.