sculpt_organic_anatomy
Sculpts organic anatomy on a named Blender mesh with bounded brushes, topology preservation, silhouette-guided checks, and automatic rollback when constraints fail.
Instructions
Bounded organic sculpting and coarse anatomy refinement on an explicitly named mesh. Supports a verified initial brush set ('GRAB', 'INFLATE', 'SMOOTH', 'CLAY', 'DRAW') with bounded radius, strength, stroke coordinates, max displacement, and iteration limits. Preserves topology by default; requires explicit parameter configuration and limits for dynamic topology. Evaluates candidate deformation against calibrated FRONT, SIDE, and TOP silhouette objectives when provided, and enforces transactional rollback if constraints or regression tolerances 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": "sculpt_organic_anatomy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Orthographic view if single reference image is specified: 'FRONT', 'SIDE', or 'TOP'. | FRONT |
| views | No | Optional calibrated multi-view reference configurations (FRONT, SIDE, TOP) for reference-guided acceptance evaluation. | |
| radius | No | Brush influence radius in Blender units (meters). | |
| 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]. | |
| strength | No | Sculpt brush strength factor in [0.0, 1.0]. | |
| objective | No | Multi-view silhouette objective function: 'WEIGHTED_IOU', 'MIN_IOU', or 'WEIGHTED_DICE'. | WEIGHTED_IOU |
| brush_type | No | Sculpt brush operation: 'GRAB' (translation along stroke vector), 'INFLATE' (normal displacement), 'SMOOTH' (Laplacian relaxation), 'CLAY' (surface build-up along average normal), or 'DRAW' (surface displacement). | INFLATE |
| iterations | No | Number of bounded sculpting passes/iterations to execute. | |
| camera_name | No | Optional scene camera name to use for evaluation. | |
| object_name | No | Alias for target_object. | |
| stroke_points | No | Array of 3D spatial points [x, y, z] or 2D screen coordinates representing brush contact path. | |
| target_object | Yes | Name of the target mesh object in the Blender scene to sculpt. | |
| max_face_count | No | Upper bound limit on allowed polygon face count for resource protection. | |
| affected_region | No | Optional bounding limits for the affected region (center [x, y, z] and max_radius). | |
| dynamic_topology | No | Explicitly enable dynamic topology mode (requires preserve_topology=false). | |
| max_displacement | No | Maximum allowed spatial displacement per vertex in Blender units (meters). | |
| max_vertex_count | No | Upper bound limit on allowed vertex count for resource protection. | |
| stroke_direction | No | Explicit 3D direction vector [dx, dy, dz] for directional brushes like GRAB. | |
| coordinate_system | No | Coordinate system convention: 'UV' or 'IMAGE_SPACE'. | UV |
| preserve_topology | No | Strictly preserve mesh topology (vertex, edge, face count). Defaults to true. | |
| 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. | |
| dynamic_topology_detail | No | Detail size for dynamic topology remeshing in meters. | |
| min_aggregate_improvement | No | Minimum required aggregate objective improvement to accept deformation when views are configured. |