FrankenTextiles
FrankenTextiles

The exhibition

Workbenches · run on your device

The project

Get started

Open a workbench, or build the tool.

The workbenches run in your browser and need nothing installed. The command-line tool runs the same Rust code on your own machine and writes every file a sewist, a copy shop or a cutting service asks for.

Command line

A first pattern in four commands.

You need Git and Rust. The repository pins its own Rust version, and rustup fetches it on the first build.

01Get the source and build the tool.

Build
git clone https://github.com/Dicklesworthstone/franken_textiles
cd franken_textiles
cargo build --release -p ftx-cli
# the program is now at target/release/ftx

02Draft a bolero. The examples call the program ftx; use its full path, or add it to your path.

Draft
# reference measurements for a synthetic 92 cm wearer, from population data
ftx measure reference --stature-mm 920 --age-months 30 --out m.json

# draft the bolero to those measurements
ftx draft zouave_bolero --measurements m.json --out bolero

03Check it flat. Every seam is walked and each fit point is compared with the body.

Check
ftx validate bolero/pattern.json --measurements m.json --fit bolero/fit_spec.json
STATUS: CONVERGED

04Write every file: tiled PDFs, copy-shop and projector sheets, SVG, DXF, HPGL, cutter and embroidery files.

Export
ftx export all bolero/pattern.json --out bolero/files
PASS: 183/183 checks

Your own wearer

Start from a tape measure.

Begin a measurements file with a nickname, a height and an age, then add each measurement you take. Use a nickname, and keep the file out of anything you publish.

Measure
ftx measure init --label demo --stature 92cm --age-months 30 --out mine.json
ftx measure add mine.json --name chest --value 52cm

With only a height, the flat check answers STATUS: BLOCKED and lists each fit point it could not measure. It does not guess. Add the measurements it names and run it again.

In three dimensions

Sew it in simulation.

Draping fits the body model to the measurements, sews the pieces around it and lets the cloth settle. For the bolero this took about half a minute on one processor core.

Drape
# the body model is converted once on your machine; see tools/body-model in the repository
export FTX_ANNY_MODEL=/path/to/anny-0.6.1.ftxbody

ftx drape bolero/pattern.json --measurements m.json --fit bolero/fit_spec.json --out bolero/drape
fit: 0 gating, 0 advisory, settled

The output folder holds the report and fold_viewer.html, a single page that replays the fold in three dimensions. A result with no flags is a prediction. It is not a fit.

Reference

The commands.

Each prints plain text, or a stable JSON envelope with --json. Run ftx --help for every option.

ftx draft
Draft a bolero, trousers or a fez to a measurements file.
ftx validate
Walk every seam and check every fit point on the flat pattern.
ftx alter
Slash and spread, move a point, true a seam, ease a sleeve cap, or transfer a curve.
ftx trace
Trace a PNG, JPEG or WebP pattern sheet into pieces for review.
ftx body
Fit the body model to tape measurements and write the body on its own.
ftx drape
Sew a pattern around the fitted body and report the fit flags.
ftx export
Write the PDFs, SVG, DXF, HPGL, cutter and embroidery files, with their checks.
ftx round
Run the measurement gate, the flat check, the drape and the exports as one numbered round.
ftx measure
Start and extend a measurements file, or recover scale from a photograph.
ftx materials
Inspect sourced cloth records and bind them to a pattern.