Files
2026-10-24 21:38:03 +02:00

68 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Dog Bandana Pattern Fill — Inkscape extension
Inkscape 1.x extension that fills the selected shapes with a **Turing maze**:
winding lines of constant width that branch, sometimes close into loops, and
end in round tips — the "noodle" pattern often seen on dog bandanas.
The pattern is computed (Swift-Hohenberg equation, labyrinth regime) on a grid
covering the shape, then reduced to the **center line** of each band: a single
round-capped stroke per noodle, ready for line engraving on a laser cutter, in
an order that limits the idle travel of the laser head.
![Parameters](images/parameters_en.png)
## Features
- Fills paths, rectangles, circles, ellipses and polygons, also inside groups
(transforms included); holes are respected (even-odd rule).
- One `<path>` per shape, `stroke-linecap:round`; the whole stroke (round tips
included) stays inside the shape, minus the margin.
- At the shape edge: lines **cut** like a piece of fabric (default), or lines
that **follow** the edge.
- Adjustable look: few iterations give dots and short lines, many give long
regular lines; the random seed changes the drawing, not its look. Same seed,
same result.
- Optimized engraving order: touching strokes are chained, then ordered by
nearest neighbour. On a 300 × 200 mm rectangle (4 mm period), idle travel
drops from 71,690 mm to 4,179 mm. Disable the reoptimization of your laser
software (LightBurn…) to keep this order.
- About 1 s for 150 × 100 mm, 4 s for 300 × 200 mm (4 mm period).
- Interface in English and French, following Inkscape's language.
## Installation
No external dependency: the extension uses `inkex` and `numpy`, shipped with
Inkscape.
- **Extension Manager**: *Extensions › Manage Extensions…*, second tab, folder
button at the bottom, pick the zip.
- **By hand**: unzip into a subfolder of the user extensions folder
(*Edit › Preferences › System › User extensions*), then restart Inkscape.
## Usage
1. Select one or more closed shapes (or groups).
2. *Extensions › AlexDesign › Dog Bandana Pattern Fill*.
3. Set period, line width, margin, iterations, seed and edge behaviour in the
**Pattern** tab, color and "keep the original shape" in **Style**.
4. Apply: the pattern is placed in a group just above each shape.
| Parameter | Default | Role |
| ------------------ | ------------------ | ------------------------------------------------------- |
| Period | 4 mm | Distance between the centers of two neighbouring lines |
| Line width | 2 mm | Stroke width; must stay below the period |
| Margin | 0 | Free space between the shape edge and the strokes |
| Unit | mm | mm, cm, px, pt, in |
| Iterations | 60 | Few: dots and short lines; many: long regular lines |
| Random seed | 1 | Changes the drawing, not its look |
| At the shape edge | Cut the lines | Cut like fabric, or follow the edge |
| Line color | black | Stroke color and opacity |
| Keep the original | yes | Otherwise the source shape is deleted |
## License
GPL-2.0-or-later — see [LICENSE](LICENSE).
Source code, tests and French documentation:
https://git.alex-design.fr/Alex/inkscape.motif.DogBandana