text_mesh
Create 3D text as a closed mesh or engrave letters into an existing mesh surface, controlling size, depth, plane, alignment, font, and bevel.
Instructions
Make a text label as a closed mesh, or engrave text into a mesh. size is the height of a capital letter and
depth the thickness, in metres. \n starts a new line.
plane: XZ stands upright and reads from the front (-Y), XY lies flat and reads from above, YZ stands and reads
from +X. The back face is on the plane.
at is the anchor in the world (the origin when empty) and the object origin; align puts the middle, the left
end or the right end of the text there; vertically the text is centred.
font is a path to a .ttf or .otf file. The built-in font has Latin and Cyrillic; a font without a glyph shows
nothing for that character. bevel rounds the edges (0 to depth/2). The same name replaces the earlier text.
on_object (a mesh) puts the text on its surface: a ray through at along the plane normal finds the first hit,
and the text lands offset metres above it (a decal that does not z-fight). The text stays flat: use it on flat
or nearly flat surfaces.
engrave=true cuts the letters depth deep into on_object instead, with the checks and clean-up of boolean; no
text object stays and bevel is ignored. The mesh must be closed. The answer has the volume before and after.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| font | No | ||
| name | No | text | |
| size | No | ||
| text | Yes | ||
| align | No | center | |
| bevel | No | ||
| depth | No | ||
| plane | No | XZ | |
| offset | No | ||
| engrave | No | ||
| on_object | No |