refine_mesh_multiresolution
Refines a target mesh with bounded multiresolution subdivision and aligns its silhouettes to calibrated FRONT, SIDE, or TOP reference views, rolling back changes when alignment fails to improve.
Instructions
Perform bounded multiresolution surface refinement and contour alignment on an explicitly designated target mesh against one or more calibrated reference views (FRONT, SIDE, TOP). Applies controlled subdivision with strict vertex, face, displacement, and iteration bounds, evaluates multi-view silhouette alignment with regression protection, and enforces transactional rollback if objective fails to improve or limits are violated.
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": {
"target_object": "<target_object>"
},
"name": "refine_mesh_multiresolution"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Orthographic view if single reference image is specified: 'FRONT', 'SIDE', or 'TOP'. | FRONT |
| views | No | List of 1 to 3 distinct orthographic reference view configurations (FRONT, SIDE, TOP). | |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| crop_box | No | Optional normalized crop bounds [u_min, v_min, u_max, v_max] in [0.0, 1.0]. | |
| objective | No | Multi-view aggregate objective function to maximize. | WEIGHTED_IOU |
| step_size | No | Refinement step rate factor between 0.01 and 1.0. | |
| tolerance | No | Minimum aggregate objective improvement required to accept an iteration step. | |
| resolution | No | Evaluation image render width and height in pixels. | |
| camera_name | No | Optional scene camera name to use for evaluation. | |
| use_symmetry | No | Whether to enforce bilateral symmetry across symmetry_axis during sculpting. | |
| symmetry_axis | No | Reflection plane axis for bilateral symmetry (default 'X' for sagittal symmetry). | X |
| target_object | Yes | Name of the target mesh object in the Blender scene to refine. | |
| mask_threshold | No | Sensitivity threshold for foreground silhouette detection. | |
| max_face_count | No | Maximum allowed face/polygon count limit; pre-modification check rejects if exceeded. | |
| max_iterations | No | Maximum number of surface refinement iterations. | |
| seam_threshold | No | Midline distance threshold in meters. Midline vertices within this distance to symmetry plane are clamped to zero displacement along the symmetry axis. | |
| max_displacement | No | Maximum allowed displacement cap in Blender units (meters) per iteration. | |
| max_vertex_count | No | Maximum allowed vertex count limit; pre-modification check rejects if exceeded. | |
| subdivision_type | No | Subdivision algorithm: 'CATMULL_CLARK' (smooth surface) or 'SIMPLE' (linear subdivision). | CATMULL_CLARK |
| coordinate_system | No | Coordinate system convention: 'UV' or 'IMAGE_SPACE'. | UV |
| mask_vertex_group | No | Optional name of a vertex group on the mesh to restrict and modulate sculpt stroke displacement weights [0.0..1.0]. | |
| subdivision_levels | No | Number of subdivision levels to apply (clamped between 1 and 4). | |
| rollback_on_failure | No | If true, automatically rollback mesh state if objective does not strictly improve or regression tolerance is violated. | |
| reference_image_path | No | Optional single reference image path if 'views' is omitted. |