smart_uv_project
Projects UV coordinates onto a mesh using Blender's angle-based UV projection, with island margins and face selection for hard-surface or non-organic models.
Instructions
Projects UV coordinates onto a mesh object using Blender's Smart UV Project algorithm. Projects faces based on angle limits and island margins, ideal for hard-surface or non-organic meshes.
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": {
"name": "<name>"
},
"name": "smart_uv_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Target mesh object name. | |
| faces | No | Faces to project: 'all' (all faces), 'selected' (currently selected faces in edit mode), or a list of integer face indices [0, 1, 2]. Defaults to 'all'. | all |
| 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. | |
| uv_layer | No | Target UV map layer name. Defaults to 'UVMap'. | UVMap |
| angle_limit | No | Lower angles yield more UV islands with less distortion; higher angles yield fewer islands with more distortion (1.0 to 89.0 degrees). Defaults to 66.0. | |
| area_weight | No | Weight projection area by face area (0.0 to 1.0). Defaults to 0.0. | |
| island_margin | No | Margin between UV islands (0.0 to 1.0). Defaults to 0.0. | |
| correct_aspect | No | Map UVs taking image or object aspect ratio into account. Defaults to True. | |
| scale_to_bounds | No | Scale UV coordinates to fit the 0.0-1.0 UV bounds. Defaults to False. | |
| expected_snapshot_id | No | Optional SHA-256 snapshot id for optimistic concurrency control. |