load_reference_image
Load a reference image as a Blender Image Empty or textured plane for visual alignment and reference-driven 3D modeling. Align it to front, side, or top orthographic views.
Instructions
Load a reference image into the Blender scene as a native Image Empty object or calibrated textured mesh plane for visual alignment and reference-driven 3D modeling. Supports front, side, and top orthographic alignment.
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>"
},
"name": "load_reference_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the created Blender object. | Reference_Image |
| 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 | No | Optional normalized crop bounds [u_min, v_min, u_max, v_max] in [0.0, 1.0]. | |
| 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 reference image (.png, .jpg, .jpeg, .webp, .tga, .bmp, .tif, .tiff, .exr). | |
| output_path | No | Destination file path for cropped image when crop_box is provided. 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) or 'IMAGE_SPACE' ([0,0] top-left). | UV |