# SHOT OF THE DEAD — OFFICIAL USER GUIDE

For: SHOT OF THE DEAD users, including people who have never used 3D software
Language: English

## What this tool is for
SHOT OF THE DEAD is a 3D previs tool for arranging a location, figures, and a camera, testing lenses and framing, then saving and comparing useful shots. It is not for building detailed 3D models.

## Getting-started walkthroughs

### Start here
Open a location, place a figure, and make your first shot.
1. Know the goal: This is not a tool for building detailed 3D models. It is a place to arrange a location, figures, and a camera until you find a shot worth keeping.
   - You do not need to learn shooting or recording yet.
2. Open a location: Choose a card in Locations at the upper-left. If a 3D space is already visible, you can continue to the next step.
   - A supplied sample location is enough for your first try.
3. Move the camera: Left-drag in the 3D view to look around. Vertical rotation continues past the 90° straight-down view, through an upside-down view, and around the full 360°. Use the mouse wheel or trackpad scroll to move forward and backward.
   - The wheel moves the camera. It does not change the lens.
4. Place and pose a figure: Drag Blockman from Assets at the lower-left into the 3D view and drop it where you want. If dragging is difficult, select Blockman and press Place in Scene below the list. Select the placed figure, then choose a different posture from the Pose tab on the right.
   - While dragging, a ghost shows the landing point on the surface under the cursor, so rooftops and platforms work too. After placing, press G to move horizontally, then Y to move vertically. With the mouse, hold Y while right-dragging to move vertically; release Y to return to horizontal movement. Press R to rotate.
5. Try the lens and framing: The numbers 24, 35, 50, 85, and so on below the view are lens focal lengths in millimeters. A smaller value shows more of the scene; a larger value gives a tighter view. Try them together with camera position.
   - Start with 50mm if you are unsure.
6. Save the shot: When the framing works, press Shift+A to save it and add it directly to Cut List. Then open Cut List in the top bar to review the shot you kept.
   - The film-shaped button saves without adding. You can select a saved shot and press A to add it later.

### Using figures
Place a figure, customize its pose, and save it to My Pose.
1. Place a figure in the scene: Drag Blockman from Assets at the lower-left into the 3D view. If dragging is difficult, select the figure and press Place in Scene below the list.
   - Assets are reusable sources. The placed list under the Layers tab holds the figures in the current location. You can place the same figure more than once.
2. Adjust position, direction, and floor: Click the figure to select it and show the Pink outline. Press G to move horizontally, then Y to move vertically. With the mouse, hold Y while right-dragging to move vertically. Press R to rotate, and F to drop it onto the first upward-facing surface below it (the floor when nothing is there). Use the Position panel in the Basic tab for exact coordinates.
   - Use the hips as the rotation center for sitting or lying poses. Use the feet when changing the direction of a standing pose.
3. Choose a base pose and fine-tune it: Open the Pose tab on the right and click a standard pose. Once the figure takes that posture, open Fine tune and adjust the face, upper body, arms, and legs for your shot. To lean a seated figure forward or back, use Hips forward/back, which tips the upper body while the legs stay where you placed them.
   - Clicking the standard pose again restores its clean default before fine-tuning.
4. Use Mirror and arm matching for different jobs: With Mirror on, the opposite side moves too while preserving the current left-right difference. Right arm ← Left arm and Left arm ← Right arm match the entire arm, from upper arm through wrist, one time.
   - Mirror moves both sides while keeping their difference. Arm matching makes their shapes the same. You can match first, then continue with Mirror.
5. Rotate the whole figure while fine-tuning: Keep Fine tune open and press R to rotate the whole figure horizontally without changing its joint shape. Change the viewing angle, then continue adjusting the joints.
   - To raise, lie down, or tilt the whole body, use Basic, choose Hips as the rotation pivot, and adjust forward/back or side tilt. Feet is the natural pivot for turning a standing figure.
6. Save to My Pose: When the adjustment is ready, choose Register in My Pose in the Pose tab, name it, and save it. You can apply the saved pose to compatible figures and in other scenes.
   - If you edit an applied My Pose and save again, it creates a new My Pose without overwriting the original.
7. Move and duplicate several figures together: In the placed list under the Layers tab, Cmd-click on macOS or Ctrl-click on Windows to multi-select, or Shift-click to select a range. Group changes position, rotation, and size together. Press the overlapping-squares duplicate icon to copy one figure or every selected figure while preserving their arrangement.
   - The new copies are selected after duplication. Use Individual when you want to change each figure's values without moving the spacing between them.

### Your first shoot
Record a take and keep the best one in Cut List.
1. Prepare what you want to shoot: In the 3D view, open a location and place the figures or Blocking Boxes and Walls you want to film. Set the opening camera position and lens here too.
   - A figure or asset must already be placed in the 3D view before you can animate it in a take.
2. Enter Shooting mode: Open Shooting in the top bar. The view you currently see in 3D becomes the camera position where the take begins.
   - Recording settings shows the current destination without truncation. Change storage folder switches the root used for projects, media, recordings, and exports—not recordings alone.
3. Shoot locked off or operate live: Press the round red REC button directly below the Shooting tab to start recording. Leave the camera still for a locked-off shot. While recording, use left-drag, middle-drag, the wheel, or WASD and Q/E, and those live camera moves are recorded into the take.
   - This is the fastest way to shoot. You do not need to animate the camera beforehand.
4. Repeat a planned camera move: For a move you want to repeat precisely, set Start and End under Camera motion. When both header dots turn pink, Apply to REC switches on automatically, and the configured actions become ✓ Update start and ✓ Update end. Duration and pre-roll accept 0.1-second values; Ctrl/Command with Up or Down adjusts by 0.1 seconds. If you operate the camera during the take, your live operation takes control from that point.
   - Apply stays unavailable until both endpoints exist, and turning it off keeps them. Use the wheel, +/− buttons, or keyboard +/− to zoom Motion Map from 50% to 6400%. View and World remember separate zoom and pan positions; FIT returns to 100%.
5. Move figures and assets: Select the object and set Start and End under Asset motion. When both header dots turn pink, Apply to preview/REC switches on automatically. Speed 100 keeps the original normal range, 200 is a dash guide, and 300 is the extreme range for fights or lunges. It can run in the same take as the camera motion.
   - Choose Linear, Curve, or Waypoint. For an L-shaped route, choose X → Z or Z → X, then drag the diamond on the map to adjust the corner. Waypoint motion rounds the corner slightly and travels at constant speed. Preview before REC.
6. Record and choose a take: Press Shift+Space first for a full rehearsal of the camera and asset motion without recording. When it works, press the red REC button or Enter to begin and Space to stop. Recorded takes stay in the list. Double-click a take to play it, then select the one you want to keep.
   - Rehearsals are not saved. Try as many takes as needed; failed takes do not have to enter the cut list.
7. Keep it in Cut List: Select the take and press Add to Cut List. It becomes a cut with video that you can place next to the shots before and after it.
   - You can return from Cut List and revise the recording later.

### Using Cut List
Arrange cuts, revise them, and export one video.
1. Look at Board: Open Cut List in the top bar and start with Board. The left header shows active / total cut counts and total duration; Active only switches the duration to included cuts and hides paused cuts without deleting them. Drag from empty space to marquee-select cuts, then drag one selected card to move the selection in story order. The tune icon at the end of the left header opens Display settings for Still default duration, thumbnail size, Output frame, and Timecode. At narrow widths, marker choices move into the filter pop-up.
   - With multiple cuts selected, inspector markers apply to the whole selection: add when some cuts lack the marker, or remove when all have it. Marker names and notes remain per cut. For a cut to revisit later, add a color or icon marker in the right inspector, then give that marker a name such as Needs review and a multiline note. Drag the note field's lower edge to make it taller.
2. View cuts by location: By Location automatically groups cuts recorded in the same location. Use it in scenes with multiple locations to see what was shot where.
   - Return to Board when you want to reorder the cuts.
3. Play the scene flow: Switch to the Player tab at the top to play only included cuts in their listed order and for their used durations. With Timecode enabled in Display settings, video shows SEQ for the Cut List position and CLIP from the cut's own zero; Board cards show both fixed start-to-end ranges. Use Left / Right Arrow for the previous or next playable cut and Home / End for the first or last. J plays in reverse, K toggles play and pause, and L plays forward. Repeated J or L presses increase speed through 1x / 2x / 4x / 8x. Clicking the large preview only selects the current cut; it does not play or pause. Turning on a composition guide switches to Player and overlays the same guide state used in 3D and Shoot. Manual guides dragged from the rulers are shared too.
   - Excluded cuts are hidden from the strip by default. Show N excluded cuts restores them temporarily in story order, and the eye button includes them again. Recorded Takes and still cuts use the same Player controls.
4. Fix only the cut that fails: Select the cut you want to revise. For a still, use Record this cut as video to restore its saved 3D state in Shoot. You can record multiple takes, but only the one you select replaces that same cut; the others leave the take list, while any MP4 files that finished saving remain in the recording folder. For a video cut, use Reshoot to restore its saved actor path, speed, pre-roll, and camera motion.
   - You can confirm the conversion after the selected MP4 finishes saving. Double-click the still instead when you only want to revise its composition in 3D.
5. Export one joined video: Press the full-width Export button at the top of the right column, then choose All cuts, Active only, Marked, or Current cut only. Join cuts into one video creates one MP4; Export each cut writes stills as PNG and videos as trimmed MP4. Auto file names use four digits such as 0001 for both All cuts and Active only.
   - With Burn in timecode enabled, choose Sequence TC, Clip TC, or Both. Still and video used durations accept tenths of a second, for example 3.5 to 3.2 seconds. Totals appear as 15.0s or 2m 09.5s. File name options can add both numbers as A0001_0015, markers, and the location. Video first frames are full-resolution PNGs; original recorded videos stay full-length and unedited.

### Import a location with Marble
Import a 3D location created and downloaded with Marble using the correct two files.
1. Create a World from a photo: Open Marble Web, add a real-location photo, and generate a World. SHOT OF THE DEAD does not convert the photo itself; wait for Marble to finish before importing the downloaded files.
   - The Free plan lets you try World generation, but it does not export the two files required by SHOT OF THE DEAD.
2. Use the SHOT OF THE DEAD settings: Set Marble Download to SPZ / OpenCV / Ground level / Textured. For this import path, OpenGL or Eye level can produce the wrong orientation or floor height.
   - Visual check: the settings row should read SPZ → OpenCV → Ground level → Textured in that order.
3. Download two files: Using the export feature in Marble Standard or higher, download one Splats .spz for the visible appearance and one Collider Mesh .glb for placing figures and objects on the floor. The import needs both files.
   - Visual check: your Downloads folder should contain one .spz and one .glb with different extensions. Check https://marble.worldlabs.ai/pricing for current pricing and commercial-use terms.
4. Open the Marble importer: In SHOT OF THE DEAD, choose Add Location at the upper-left, then open Import from Marble.
   - Use the Marble-specific entry, not Import GLB/GLTF Location for a regular 3D model.
5. Choose the SPZ and Collider Mesh: Choose the .spz in Splats, choose the .glb in Collider Mesh, then press Import 2 files. Do not substitute a high-detail display mesh for the Collider Mesh.
   - If format validation stops the import, reselect the original pair of downloaded files.
6. Check orientation, floor, and scale: Orbit the preview and confirm that the horizon is level, walls point upward, and the floor sits under a figure's feet. Place an approximately 1.8m Blockman and compare it with doors or furniture to check real-world scale. When all three checks pass, press Add this location to the Library.
   - Checking orientation, floor, and scale before saving prevents a larger rebuild after blocking begins.
7. Fix common failures: For an upside-down result or floor offset, download the SPZ again with OpenCV / Ground level. If figures cannot stand on the location, confirm that the Collider Mesh .glb was selected. For a scale mismatch, compare against the approximately 1.8m Blockman. Regular .glb, .gltf, or .zip locations use Import GLB/GLTF Location, not Marble's two-file path. GLB imports open as a separate location without the previous location's placed objects. Reopen the original from the Library.
   - Before rotating or moving the imported world by hand, recheck the Marble Download settings and the two selected files.

## Task guide

### Create a 3D location from photos or import a 3D location
Reconstruct photos outside the app, then import a supported location file
Common user wording: photo to 3D, make photo 3D, convert photo, import location, Marble, SPZ, GLB, GLTF, Collider, 3D scan
- SHOT OF THE DEAD does not convert a photo into a 3D space inside the app, so first use an external photo-to-3D service such as Marble Web.
- Marble Free lets you try World generation, but exporting your own Splats (SPZ) and Collider Mesh (GLB) requires Standard or higher. Commercial use of generated content requires Pro or higher. Check https://marble.worldlabs.ai/pricing for the latest terms.
- Open Download for the generated World in Marble Web and save Download settings as SPZ / OpenCV / Ground level / Textured. Do not use OpenGL or Eye level because orientation or floor placement may be wrong.
- From the same Download menu, download one Splats .spz file and one Collider Mesh .glb file. In SHOT OF THE DEAD, choose Add Location at the upper-left → Import from Marble and select both files.
- For a regular 3D location, .glb is recommended. .gltf and .zip files containing GLB/GLTF are also supported through Add Location → Import GLB/GLTF Location. File size, geometry counts, and estimated decoded textures are checked before loading. Review a warning to continue or cancel. If the limit is exceeded, reduce texture sizes or remove unnecessary geometry in Blender and export again. To move signals or streetlights, exclude them from the background and export separate GLBs. Use Add → Blocking → 3D MODEL (GLB), up to 50MB per file, to retain their meter scale, origin, and original colors, then move or hide them in Layers. Parts inside a background GLB cannot be edited individually.
- To place the photo as a flat image without reconstructing it, use Blocking on the right → Image.

### Move the camera
Look direction, camera position, and lens
Common user wording: move camera, move view, look around, pan, tilt, overhead, straight down, upside down, 360 rotation, full rotation, forward, backward, up, down, wheel, WASD, lens, focal length, millimeter, far away, get closer, travel is slow, double-click, go to that spot
- Left-drag: change where the camera looks. Vertical rotation continues past straight down, through an upside-down view, and around the full 360°. Press V to cycle speed and B to cycle drag inertia through Off, Low, Medium, and High. These controls are also available in the Shooting bar.
- Middle-drag: move the camera up, down, left, or right. Hold Shift while middle-dragging to lock movement to the first horizontal or vertical direction.
- Wheel or scroll: move the camera forward or backward.
- T or the target button: choose a figure or object in the frame and keep looking toward it. Turning the target off clears the old target position, so the next activation always asks you to choose again. While targeting, Escape keeps the mode on and starts a fresh target pick.
- Double-click a floor or a surface: the camera flies there. An upward-facing surface puts you standing on top of it; an upright surface such as a wall stops at the distance where the whole object fits the frame. This saves travelling to a distant spot in small steps.
- 24, 35, 50, 85, and so on below the view: change lens focal length in millimeters. This is separate from the wheel.

### Keyboard shortcut reference
Check every main key for 3D, Shoot, and Cut List, including B
Common user wording: shortcut, shortcut list, keyboard controls, key list, B, B key, shortcut B, Shift B, Shift+B, JKL, J K L, key display
- B: cycle the left/middle-drag assist strength in 3D and Shoot. Shift+B is a separate command: reverse to the counterpart angle for the selected pair.
- Camera: W/A/S/D move forward/back/sideways; Q/E move vertically; V cycles move speed; Shift+V toggles direct/smooth key movement; T sets a look target; digits enter lens mm; [ lowers blur by one tick and ] raises it by one tick; F1 opens Controls.
- Placed assets: G moves horizontally, G then Y moves vertically, R rotates, F drops to the floor, Delete/Backspace removes, and Escape clears or cancels.
- Shots: C saves, Shift+A saves and adds to Cut List, Shift+C takes a screenshot, and A adds/removes selected saved shots from Cut List.
- Cut List Board: Arrows move selection, Cmd/Ctrl+A selects all visible cuts, Cmd/Ctrl+Shift+H excludes/restores playback, W revises, D duplicates, and Delete removes.
- Cut List Player: Left/Right moves between playable cuts; Home/End goes first/last; J reverses; K or Space plays/pauses; L plays forward. Repeated J/L cycles 1x/2x/4x/8x. J/K/L are not 3D-view controls.
- Global: Cmd/Ctrl+Z undoes and Cmd/Ctrl+Shift+Z redoes. Escape clears or cancels the current operation, but it never switches Shooting or Cut List back to the 3D tab. 3D shortcuts are intentionally ignored while typing in a field or using a modal.

### Change lens, frame, and composition guides
Adjust focal length, frame ratio, and composition overlays
Common user wording: change lens, field of view, focal length, 24mm, 35mm, 50mm, 85mm, aspect ratio, vertical video, horizontal video, rule of thirds, golden ratio, composition guide, imaginary line, reverse angle, REV, Shift B, conversation scene
- The view automatically keeps people and objects proportional when you switch locations. Camera position is saved while Motion Map is closed; reopening it shows the current position. Offline recordings also follow curved subject motion and retain recorded lens changes.
- The numbers 24, 35, 50, 85, and so on below the view are lens focal lengths in millimeters. Smaller numbers are wider; larger numbers are tighter.
- If you are unsure, start at 50mm and move the camera forward or backward to find the frame. The wheel moves the camera; it does not change the lens.
- FF and S35 beside the lens select sensor size. The same 50mm lens gives a tighter view on S35 than on FF. Turn Blur / Focus on, then use the eyedropper to choose a subject. The ticked None—Large scale controls blur; [ lowers it by one tick and ] raises it by one tick. None turns it off and turning it on again restores the previous amount. Composition lock and the eyedropper can be used in either order: both follow the same target through lens changes. Distant backgrounds blur more with longer lenses. The eye button shows or hides the focus plane.
- Use Frame settings in the top bar to choose a horizontal or vertical frame ratio and how the final output should be framed.
- Use Composition Guides in the top bar for thirds, center, golden ratio, and custom guides. The same state appears in Cut List Player, so adjacent shots can align head or eye position; ruler-dragged manual guides are shared too. These guides are not burned into saved images or videos.
- The selected pair’s posed head centers define the conversation line. Outside the actor span, REV or Shift+B moves to the counterpart angle while staying on the same side of the line. Inside the span, the camera stays in place and pans to the partner. Without changing the camera, figures, pair, or lens, run REV again to restore the exact starting position and orientation. REV is unavailable when the horizontal head positions nearly coincide.
- Use the up-arrow section of REV to set the conversation pair and optionally show the 180° line. REV works while the line is hidden, and you can move the camera across it manually at any time. Two figures pair automatically; with three or more, choose the partner first.

### Adjust the floor, sky, sun, and fog
Set how the ground and the light of the whole location look
Common user wording: stage, floor, grid, floor color, floor shape, circular floor, floor size, sky, sky color, background color, sun, sun direction, sunlight, time of day, morning, evening, midday, backlight, too dark, brightness, fog, haze, mist, horizon, zenith, outdoor
- Open the Stage tab in the lower-right panel. The floor and the Sky and light controls are gathered there.
- Base (floor and grid) holds Floor size, BASE floor display (Floor + Grid or Grid Only), Floor shape (Square or Circle), and Floor color. This section does not appear for a location that has no BASE floor.
- Turn Sun on under Sky and light to reveal Sun direction and Sun height (dawn/dusk to noon). Moving those two changes the sky color, the way light falls, and the fog color together. The height value is labeled After sunset, Dawn / dusk, Daytime, or Midday next to the number.
- Turn Show shadows on to cast lightweight sun-driven shadows on characters and sets. Lower sun height produces long dawn or dusk shadows; higher sun produces shorter midday shadows. Shadow opacity changes their visibility, and turning the option off stops the shadow pass.
- With Sun off, the sky is a single color: open Advanced and set Background color. Newly created scenes start with Sun on, while scenes you made before this feature open with Sun off, so their existing look does not change.
- With Sun on, Advanced lets you switch Sky colors from Auto from sun to Manual and set the lower-sky ground, horizon, and zenith colors separately.
- The Fog toggle mutes the haze while keeping your settings. Set the amount with Fog strength (0 = Off). With Sun on, Height fog base altitude and Height fog falloff also appear so the haze can thin out with altitude.

### Read the screen and resize the panels
What each lower-right tab holds, and how wide the sidebars are
Common user wording: cannot find panel, where is, which tab, Stage tab, Add tab, Layers tab, inspector, sidebar, resize panel, widen panel, screen too narrow, bigger 3D view, last location, resume, reopen
- The lower-right panel has three tabs: Stage, Add, and Layers. Stage holds the floor and the sky and light, Add holds Blocking and My Objects, and Layers lists everything placed in the current location.
- A Layers selection opens directly below the list. Its name stays in the Basic or Pose row, with icons on the right to expand or collapse the Inspector. In Stage or Add, use Open editor in the Selected bar to open the same Inspector.
- Drag the boundary to resize the 3D sidebars or the right Inspector in Shoot and Cut List. Widen it when names are cut off, or narrow it for a larger view. Double-click the boundary to reset its width and use the triangle rail on the right to close or reopen it. Each workspace remembers its own width.
- Add locations from Add Location at the upper-left. The location you open is remembered, so reloading the page resumes in the location you had open last.
- Saving or reshooting a shot automatically updates that location card with the latest finished frame. Duplicated locations with different blocking or compositions are therefore easier to tell apart.
- Turn on Key Display from the More menu at the lower-right when recording a tutorial. The HUD shows the current control, including combined mouse-and-key actions such as right-drag plus Y.

### Place figures and objects
Add figures, Boxes, Walls, and Images
Common user wording: place figure, add person, place asset, add Box, add Wall, place image, blocking, place on a rooftop, place on a desk, place on top of, place up high
- Drag a figure from Assets at the lower-left into the 3D view, or select it and press Place in Scene below the list.
- While you drag, a ghost shows the landing point on the upward-facing surface under the cursor, so you can drop a figure directly onto a rooftop, desk, or platform. It does not stick to upright surfaces such as walls, and where there is no upward-facing surface it lands at origin height as before.
- Use Blocking in the Add tab at the lower-right to add a Box, Wall, or Image.
- Click an object in the view to select it.
- If it is lost, use the magnifier for the selected object.

### Select objects and lock their placement
Choose what to edit while protecting position and size
Common user wording: select, multi-select, select together, clear selection, placement lock, P key, lock, cannot move, cannot click, key icon, placed assets, layers, hide wall
- Click a figure or Box in the 3D view to select one object. In BASE, image, and GLB locations, selected figures get a Pink silhouette outline, with the last selected figure's name and the selection count shown. Hover a figure to see its name. SPZ locations use the previous selection frame.
- Hold Cmd on macOS or Ctrl on Windows while clicking to add individual objects or other groups to the selection. Shift-click selects a range in Layers.
- Press Esc or click empty space to clear the selection.
- To keep a floor, wall, or background in place, select it and press P, or press the four-arrow button in its Layers row. The icon turns Pink while placement is locked.
- A placement-locked object remains selectable in the 3D view and Layers, and you can still change its color, opacity, and visibility. Moving, rotating, resizing, and grounding are disabled; the selection outline remains visible but the gizmo does not.
- Press H to hide a wall completely, then restore it with the eye button in Layers.
- The key icon is a stronger edit lock: the object cannot be picked in the 3D view and stays read-only until you unlock it from Layers. The reset menu above Layers can clear placement locks, edit locks, or both.
- To make figure outlines easier to see, open the gear menu, then Advanced settings > Controls > Adjust while viewing outlines. The panel on the right controls Width (all selections), Last selected opacity, and Other selections opacity. These preferences are saved in this browser, and the outlines do not appear in saved images or exported video.

### Change a figure's pose
Choose a standing, sitting, walking, or other pose
Common user wording: pose, posture, sit, stand, walking pose, crouch, change figure pose, fine tune, lean forward, lean back, bend the upper body, hips pivot, hip joint, straighten the elbow, straighten the knee, forward bend
- Click the figure whose pose you want to change in the 3D view.
- When the selected figure supports poses, open the Pose tab at the top of the Inspector on the right.
- Click a pose thumbnail to apply it to the selected figure.
- Use Size below the pose list and My Pose to scale the whole Blockman or figure. Then use Orientation for the pivot (feet or hips), Y facing, forward/side tilt, and angle snapping. The same Size and Orientation controls remain in Basic.
- With only one figure selected, open Fine tune to move the face, upper body, arms, and legs one degree at a time. To lean a seated figure forward or back, use Hips forward/back: the upper body pivots at the hip joint while the legs stay exactly where you placed them, all the way to a deep forward bend from a sitting position.
- Elbows and knees straighten fully even in seated poses. If an arm or a leg will not extend, check its joint slider instead of tilting the whole figure.
- If the Pose tab does not appear, that figure does not currently support pose switching. Supported figures also provide Fine tune and My Pose in this tab.

### Move, rotate, size, and duplicate
Adjust the position and shape of placed objects
Common user wording: move object, rotate, tilt, roll, resize, make bigger, make smaller, width, height, depth, drop to floor, drop down, duplicate, copy object, coordinates, XYZ, reset to zero, gizmo, move vertically, F key
- Press G to move horizontally. Press Y after G to move vertically, and G again to return to horizontal movement. With the mouse, right-drag horizontally and hold Y only while you want vertical movement.
- Press F to drop the selection onto the first upward-facing surface directly below it. It lands on a rooftop or a desk when one is there, and falls to the floor (0m) only when nothing is underneath.
- To move onto a rooftop or Box top that is not directly below, press Pick destination position under Grounding, then click the exact placement point in 3D. A single object's anchor, or the center of multiple objects or groups, moves to that point without breaking the arrangement. Press Esc to cancel.
- The XYZ gizmo stays a usable on-screen size at any camera distance and follows the dragged screen distance. If the origin is off screen, the gizmo appears at the frame edge as a proxy.
- In the Position panel under Basic, enter X/Y/Z coordinates directly or nudge by 0.1m, 1m, or 10m. Click an X, Y, or Z axis label to reset only that coordinate to 0m.
- Use Width, Height, and Depth on the right to adjust size.
- With multiple objects selected, Group changes the whole arrangement and Individual changes each object.
- Option-drag to duplicate. Add Shift to constrain the movement axis.

### Duplicate and line up blocking shapes or GLB props
Copy the same shape and place it along a constrained axis
Common user wording: duplicate, copy, same Box, same Wall, make more, repeat object, Option drag, Shift Option, clone
Availability: Available when an unlocked blocking primitive or imported GLB prop is selected in the 3D view.
- Hold Option and left-drag on a blocking shape or GLB prop to create a copy with the same dimensions, rotation, and color, then move it immediately.
- If multiple blocking primitives and GLB props are selected, the entire arrangement is duplicated together.
- Also hold Shift to constrain movement to a world axis and snap by the selection's width or depth.
- You can also Option-left-drag an XYZ gizmo axis to duplicate along that axis. Cmd/Ctrl+Z removes the whole completed duplicate operation in one step.
Alternatives and notes:
- For figures and images, use Duplicate under Layers. Press Esc to cancel a GLB duplicate drag.

### Treat Boxes or Walls as one group
Organize assembled shapes in layers, then move or reorder them without breaking them apart
Common user wording: group, combine, subgroup, nested group, group by building, reorder layers, move together, rotate together, resize together, ungroup, edit group
Availability: Select at least two unlocked Boxes or Walls. Groups containing figures and nesting deeper than two levels are not supported.
- Cmd/Ctrl-click at least two Boxes or Walls, then press Group in the placed list under the Layers tab. After grouping, Cmd/Ctrl-click can add another group or individual object to the selection.
- Open the group's … menu and choose Edit group to expand its Boxes or Walls directly below the group row. Press the check on the row when editing is finished. Double-click the group name to rename it.
- While editing a parent group, select at least two of its blocks. Group as subgroup appears directly after the selection. You can duplicate the subgroup or use its … menu to remove it from the parent.
- Drag the handle at the left of a row to reorder items only within the same level. An item never crosses into another parent or a third nesting level.
- While grouped, Move, Rotation, Tilt, Roll, and Size preserve the arrangement as one object. Ungroup keeps the child objects.
- An … menu opens inline directly under its row. Clicking another … or the 3D view closes it, and only one menu stays open.
Alternatives and notes:
- Group / Individual shown during multi-selection only controls the current transform. It is separate from a saved logical group.

### Register a built shape in My Objects and reuse it
Place the same arrangement in another scene or project
Common user wording: My Objects, register object, save shape, use in another scene, use in another project, reuse, rename object, unregister, template
Availability: Groups made only from ordinary Boxes, Walls, and Planes can be registered. Groups containing figures are not currently supported.
- Build and group a shape from Boxes or Walls, then choose Register in My Objects from the group's … menu.
- Give it a name. It will appear under My Objects in the Add tab at the lower-right.
- Click a My Objects row to place a new copy in the current scene. The same library is available in other scenes and projects.
- Double-click the row to rename it. Use the … menu to rename or unregister it. Unregistering does not remove copies already placed in scenes.

### Undo, redo, and delete
Recover from unwanted changes safely
Common user wording: undo, redo, go back, reverse action, Cmd Z, delete, remove, Delete key, mistake
- Press Cmd/Ctrl+Z to undo the latest placement, movement, rotation, size change, duplicate, or similar edit.
- Press Cmd/Ctrl+Shift+Z to redo an undone operation. Editing after Undo clears the previous Redo branch. You can undo the new edit.
- Delete removes the currently selected placed object, saved shot, or Cut List item, depending on the active workspace.
- A drag or slider gesture undoes as one complete operation. A quick second drag or button command keeps its own Undo step.

### Save and arrange shots
Keep framing, then compare it in Cut List
Common user wording: save shot, save framing, create an alternative, another angle, add to Cut List, arrange cuts, connect cuts, compare shots, Shift A, film button
- Set the framing and lens in the 3D view.
- Press Shift+A to save and add directly to Cut List. The film-shaped button saves without adding. If one saved shot is active in SHOTS, C and Shift+A insert the new shot directly after it. With no active shot, the new shot is appended at the end.
- In SHOTS, select one or more shots and use Duplicate to copy the same framing directly after the selection. Saved Shots has no fixed shot limit.
- Open a saved shot and choose Create an alternative from this shot to restore its location, placed objects, figure poses, lens, and camera for 3D exploration. The original stays unchanged; press C to save the result as a new shot.
- Open a saved shot and choose Re-edit this shot to revise it. Press Enter to update that same shot with the new composition, or Esc to return to the state from before the revision.
- Open Cut List in the top bar.
- Drag shots into order and compare how adjacent frames connect.

### Edit, compare, and export the Cut List
Review adjacent stills and video Takes as one sequence
Common user wording: Cut List, change order, reorder, duplicate cut, delete cut, needs review, review flag, cut note, shared comment, ungroup, change comment cuts, decimal seconds, Display settings, Output frame, Timecode, continuity, compare cuts, play, reverse playback, J K L, first cut, last cut, exclude from playback, excluded cuts, paused cuts, active number, cut number, file name, zero padding, export, previs video, stills ZIP
- Board keeps every cut in story order. The Active only button beside the total count hides paused cuts without deleting them and restores them to their original positions when turned off. When it is on, the original all-cut number stays plain, such as 15, at top left, while the pink number at bottom left shows playback order 1, 2, 3... Drag from empty space to marquee-select multiple cuts, or hold Cmd/Ctrl while drawing to add them to the current selection. Drag any selected card to move the selection together while preserving its internal order. Use the eye button or turn Include in playback off to pause a cut without deleting it; it remains dimmed. Cmd/Ctrl-click adds individual cuts, Shift-click selects a range, Cmd/Ctrl+A selects all visible cuts, and Cmd/Ctrl+Shift+H excludes or restores the selection together.
- With multiple cuts selected, inspector markers apply to the whole selection: add when some cuts lack the marker, or remove when all have it. Marker names and notes remain per cut. For a cut to revisit later, add a color or icon marker in the right inspector, then give that marker a name such as Needs review and a multiline note. Drag the note field's lower edge to make it taller. Hover the marker in Board or Player to read the name and note, and use the matching marker at the top to filter those cuts.
- Marker names and individual notes appear in one line below each thumbnail. Open N more for the full right-side list when there are several; Note N counts individual notes only, while shared comments appear separately in strips with an automatic subtle color for each range. Select multiple cuts, press Comment on these N cuts, enter the Shared comment, then click outside the field to save. To change its members, press Change comment cuts, select them again, then Confirm N cuts. Ungrouping keeps the comment as an individual note on the first cut. Deleting a comment keeps the cuts. Playback for only that range or with surrounding cuts is not available yet; use the regular Player.
- Player shows only included cuts by default. Use Left / Right Arrow for previous / next playable cut, Home / End for first / last, J for reverse, K for play / pause, and L for forward. Repeated J / L presses select 1x / 2x / 4x / 8x. Clicking the large preview only selects the current cut; it does not play or pause. Show N excluded cuts temporarily restores paused cuts in story order so the eye button can include them again.
- To try another angle without replacing the original, select a cut and press Explore another angle in 3D (O) in the right inspector, or press the letter O key. Its saved location, assets, poses, lens, and camera return to 3D. Save the result as a new cut. The number 0 key does not trigger this action.
- Press D to duplicate the selection. Multiple selected cuts can be duplicated together, and Cut List has no fixed cut limit. Deleting cuts that carry individual notes or shared comments shows the targets for confirmation and is distinct from deleting only those comments. Cut deletion and review-comment changes support Cmd/Ctrl+Z Undo and Cmd/Ctrl+Shift+Z Redo. History keeps up to 50 changes within the same project and sequence until reload; an edit outside this history may clear it for safety. This is not Undo for every operation. Removing a cut does not delete its source shot from the location.
- Open Display settings from the tune icon at the end of the left header for Still default duration, thumbnail size, Output frame, and Timecode. At narrow widths, marker filters move into a filter pop-up. Still and video used durations accept tenths, such as changing 3.5 to 3.2 seconds. The header switches between all-cut and Active only totals and formats them as 15.0s or 2m 09.5s. Open export from the full-width button at the top of the right column and choose one of four scopes. Auto names use all-cut or playback order as four digits such as 0001; when both are selected they read like A0001_0015.

### Shoot, record, and review Takes
Test figure and camera motion
Common user wording: shoot, record, REC, Take, move figure, camera motion, rehearse, video
- Open Shoot in the top bar. Recording settings shows the current destination, and Change storage folder selects a different root for the whole project. Browsers cannot read the absolute path on your Mac, so the app shows the path relative to the named storage folder.
- Set figure motion and camera motion. If the camera move uses different Start and End lenses, the lens changes smoothly between them.
- Rehearse before pressing REC. Preview, REC, and offline export reproduce the same figure position and facing and the same camera lens at the same time.
- Keep only the useful Take in Cut List.

### Save, import, and export
Move projects and shots outside the app
Common user wording: save, import, export, project file, full package, another computer, share, handoff, ZIP, MP4
- Manage projects from the folder button at the lower-right.
- A project file is the lightweight handoff option. It keeps Saved Shot restore states and the first and last frames for Cut List videos, but not the original 3D asset files.
- A full package also includes the 3D assets currently in use.
- Choose All cuts, Active only, Marked, or the selected cut in Cut List export, then export stills or a previs video for that scope.

### Create, switch, and hand off projects
Separate jobs and share either a light project or a full package
Common user wording: project, new project, switch project, rename project, duplicate project, delete project, another computer, send to someone, previzproject, previzpackage
- Open Projects at the lower-right to create or switch job-specific projects. Double-click a card or press Enter to open it.
- Use the … menu or right-click a card to duplicate, rename, or delete it. Default Project cannot be deleted.
- Use Project File (.previzproject) for a lightweight handoff. It keeps Saved Shot restore states and the first and last frames for Cut List videos, but does not include the original 3D asset files.
- Use Full Package (.previzpackage.zip) when the handoff must include used locations, figure models, and shot images. Import creates a new project instead of overwriting an existing one.
- If loading or saving fails, keep the original project file and try again. Local mode imports and lists more than 50 locations without silently dropping any. The Web version keeps a 50-location project limit, so over-limit imports and saves are rejected before changing the existing project.
- If Cut List fails to load, further saves are paused. Check the storage location and reload the project.

### Find lost objects, relink assets, and diagnose errors
Recover missing items and share useful diagnostic information
Common user wording: cannot find, lost object, off screen, broken link, missing asset, relink, video will not play, recording folder, error, bug, diagnostic, report
- If an object is lost, select it in the placed list under the Layers tab and press the magnifier to find it in front of the camera.
- For a missing figure model, use the Missing Assets screen to choose the original GLB / GLTF / FBX file or a folder containing it.
- If a recorded Take is unavailable in Cut List, check or copy its filename. Use Link recording folder and select a storage root to search its subfolders and reconnect other missing cuts too. If several files match, check the listed paths and choose the intended folder. This does not change the destination for future recordings.
- If the cause is unclear, copy the diagnostic report from Report at the lower-right and share it with a screenshot.

## Rules for the AI assistant
- Use only current UI labels documented in this guide. Do not invent buttons.
- Before answering, search the full task guide for the matching object and action (for example, figure + change pose). Do not rely only on an exact heading match.
- If the requested feature is not available inside the app, do not stop there. Continue with the closest documented workflow or supported file format when one exists in this guide.
- Give no more than five steps at once, then wait for the user.
- Explain 3D terms in plain language.
- Ask for a screenshot when the current screen state matters.
- If the answer is not in this guide, say that the official guide does not confirm it instead of guessing.

Official guide URL: /help/guide.txt?lang=en