guide_mesh_landmarks
Deforms a mesh toward calibrated semantic landmarks using multi-view reference images and bounded back-projection, preserving topology and rolling back when error or silhouette tolerances fail.
Instructions
Deform a designated mesh toward calibrated 2D/3D semantic landmarks using bounded multi-view back-projection with smooth radial influence and Laplacian regularization. Requires measurable landmark error reduction while enforcing silhouette regression tolerances across protected views. Preserves topology by default.
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": "guide_mesh_landmarks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| views | No | Optional list of 1 to 3 calibrated reference view configurations for silhouette regression monitoring. | |
| 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. | |
| landmarks | No | Optional list of landmarks to configure or override for this guidance run. | |
| objective | No | Landmark optimization objective metric. | WEIGHTED_LANDMARK_RMSE |
| step_size | No | Guidance step size / learning rate factor in [0.01, 1.0]. | |
| object_name | No | Alias for target_object. | |
| falloff_type | No | Spatial falloff function for landmark influence. | SMOOTH |
| target_object | Yes | Name of the target mesh object in the Blender scene. | |
| max_face_count | No | Upper face cap limit before rejecting guidance. | |
| max_iterations | No | Maximum number of guidance iterations. | |
| influence_radius | No | Radius of influence around landmark vertices in meters. | |
| max_displacement | No | Maximum allowed displacement cap in meters per vertex. | |
| max_vertex_count | No | Upper vertex cap limit before rejecting guidance. | |
| preserve_topology | No | Strictly preserve mesh topology (vertex, edge, face count). | |
| laplacian_smoothing | No | Laplacian surface smoothing factor to maintain mesh fairness. | |
| min_error_reduction | No | Minimum required landmark RMSE reduction to accept deformation. | |
| rollback_on_failure | No | If true, transactionally roll back mesh if objective does not improve or tolerances are violated. |