stage_add_shot
Define camera movement paths and time ranges for cinematography in 3D scenes, supporting orbit, static, chase, and other modes.
Instructions
Add a camera shot to the scene.
Defines a camera movement path and time range for cinematography.
Args:
scene_id: Scene identifier
shot_id: Unique shot name (e.g., "intro-orbit", "close-up")
camera_mode: "orbit", "static", "chase", "dolly", "flythrough", "crane", "track"
start_time: Shot start time in seconds
end_time: Shot end time in seconds
focus_object: Object ID to focus on (for orbit/chase modes)
orbit_radius: Distance from focus object (orbit mode)
orbit_elevation: Camera elevation angle in degrees (orbit mode)
orbit_speed: Rotation speed in revolutions per second (orbit mode)
static_position_x, static_position_y, static_position_z: Camera position (static mode)
look_at_x, look_at_y, look_at_z: Point to look at
easing: Easing function - "linear", "ease-in-out", "spring", etc.
Returns:
AddShotResponse with shot details
Tips for LLMs:
- Orbit mode: Great for product shots, object inspection
- Static mode: Fixed camera, good for observing motion
- Chase mode: Follow moving objects
- Multiple shots can be sequenced for different camera angles
Example:
# Orbiting shot around falling ball
await stage_add_shot(
scene_id=scene_id,
shot_id="orbit-shot",
camera_mode="orbit",
focus_object="ball",
orbit_radius=8.0,
orbit_elevation=30.0,
orbit_speed=0.1,
start_time=0.0,
end_time=10.0
)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene_id | Yes | ||
| shot_id | Yes | ||
| camera_mode | Yes | ||
| start_time | Yes | ||
| end_time | Yes | ||
| focus_object | No | ||
| orbit_radius | No | ||
| orbit_elevation | No | ||
| orbit_speed | No | ||
| static_position_x | No | ||
| static_position_y | No | ||
| static_position_z | No | ||
| look_at_x | No | ||
| look_at_y | No | ||
| look_at_z | No | ||
| easing | No | ease-in-out-cubic |