set_camera
Move the active viewport camera to a world point or frame a prim, setting position and target or orbiting by distance, azimuth, and elevation.
Instructions
Move the viewport's camera and aim it, at a world point or at a prim.
For a point, position is where the camera stands and target what it looks at, the world origin when left out. For a prim, prim_path, and the camera goes around the prim's centre at distance, azimuth and elevation, without position or target. It moves whichever camera the viewport looks through, a scene camera included, and the user sees the move. inspect_prim captures a prim from up to 14 sides in one call; capture_viewport's camera_path captures from another camera without moving the viewport. An error when the prim doesn't exist, when position is the point it would look at, and for a mix of the two forms, saying what to drop.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "set_camera"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | [x, y, z] the world point it looks at, the world origin when left out: for a point | |
| azimuth | No | Degrees around the prim: 0 the front (+Y on a Z-up stage, +Z on a Y-up one), 90 the right (+X), 180 the back, 270 the left; 45 when left out | |
| distance | No | From the prim's centre in stage units; 2.5 times its largest side when left out | |
| position | No | [x, y, z] where the camera stands, in world space: for a point | |
| elevation | No | Degrees above the horizontal; 30 when left out | |
| prim_path | No | A prim to frame instead: the camera aims at the centre of its world box |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |