camera
Drive the live viewport to a framed pose and capture it: frame an actor from a chosen angle or grab a canonical orbit set.
What it’s for
Framed captures of level content without hand-driving the viewport.
camera.frame_actor computes a camera pose from an azimuth and elevation, fits the
actor's bounds to the field of view, and captures the Level Editor viewport as a PNG.
camera.orbit_shots captures a whole set around an actor or world point; omit the
count and angles to get the canonical set of perspective shots plus top, front, and side
orthographic views.
Use it when the assistant needs to see what it just built or changed: one call produces a
readable image of the thing from a sensible angle. For manual viewport control use
editor.set_camera; for asset thumbnails outside the level use
render.capture_asset_preview.
Examples
One framed shot of an actor
Frame the actor from 45 degrees around and 30 degrees up, bounds fitted.
You: Show me the tower you just placed.
call("camera.frame_actor", {actorName:"Tower_2", azimuth: 45, elevation: 30})
→ {path:"…/Saved/Screenshots/…png"}
Done. Captured Tower_2; reading the image now.
A full walk-around set
The default set gives perspective orbits plus orthographic top, front, and side.
You: I want to check the tower from every side.
call("camera.orbit_shots", {actorName:"Tower_2"})
→ {shots:[{path:"…az0…png"}, {path:"…az90…png"}, …]}
Done. Seven shots captured around Tower_2.