bake_mesh_surface_map
Bake high-resolution surface detail into normal, displacement, roughness, or AO maps for low-poly meshes, transferring from a source mesh or self-baking with UV and color-space setup.
Instructions
Bake high-resolution mesh surface detail (tangent normal maps, displacement heightmaps, roughness, AO) from a detailed source mesh to a low-poly target retopology mesh, or self-bake detail onto the target mesh. Handles Cycles bake setup, UV verification/auto-unwrapping, non-color space, ray distance/cage extrusion, and image export.
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": "bake_mesh_surface_map"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Baked image texture width in pixels. | |
| height | No | Baked image texture height in pixels. | |
| margin | No | Margin in pixels around UV islands during baking. | |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted. | |
| map_type | No | Surface map type to bake. | NORMAL |
| color_space | No | Color space setting for the baked image datablock (default 'Non-Color' for normal/displacement/roughness). | Non-Color |
| object_name | No | Alias for target_object. | |
| save_filepath | No | Optional absolute file path on disk to save the baked image (PNG). | |
| source_object | No | Name of the high-poly source mesh object containing detailed sculpting/features. If omitted or equal to target_object, performs self-bake. | |
| target_object | Yes | Name of the target low-poly (retopology) mesh object to receive the bake. | |
| cage_extrusion | No | Ray casting cage extrusion distance in meters for selected-to-active bake. | |
| max_ray_distance | No | Maximum ray casting distance in meters (0.0 = unlimited/auto). | |
| rollback_on_failure | No | Restore scene render engine, material, and object selection state if baking fails. | |
| auto_unwrap_if_needed | No | If target mesh has no UV layer, automatically unwrap with Smart UV Project before baking. | |
| use_selected_to_active | No | Whether to bake detail from source_object to target_object. Automatically False if source_object is omitted or identical to target_object. |