Interactive lettering preview available in HexDocs.
`Text.write/3` produces measured JSON, a PNG of the actual faces, and an SVG of
outline geometry that does not require the font on the viewing computer. The
artifacts share the measured geometry revision. The report includes glyph IDs,
UTF-8 byte clusters, positions and bounds, baseline, typography metrics, font
hash, local ink bounds and world bounds. A generated validation report can have
`:failed` status: check it explicitly before using the result.
`size` means em size, not visible capital height. `width` and `height` measure
actual ink, including accents and descenders. Typographic `advance` includes
spaces and may be larger than the ink. Fit uses ink and scales both size and
tracking uniformly; it does not stretch, clip or omit characters. Placement
validation checks the ink against the allowed rectangle and margins. Visible
height is a design check, not a guarantee about stroke thickness or printer
resolution. Inspect small lettering at the intended print size.
## A named keychain
The pill is an ordinary slot extrusion. The left end contains a small key-ring
hole; this example reserves that end for a ball motif you can build from curved
groove cutters. Letters overlap the top by 0.2 mm before fusing so they become
part of one solid. The dimensions below are example design choices in mm.
```elixir
build_tag = fn name ->
text = Smith.text(name, font: font, size: 10,
align: {:center, :center}, at: {8, 0}, on: Plane.xy(z: 2.8))
{:ok, text} = Text.fit(text, {43, 14}, margin: 1, min_size: 5)
{:ok, label} = Text.validate(text,
within: {{-13.5, -7}, {29.5, 7}}, margin: 1, min_height: 4)
:passed = label.report.status
letters = label.result |> Smith.from_result() |> Smith.extrude({0, 0, 1})
body = Sketch.slot(70, 22)
|> Sketch.cut(Sketch.circle(2, at: {-29, 0}))
|> Smith.extrude(3)
|> Smith.fuse(letters)
{:ok, result} = Smith.evaluate(body)
{:ok, inspection} = Smith.Inspection.run(%{tag: result},
checks: [{:topology, :tag, :solids, expected: 1}])
:passed = inspection.status
{result, label}
end
{tag, label} = build_tag.("ALEXANDRA")
{:ok, files} = Smith.export(tag, "output/keychains", name: "sample-name", on_bed: true)
IO.puts(files.three_mf)
```