Linter for inkscape extension

This commit is contained in:
Alex committed 2026-10-24 21:38:03 +02:00
1 parent 00e9ba3434
commit 247ecc3f5a
17 files changed
+1002 -249

No files matched your search

+67
View File
@@ -0,0 +1,67 @@
# 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