Linter for inkscape extension
This commit is contained in:
1 parent
00e9ba3434
commit
247ecc3f5a
17 files changed
+1002
-249
No files matched your search
@@ -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.
|
||||
|
||||

|
||||
|
||||
## 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
|
||||
Reference in new issue
Block a user