68 lines
3.5 KiB
Markdown
68 lines
3.5 KiB
Markdown
# 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.
|
||
|
||

|
||
|
||
## 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
|