Stages: plan a shot in 3D
Plan a shot in 3D before you spend money on a generation. Select a surface and press ⇧S / Shift+S. The Stage panel opens beside the canvas.
A stage is a simple 3D set: grey clay figures and props on a ground, measured in metres. You look at it through a camera with real lens sizes. A capture saves the camera view as a grey layout image. An image or video model then paints a real scene over that layout.
- A stage plans one generation. It is saved in the scene file.
- A stage is not a layer. It never shows on a surface or in an export.
- It has nothing to do with a surface that a project names
STAGE. - You always work in four steps: block (place) the items, frame them with a lens, capture, then generate.
Open and close the Stage panel
The Stage panel is a panel like Properties or Glimpse. The canvas stays beside it and keeps playing. Every surface keeps drawing.
- Select a surface (one LED output), or a layer in a comp that is on a surface. A comp is a named group of layers.
- Press ⇧S / Shift+S. Or choose Window › Stage, or pick open stage in the command palette.
- The panel shows the newest stage for that surface. If the surface has none, the panel shows a new stage for it.
- To switch to another stage of the scene, pick it in the stage menu at the top left of the panel.
- To close the panel, press ⇧S / Shift+S again, click × in the panel's title row, or choose Window › Stage again.
- Opening the panel never changes your scene. A new stage is saved into the scene with your first edit: you add an item, change a setting or move the camera. That edit and the new stage are one undo step. If you open the panel and close it again, the scene has no unsaved change.
- Until that first edit, the stage menu says new stage, and Capture and Generate… are grey.
- Window › Stage has a ✓ while the panel is open.
- With nothing selected, stage shows the scene's newest stage. With no stages, it shows the stage list.
- new stage in the command palette, or new stage… in the stage menu, always makes a new stage for the selected surface.
- Window › Stage and the palette's Stage panel show the stage you had last, if it is in this scene. They never make a new stage.
- The panel remembers its stage when you close it. It opens on the same stage next time.
- Move, dock, stack and resize the Stage panel like any panel. It can also be a tab in a group (Panels).
- The 3D view draws only while you can see it. When the panel is closed, folded, behind another tab or off screen, it stops drawing.
- Changing the scene shows that scene's stages.
- Every change is one undo step, for example
stage: move singer. Press ⌘Z / Ctrl+Z to undo it. - ⌘S / Ctrl+S saves the stage with the scene. Versions and recovery drafts keep it too.
- The 3D view loads the first time the panel shows a stage. Until then the view says loading 3D….
- If the 3D view fails to load, the status line says the 3D view did not load. Close the panel and open it again.
- If the panel breaks while you work, it shows an error. The canvas and the rest of the app keep working. Close the panel and open it again to reset it.
The stage list. It shows when the panel has no stage open. Its title is stages in <scene>.
- Click a stage in the list to open it. Each row shows the stage's name, its surface and its number of items.
- To make a new stage, pick a surface in for. Then click New stage.
- A stage with a mistake in the scene file is greyed. Its row says invalid: and names the first problem. Fix the scene file, then open the stage.
The panel, top to bottom
From the top, the Stage panel has a head, the tool row, the 3D view, the camera line and the details.
- The head. On the left: the stage menu (the stages of this scene, and new stage…) and for (the surface the stage is for). On the right: Capture and Generate….
- The tool row. The tools, then the view buttons, then details. Each button shows its key.
- The 3D view. Only the thirds lines and the crop band are drawn over the picture.
- The camera line, under the view: lens, distance, height and tilt. With a subject, it also shows the angle around the subject and the shot size. The status line is at its end. Under it are the framing checks.
- The details: every setting of the stage (The stage details). They are on the right of the view. When the panel is narrow (under 620 px), they are under the view.
| Button | Key | What it does |
|---|---|---|
| move | W | Handles that move the selected item along the ground. Hold ⇧ / Shift to lift it. |
| turn | E | Handles that turn the selected item. |
| size | R | Handles that size the selected item. A figure and a sphere grow evenly in every direction. |
| pose | P | Pose mode: bend the joints of the selected figure. Greyed when no figure is selected. |
| snap | X | Changes the snap step: 0.1 m, then 1 m, then off. The button shows the step, for example snap 0.1 m. |
| camera | C | Look through the render camera. Click again for the free view. |
| frame | F | Fits the selected item in the view. In camera view, it aims the camera at it. |
| details | Shows or hides the details. | |
| Capture | (In the head.) Saves the camera view as a grey layout image. It reads Capturing… while it works. | |
| Generate… | (In the head.) Captures, then opens Generations with a recipe. It reads Generating… while it works. |
- A stage with no items shows a card over the ground: Add a person and something beside them for scale. Its buttons add a + person, + mic stand, + riser, + crowd row, + LED screen or + box. The details have every shape, under items.
- The status line shows what just happened, for example captured <file>. Errors show in red.
Block figures and shapes
Blocking means putting people and props where they stand in the shot.
- In the details' items section, click a preset. On an empty stage you can also use the buttons on the ground, for example + person or + riser. It appears where the view is looking.
- Click the item in the 3D view, or in the items list, to select it.
- Press W to move it, E to turn it, or R to size it. The tool row's move, turn and size buttons do the same.
- Drag the handle that appears on the item. A move slides it along the ground. Hold ⇧ / Shift while you drag to lift it, or drag the upward arrow.
- Type a name for what it is, for example
singerorriser. - Pick a colour. Give each figure its own colour.
- The names and the colours go into the prompt. The model uses them to tell the figures apart.
- If something already stands there, the new item moves to the side until it touches nothing.
- A new figure turns to face the camera.
- A preset with several items (the crowd row, the tree) is one undo step.
- Click an empty part of the ground, or the selected row in the list, to clear the selection.
- The arrow keys move the item 0.1 m. Hold ⇧ / Shift for 1 m, or ⌥ / Alt for 0.01 m.
- The arrows follow your view: → moves the item to the right on screen, and ↑ moves it away from you. The move stays on the grid lines.
- Snap makes a drag jump in fixed steps. X (or the snap button) changes it: 0.1 m, then 1 m, then off. While moves snap, turns snap to 15°.
- You can also type pos (position, in m), rot (rotation, in degrees) and the size (in m) in the details. The size also shows in feet.
- auto under colour gives the item its own colour back: beige for a figure, grey for a prop. Point at a colour to see its name.
- In the items list, ◉ hides an item, and ○ shows it again. A hidden item is also left out of the capture.
- ⊘ locks an item, so you cannot drag or delete it by mistake. The arrow keys and delete do not work on it. The status line says … is locked.
- duplicate makes a copy beside the item. delete, or ⌫ / Backspace, removes it.
- Look around: drag to orbit (turn the view around the set), right-drag to pan (move sideways), and scroll to zoom. F (frame) fits the selected item in the view. With nothing selected, it fits every item and the camera.
Pose a figure
A figure is a clay person with 14 joints that you can bend.
- Select the figure.
- Pick a preset in the details' pose menu, for example
walk,sitormic. - To bend one joint, press P, or click pose in the tool row. This turns on pose mode.
- Click a joint. The status line names it, for example posing singer: left elbow.
- Drag the ring to turn it.
- Press Esc to leave pose mode.
- Click an empty part of the ground to let go of the joint. The figure stays selected.
- A line under the figure's settings describes the pose in words.
- build (
neutral,female,male) changes the figure's shape. - The body sliders bust, hips, waist and shoulders make that part smaller or bigger, from ×0.25 to ×8. Double-click a slider to set it back to ×1.
- joints lists every joint with three angles (x, y, z), from −180° to 180°. The section is closed at first: click its title to open it.
- reset in joints goes back to the preset's angles.
- A posed figure stays on the ground automatically. You do not need to lower a kneeling or sitting figure.
- A pose name that is not a preset draws the figure standing. The camera checks say so.
- A crowd row is five different people, with different colours, heights and builds. This stops a model from giving them all the same clothes.
Frame with a lens
The render camera is the camera the capture uses. You aim it like a real camera.
- Press C, or click camera, to look through the render camera.
- Drag and scroll to move the camera itself. Press F to aim it at the selected item. With nothing selected, it aims at the main figure.
- Pick a lens in the details' camera section: 18, 24, 35, 50, 85 or 135 mm. A smaller number is a wider view.
- Pick the frame in the details' stage section. This is the shape of the picture the model will make.
- Read the camera line and the checks under the view. Fix any warning before you capture.
- Press C again to go back to the free view.
- Lens sizes are for a 36 mm wide frame, like a full-frame photo camera.
- In camera view, ⌥ / Alt + scroll over the picture changes the lens.
- You can also type any lens from 8 to 1200 mm. Type it in the details' lens (mm) field.
- Nothing is drawn over the picture but the thirds lines and the crop band. The camera line and the checks are under the view.
- The camera section also has pos, aim (the point it looks at) and roll (tilt sideways, −180° to 180°). The camera line under the view describes the shot, for example lens 35 mm · distance 9.5 m (31 ft) · height 1.6 m (5.2 ft) · tilt down 2°. Distances show in metres and in feet.
- Frame choices: match <target> (the surface's own shape), 16:9, 21:9, 2:1, 3:1, 1:1. Under model aspects are other shapes that a model offers.
- A stage with no target uses 16:9 for match target.
- When the frame and the surface have different shapes, two thin lines show the band that lands on the surface. The on surface row names that band.
- for at the top of the panel picks the surface, or none.
- The checks warn when a subject is out of frame, or cut off at the top. They also warn when nothing is in frame, the camera is inside an item, or the lens is under 18 mm.
- A note also tells you when only a band of the frame lands on the surface.
Capture the layout
A capture saves the camera view as a grey image. This is the image the model reads.
- Frame the shot through the camera.
- Click Capture at the top right of the panel.
- Wait a few seconds. The status line names the new file, for example captured stage-1-3f9a0c2e.png. You can keep working while it captures.
- The image goes to
assets/stages/<scene>/. Its name is the stage's id and a short code. It is an ordinary asset: it shows in Assets, and you can drag it onto a comp. - The capture is 2048 pixels on its long side, in the frame's shape. The details' capture row shows the size, for example 16:9 · 2048×1152.
- To change the size, set
capture: { longSide: … }on the stage in the scene file. It takes 256 to 4096 pixels. - It captures what you see, with your unsaved changes.
- A new capture is one version (a saved snapshot of the project), named
stage: capture <scene>/<stage>. - If nothing changed, Starlight reuses the last capture. The status line says unchanged: <file>.
- If a capture fails, the status line says capture failed: and why.
- The details' captures list shows each capture, newest first. Each row has a small picture, the size, the time and the file name.
- Under each capture are the generations made from it, as status · model · grade.
- The capture is exact. The 3D view shows the same framing, but its shading is a little different.
Generate from a capture
A recipe is a ready-made setup. It sends the capture to a model, with a prompt that describes the layout.
- Click Generate… at the top right of the panel and pick a recipe (see Presets and recipes). Each row shows the model it uses on the right.
- Starlight captures the stage, or reuses the last capture.
- The Generations panel opens with the form filled in. The status line says <recipe>: Generations has <file>.
- After the layout text in the prompt, add what the picture should show. For example: "a packed arena at night, haze, one warm spot on the singer".
- Check the price, then click generate.
- Generate… is greyed when no model in the list takes a layout. Capture and Generate… are also greyed on a new stage until you add something.
- The form gets the recipe's model and the layout in the right input. It also gets the frame's shape, if the model has that option.
- The prompt starts with a paragraph about the layout. It says what each item is, how big it is and where the camera stands. Your stage notes come after it.
- The stage's target surface becomes the form's for surface.
- The job is named stage <name> · <recipe>.
- The result's preview has a stage <id> button. It takes you back to this stage. It is greyed while another scene is open: open the stage's scene first.
A grey first frame makes the video start grey. For surface video, first make a still image from the layout (Video for a surface).
The stage details
The details hold every setting of the open stage. They are on the right of the view, or under it when the panel is narrow. The details button in the tool row shows or hides them.
| Section | What it holds |
|---|---|
| stage | name and frame (the surface is for, at the top of the panel). Then two rows you cannot edit: capture (the size) and on surface (the band that lands on the surface). Last, the notes box for the prompt. |
| stage: delete | Click delete, then sure? within 3 seconds. This deletes the stage. Its captures stay. |
| items | The number of items, then every item with its colour, name and size, ◉ (show or hide) and ⊘ (lock). The preset buttons (+ person and the others) add new items. |
| the selected item | name, the size, pos, rot, colour and auto. A figure adds pose, build, the body sliders and joints. Every item except a figure or a sphere adds shadow. Untick it when the item should cast no shadow, for example a roof over the set. At the top: duplicate and delete. |
| camera | lens (mm) and the lens buttons, pos, aim and roll. The camera line and the checks are under the view. |
| captures | The number of captures, then each capture with the generations made from it. |
- A name is saved when you press ⏎ / Enter or click somewhere else.
- The notes are saved when you click somewhere else. ⏎ / Enter starts a new line in them.
- In a name or the notes, Esc puts the old text back.
- An empty name uses the stage's id, or the item's kind.
- The numbers follow a drag while it happens.
- Click a section's title to close or open it.
Presets and recipes
These are the ready-made items, poses, lenses and recipes.
| Kind | Presets |
|---|---|
| Shapes | box, cylinder, cone, sphere (each 1 m) |
| People | person (1.75 m), crowd row (five people, 0.7 m apart) |
| Stage pieces | riser (8 × 0.6 × 4 m), truss (12 m long, 0.4 m square, 6 m up), speaker stack (1.2 × 3 × 1 m), mic stand (1.6 m tall), LED screen (6 × 3.4 m), backdrop (20 × 8 m) |
| Other | car (4.5 × 1.5 × 1.8 m), tree (a 6 m trunk and a crown: two items) |
| Poses | stand, walk, step, kneel, kneel-one, sit, sit-edge, crouch, lie-back, lie-front, bend-over, reach-down, all-fours, kneel-forearms, arms-up, hands-on-hips, wave, point, mic. |
| Lenses | 18, 24, 35, 50, 85 and 135 mm. You can type any lens from 8 to 1200 mm. |
| Builds | neutral (the default), female, male. |
| Recipe (in generate) | Model | The layout goes in as |
|---|---|---|
| Image from layout · Nano Banana (the default) | Nano Banana Pro, Pro Flash or 2.1 | a reference |
| Image from layout · Seedream | Seedream 5 Pro, 4.5, 5 Lite or 4 edit | a reference |
| Structure-locked image · Mystic | Mystic | the structure reference, which keeps the shapes most exactly. It also sets structure strength 50 and adherence 75. It adds a prompt line that gives the figures clothes. |
| Video from layout · Seedance (reference) | Seedance 2 Pro, 2.5 Pro or 2 Fast | a reference, never the start frame |
- A recipe uses the first model of its list that is available.
- A recipe shows only when its model is in the list.
- All recipes use Magnific models. To run one, you need the Magnific key (Settings › Keys).
- Magnific One is never offered. It draws the clay as wooden dolls.
- Claude can also build, read and capture stages (Claude). Claude captures the saved scene. The app captures what you see.