crop_reference_image
Crop a rectangular region from a reference sheet image using normalized coordinates, save the result, and optionally load it into Blender as a calibrated reference object aligned to a chosen view.
Instructions
Crop a rectangular region from a reference sheet image using normalized [u_min, v_min, u_max, v_max] coordinates, save the cropped image, and optionally load it as a calibrated Blender reference object (Image Empty or Plane) with orthographic view alignment (FRONT, SIDE, TOP, USER).
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": {
"image_path": "<image_path>",
"crop_box": "<crop_box>"
},
"name": "crop_reference_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the created Blender reference object. | Reference_Crop |
| size | No | Primary dimension (meters) of the empty display size or plane dimension. | |
| depth | No | Display depth relative to geometry: 'DEFAULT', 'FRONT', or 'BACK'. | DEFAULT |
| scale | No | Scale factors [sx, sy, sz]. | |
| opacity | No | Display transparency/alpha (0.0 = transparent, 1.0 = opaque). | |
| crop_box | Yes | Normalized bounding box [u_min, v_min, u_max, v_max] in [0.0, 1.0] range, where u_min < u_max and v_min < v_max. | |
| location | No | 3D spatial position [x, y, z] in Blender units (meters). | |
| view_axis | No | Orthographic view alignment: 'FRONT' (facing -Y), 'SIDE' (facing +X), 'TOP' (facing +Z), or 'USER' (custom rotation). | FRONT |
| image_path | Yes | Filesystem path to the source reference image (.png, .jpg, .jpeg, .webp, .tga, .bmp, .tif, .tiff, .exr). | |
| output_path | No | Destination file path for the cropped image. Must not overwrite source image. | |
| display_mode | No | Display representation: 'EMPTY' (Blender Image Empty) or 'PLANE' (calibrated textured mesh plane). | EMPTY |
| rotation_euler | No | Explicit Euler rotation [rx, ry, rz] in radians. Overrides view_axis default when provided. | |
| coordinate_system | No | Coordinate convention: 'UV' (default, [0,0] bottom-left to [1,1] top-right) or 'IMAGE_SPACE' ([0,0] top-left to [1,1] bottom-right). | UV |
| load_as_reference | No | If true, load the cropped image into Blender as a reference object. |