detail_surface_features
Applies bounded fine-scale anatomical surface detailing—scales, ridges, facets, or veins—to a specified mesh while preserving landmarks and topology, with rollback on failure.
Instructions
Applies controlled, bounded fine-scale anatomical surface detailing (SCALES, RIDGES, FACETS, VEINS) on an explicitly designated target mesh. Preserves existing semantic landmarks, prevents multi-view silhouette regression beyond configured tolerances, and maintains strict topology invariants by default with transactional rollback upon failure.
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>",
"feature_type": "<feature_type>"
},
"name": "detail_surface_features"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Signed surface relief depth in meters (positive = outward relief, negative = creased indent). | |
| views | No | Optional calibrated reference views for silhouette regression monitoring. | |
| spacing | No | Alias for feature_scale. | |
| 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. | |
| strength | No | Strength modulation factor in [0.0, 1.0]. | |
| iterations | No | Number of surface detailing passes. | |
| object_name | No | Alias for target_object. | |
| orientation | No | 3D directional vector [x, y, z] for directional features (RIDGES, VEINS). | |
| falloff_type | No | Spatial boundary falloff function for regional influence. | SMOOTH |
| feature_type | Yes | Type of anatomical surface detail feature to apply. | |
| use_symmetry | No | Whether to enforce bilateral symmetry across symmetry_axis during detailing. | |
| feature_scale | No | Scale, wavelength, or cellular spacing of the feature pattern in meters. | |
| region_bounds | No | Optional bounding box [xmin, ymin, zmin, xmax, ymax, zmax] to restrict deformation. | |
| region_center | No | Optional center coordinate [x, y, z] of the influence region. | |
| region_radius | No | Radius of influence sphere in meters. 0.0 applies to the entire mesh. | |
| 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. | |
| max_face_count | No | Upper face cap limit before rejecting detailing. | |
| 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 | Strict maximum displacement cap in meters per vertex. | |
| max_vertex_count | No | Upper vertex cap limit before rejecting detailing. | |
| mask_vertex_group | No | Optional name of a vertex group on the mesh to restrict and modulate surface detailing weights [0.0..1.0]. | |
| preserve_topology | No | Strictly preserve mesh topology (vertex, edge, face count invariant). | |
| subdivision_level | No | Subdivision level if subdivide_before_detail is true. | |
| preserve_landmarks | No | If true, damps displacement near existing semantic landmarks to prevent landmark drift. | |
| rollback_on_failure | No | If true, roll back mesh state bit-for-bit if limits are exceeded or regression occurs. | |
| max_landmark_regression | No | Maximum allowed increase in landmark RMSE before triggering rejection and rollback. | |
| subdivide_before_detail | No | Optional pre-detail Catmull-Clark subdivision pass for coarse blockout geometry. | |
| landmark_protection_radius | No | Radius in meters around landmarks within which displacement is damped. |