optimize_mesh_silhouette
Iteratively deform a target mesh to match reference silhouettes from front, side, or top views, with bounded steps, topology preservation, and automatic rollback on failed improvement.
Instructions
Iteratively deform and optimize an explicitly designated target mesh against a reference image or cropped reference-sheet view (FRONT, SIDE, TOP) using measured silhouette comparison. Enforces bounded transformation/displacement steps, monotonic IoU improvement, topology preservation, and automatic transactional rollback on failure or non-improvement.
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>",
"reference_image_path": "<reference_image_path>"
},
"name": "optimize_mesh_silhouette"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Orthographic camera viewpoint to optimize against: 'FRONT', 'SIDE', or 'TOP'. | FRONT |
| depth | No | Optional signed surface relief depth in meters for SURFACE_DETAIL mode. | |
| views | No | Optional list of 2 or 3 view configurations for simultaneous multi-view fitting. | |
| radius | No | Brush radius in meters for sculpt anatomy delegation. | |
| 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] for reference sheet regions. | |
| strength | No | Brush strength factor for sculpt anatomy delegation. | |
| landmarks | No | Optional list of semantic landmark definitions for landmark-guided optimization. | |
| step_size | No | Optimization step rate factor between 0.01 and 2.0. | |
| tolerance | No | Minimum IoU improvement required to accept an iteration step. | |
| brush_type | No | Optional brush operation for sculpt anatomy refinement delegation. | |
| resolution | No | Evaluation image render width and height in pixels. | |
| camera_name | No | Optional scene camera name to use for projection. | |
| feature_type | No | Optional anatomical surface detail feature type for SURFACE_DETAIL mode. | |
| use_symmetry | No | Whether to enforce bilateral symmetry across symmetry_axis during optimization. | |
| feature_scale | No | Optional feature scale in meters for SURFACE_DETAIL mode. | |
| symmetry_axis | No | Reflection plane axis for bilateral symmetry. | X |
| target_object | Yes | Name of the target mesh object in the Blender scene to optimize. | |
| mask_threshold | No | Sensitivity threshold for foreground silhouette detection (0.0 to 1.0). | |
| max_face_count | No | Upper face/polygon cap limit before rejecting refinement. | |
| max_iterations | No | Maximum number of optimization iterations to run (clamped between 1 and 20). | |
| refinement_mode | No | Optional refinement mode flag. | STANDARD |
| max_displacement | No | Maximum allowed displacement cap in Blender units (meters) per iteration. | |
| max_vertex_count | No | Upper vertex cap limit before rejecting refinement. | |
| subdivision_type | No | Subdivision algorithm to use when refining mesh. | CATMULL_CLARK |
| coordinate_system | No | Coordinate system convention for crop_box: 'UV' ([0,0] bottom-left) or 'IMAGE_SPACE' ([0,0] top-left). | UV |
| mask_vertex_group | No | Optional name of a vertex group on the mesh to restrict optimization. | |
| optimization_mode | No | Deformation mode: 'BOUNDED_SCALE_TRANSLATE' (centroid & bounding extents), 'VERTEX_DISPLACEMENT' (contour vertex deformation), or 'HYBRID' (both). | BOUNDED_SCALE_TRANSLATE |
| preserve_topology | No | Strictly preserve mesh topology (vertex, edge, and face counts remain invariant). | |
| preserve_landmarks | No | Optional flag to preserve semantic landmarks during refinement or detailing. | |
| subdivision_levels | No | Optional Catmull-Clark subdivision level for multiresolution refinement delegation (1 to 4). | |
| rollback_on_failure | No | If true, automatically rollback mesh state if objective does not strictly improve or on error. | |
| reference_image_path | Yes | Filesystem path to the reference image or reference sheet file. |