Threadsmith Digitizer
Turn shapes, SVG paths, text or a whole project into embroidery stitches with stats and preview.
Try an example: 40 × 30 mm oval, automatic tatami with underlay · Satin column along a curve · Name in single-line satin lettering · SVG badge (circle + square) · Template project: botanical leaf
How it works
Digitizes vector artwork into machine embroidery: running, bean, satin (with pull compensation, auto split and short stitches), tatami fill with stagger and graded density, contour fill and motif runs, plus underlay. Returns stitch counts, trims, colour changes, thread and bobbin estimates, sewing time, hoop fit, a density check and a thread-look SVG preview — the same engine as the Threadsmith app.
- Shapes are flattened to polygons (Bézier curves within 0.04 mm); closed shapes are regions (even-odd, holes allowed), open paths are lines.
- Tatami: scanlines at the fill angle every row-spacing; intervals are split into blocks that can be sewn back and forth, ordered nearest-first, and penetrations sit on a staggered grid (1/3 offset by default) so no visible columns form.
- Satin: zig-zag between the edges every density step (rows perpendicular to the shape’s principal axis); columns along lines measure spacing on the outer edge and shorten every other inner stitch on tight curves; stitches longer than the max width are split with interleaved penetrations.
- Contour fill and edge-walk underlay use an exact Euclidean distance transform of the rasterised shape and marching-squares iso-lines, so insets stay valid for concave shapes and holes.
- Sequencing: objects grouped by colour (first appearance) and visited nearest-first; gaps up to 1.2 mm are sewn, gaps below the trim distance are jumped, longer gaps get tie-off, trim, jump and tie-in.
- Thread estimate = sewn length + 0.8 mm take-up per penetration + 5 % waste; bobbin ≈ ⅓ of the sewn length; time = stitches ÷ speed + 4 s per trim + 20 s per colour change.
Estimates assume average fabric and settings; always test-stitch on the real fabric and stabiliser. Thread names are generic colours, not brand shade numbers.
Sources
- Embroidery format DST (header fields, ternary stitch encoding, control codes, trim convention) (EduTech Wiki, University of Geneva)
- Embroidery format EXP (2-byte two’s-complement stitches, 0x80 control codes) (EduTech Wiki, University of Geneva)
- pyembroidery – reference readers/writers for DST and EXP (EmbroidePy)
- Ink/Stitch manual – stitch types, underlay, pull compensation (Ink/Stitch project)
- Felzenszwalb & Huttenlocher, Distance Transforms of Sampled Functions, Theory of Computing 8 (2012)
For scripts and AI agents
- JSON API:
POST https://threadsmithdigitize.usefulweb.site/api/v1/calculate(same calculation as this page) - Interface description: OpenAPI 3.1 · AI guide: llms.txt
- MCP server (Streamable HTTP):
https://threadsmithdigitize.usefulweb.site/mcp· tool namethreadsmith_digitize
Example request
curl -s -X POST https://threadsmithdigitize.usefulweb.site/api/v1/calculate \
-H 'content-type: application/json' \
-d '{"source":"shape","shape":"ellipse","widthMm":40,"heightMm":30,"color":"ruby"}'Related tools
- Threadsmith Stitch File Writer – Write Tajima DST or Melco EXP machine files from a stitch list or a Threadsmith project.
- Threadsmith Design Stats – Stitch count, colours, trims, thread, bobbin, sewing time and density of a DST/EXP file.