edit_camera
Configure an existing Blender camera's lens, projection, clipping, depth of field, and 3D transform, and set it active to adjust scene framing and camera behavior.
Instructions
Configure properties and transform of an existing camera in the active Blender scene. Updates focal length (lens), projection type (PERSP, ORTHO, PANO), orthographic scale, clipping planes (clip_start, clip_end), sensor dimensions (sensor_width, sensor_height, sensor_fit), shift (shift_x, shift_y), depth of field (use_dof, focus_distance, aperture_fstop), 3D transform (location, rotation), and active camera assignment.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "edit_camera"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dof | No | Depth of field settings. | |
| lens | No | Focal length in millimeters (1.0 to 5000.0). | |
| name | Yes | Name of the existing camera object to configure. | |
| type | No | Alias for camera projection type: 'PERSP', 'ORTHO', or 'PANO'. | |
| shift_x | No | Horizontal camera shift (-10.0 to 10.0). | |
| shift_y | No | Vertical camera shift (-10.0 to 10.0). | |
| task_id | No | Optional task or workflow identifier for grouping related scene mutation operations. | |
| use_dof | No | Enable depth of field. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. Mutations must be approved through a trusted approval mechanism. | |
| clip_end | No | Far clipping distance in Blender units (> clip_start). | |
| location | No | 3D world location coordinates [x, y, z]. | |
| clip_start | No | Near clipping distance in Blender units (> 0.0001). | |
| sensor_fit | No | Sensor fit mode: 'AUTO', 'HORIZONTAL', or 'VERTICAL'. | |
| set_active | No | Whether to set this camera as the active scene camera. | |
| camera_name | No | Alias for name of the camera object. | |
| camera_type | No | Camera projection type: 'PERSP' (Perspective), 'ORTHO' (Orthographic), or 'PANO' (Panoramic). | |
| ortho_scale | No | Orthographic scale factor for ORTHO cameras (> 0.001 to 10000.0). | |
| target_name | No | Alias for name of the camera object. | |
| focal_length | No | Focal length in millimeters (alias for lens). | |
| focus_object | No | Target object name for dynamic depth-of-field focus point. Pass null or empty string to clear focus object. | |
| sensor_width | No | Camera sensor width in millimeters (1.0 to 200.0). | |
| sensor_height | No | Camera sensor height in millimeters (1.0 to 200.0). | |
| aperture_fstop | No | Aperture f-stop number. | |
| focus_distance | No | Focus distance in meters. | |
| rotation_euler | No | Euler rotation angles in radians [rx, ry, rz]. | |
| track_to_object | No | Target object name for camera to track using a TRACK_TO constraint. Pass null or empty string to remove tracking constraint. | |
| show_composition_thirds | No | Display rule-of-thirds composition guide grid in the camera viewport. |