Engrave Text
engrave_textEngrave or emboss extruded text on a planar solid face, centered on the face centroid, to add labels, part numbers, or markings directly to a 3D model.
Instructions
Engrave (cut) or emboss (add) extruded text on a planar face of a solid, centred on the face centroid. The host is replaced by the returned handle.
face: planar face — f_* tag (preferred), 'FaceN', or int. size: cap height mm. depth: engrave/emboss depth mm. mode: 'engrave' (removes material) | 'emboss' (adds). position: optional [u, v] mm offset from the centroid along the text's X/Y. font: absolute path to a .ttf/.ttc. Omitted: only macOS Arial/Helvetica are probed, so elsewhere it raises — pass a path.
Returns {handle, name, volume (mm^3 of the result), text, mode, depth}.
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": {
"handle": "<handle>",
"face": "<face>",
"text": "<text>"
},
"name": "engrave_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| face | Yes | ||
| font | No | ||
| mode | No | engrave | |
| name | No | Text | |
| size | No | ||
| text | Yes | ||
| depth | No | ||
| handle | Yes | ||
| position | No | ||
| workspace | No | Run this call in this named workspace |