204 lines
11 KiB
Markdown
204 lines
11 KiB
Markdown
# Dog Bandana — extension Inkscape
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<img src="docs/apercu.png" alt="Formes de test (rectangle, cercle, forme libre, rectangle troué, ellipse) remplies d'un labyrinthe de Turing : lignes noires sinueuses à bouts ronds" width="420">
|
||
</td>
|
||
<td valign="top">
|
||
|
||
Extension Inkscape 1.x qui remplit les formes sélectionnées d'un **labyrinthe de
|
||
Turing**, le motif « vermicelles » du dossier `docs/` : des lignes sinueuses
|
||
d'épaisseur constante, qui bifurquent, se referment parfois en boucle et se
|
||
terminent en bouts ronds.
|
||
|
||
Le motif est calculé (équation de Swift-Hohenberg, régime labyrinthe) sur une
|
||
grille qui couvre la forme, puis réduit à la **ligne centrale** de chaque bande :
|
||
un seul trait à bouts ronds par vermicelle, prêt pour la gravure laser en mode
|
||
ligne, dans un ordre qui limite les déplacements à vide de la tête.
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
## Sommaire
|
||
|
||
- [Fonctionnalités](#fonctionnalités)
|
||
- [Installation](#installation)
|
||
- [Utilisation](#utilisation)
|
||
- [Paramètres](#paramètres)
|
||
- [Structure du projet](#structure-du-projet)
|
||
- [Développement](#développement)
|
||
|
||
## Fonctionnalités
|
||
|
||
- Remplit chemins, rectangles, cercles, ellipses et polygones, y compris dans des
|
||
groupes (transformations comprises) ; les trous sont respectés (règle
|
||
pair-impair). Les autres éléments (texte, images…) sont ignorés.
|
||
- Lignes centrales seulement : un `<path>` par forme, `stroke-linecap:round`,
|
||
épaisseur du trait = largeur des vermicelles ; le trait entier (bouts ronds
|
||
compris) reste dans la forme, à la marge près.
|
||
- Deux comportements au bord : lignes **coupées** comme un tissu découpé (par
|
||
défaut), ou lignes qui **longent** le bord.
|
||
- Aspect réglable : peu d'itérations donnent points et lignes courtes (proche de
|
||
l'image de référence), beaucoup de longues lignes régulières ; la graine
|
||
aléatoire change le dessin en gardant l'aspect. Même graine, même résultat.
|
||
- Ordre de gravure optimisé pour la découpeuse laser : les traits qui se
|
||
touchent sont enchaînés, puis ordonnés au plus proche voisin. Sur un rectangle
|
||
de 150 × 100 mm (période 4 mm), 230 traits deviennent 131 et les trajets à vide
|
||
passent de 9 451 mm à 1 090 mm (÷ 8,7) ; sur 300 × 200 mm, de 71 690 mm à
|
||
4 179 mm (÷ 17). Désactiver la réoptimisation du logiciel du laser (LightBurn…)
|
||
pour garder cet ordre.
|
||
- Temps de calcul : environ 1 s pour 150 × 100 mm, 4 s pour 300 × 200 mm
|
||
(période 4 mm). Au-delà de 3 millions de pixels de calcul, l'extension demande
|
||
d'augmenter la période ou de découper la forme.
|
||
- Interface traduite en français et en anglais, selon la langue d'Inkscape
|
||
(anglais pour toute autre langue).
|
||
- Script de déploiement Windows (`deploy.ps1`).
|
||
|
||
## Installation
|
||
|
||
Aucune dépendance externe : l'extension utilise `inkex` et `numpy`, fournis avec
|
||
Inkscape.
|
||
|
||
### Windows (script)
|
||
|
||
Inkscape fermé, depuis le dossier du projet :
|
||
|
||
```powershell
|
||
.\deploy.ps1 # installe dans %APPDATA%\inkscape\extensions\dogBandana
|
||
.\deploy.ps1 -Uninstall # désinstalle
|
||
.\deploy.ps1 -Force # installe même si Inkscape est ouvert (redémarrage requis)
|
||
```
|
||
|
||
### Manuelle
|
||
|
||
Copier dans un sous-dossier du répertoire des extensions utilisateur :
|
||
|
||
- `dog_bandana.inx`, `dog_bandana.py`, `dog_bandana_core.py` ;
|
||
- `images/parameters_en.png` ;
|
||
- `locale/` (traductions compilées).
|
||
|
||
| Système | Dossier des extensions |
|
||
| ------- | ----------------------------------------------- |
|
||
| Windows | `%APPDATA%\inkscape\extensions` |
|
||
| Linux | `~/.config/inkscape/extensions` |
|
||
| macOS | `~/Library/Application Support/org.inkscape.Inkscape/config/inkscape/extensions` |
|
||
|
||
Redémarrer Inkscape.
|
||
|
||
## Utilisation
|
||
|
||
1. Sélectionner une ou plusieurs formes fermées (ou des groupes).
|
||
2. Menu **Extensions › AlexDesign › Remplissage par motif Dog Bandana** (*Dog Bandana Pattern Fill* en anglais).
|
||
3. Régler période, épaisseur, marge, itérations et bord dans l'onglet **Motif**,
|
||
couleur et conservation de la forme dans **Style** ; l'onglet **Aide** reprend
|
||
le schéma ci-dessous.
|
||
4. Appliquer : le motif est placé dans un groupe « Motif Dog Bandana » juste
|
||
au-dessus de chaque forme.
|
||
|
||
**Conseils**
|
||
|
||
| Symptôme | Réglage |
|
||
| ----------------------------------------- | ----------------------------------------------------------- |
|
||
| Lignes qui se touchent | Réduire l'épaisseur du trait (≈ moitié de la période) |
|
||
| Trop de points et de petits bouts | Augmenter les itérations (100 à 300) |
|
||
| Motif trop régulier, peu « organique » | Réduire les itérations (20 à 40) |
|
||
| Le dessin ne plaît pas | Changer la graine aléatoire |
|
||
| Anneaux concentriques le long du bord | Choisir « Couper les lignes » au bord de la forme |
|
||
| « Forme trop étroite pour le motif » | Réduire épaisseur, période ou marge |
|
||
| « Forme trop grande pour cette période » | Augmenter la période ou découper la forme |
|
||
|
||
## Paramètres
|
||
|
||

|
||
|
||
| Paramètre | Défaut | Rôle |
|
||
| --------------------------------------------------- | ----------------------- | -------------------------------------------------------------------- |
|
||
| Période (écart entre les lignes, d'axe en axe) | 4 | Distance entre les axes de deux lignes voisines |
|
||
| Épaisseur du trait | 2 | Largeur des vermicelles ; doit rester inférieure à la période |
|
||
| Marge au bord de la forme | 0 | Espace libre entre le bord et les traits (bouts ronds compris) |
|
||
| Unité | mm | Unité des trois longueurs ci-dessus (mm, cm, px, pt, in) |
|
||
| Itérations | 60 | Durée d'évolution du motif : peu = points et lignes courtes, beaucoup = longues lignes |
|
||
| Graine aléatoire | 1 | Change le dessin, pas son aspect |
|
||
| Au bord de la forme | Couper les lignes | Couper comme un tissu, ou longer le bord |
|
||
| Couleur du trait | noir | Couleur et opacité des traits |
|
||
| Conserver la forme d'origine | oui | Sinon la forme source est supprimée |
|
||
|
||
## Structure du projet
|
||
|
||
```text
|
||
dog_bandana.inx Boîte de dialogue (textes source en anglais)
|
||
dog_bandana.py Couche inkex : sélection, unités, contours, écriture SVG
|
||
dog_bandana_core.py Calcul du motif et ordre de gravure, sans inkex (numpy)
|
||
i18n.py Extraction / mise à jour / compilation des traductions
|
||
po/ Catalogues : dogbandana.pot, en.po, fr.po
|
||
locale/ Traductions compilées (.mo), déployées
|
||
images/parameters_en.png Schéma de l'onglet « Help » (déployé)
|
||
docs/schema_parametres.py Générateur du schéma (fr pour le README, en pour le dialogue)
|
||
docs/parametres.png Schéma du README
|
||
docs/apercu.png Aperçu du résultat (bandeau du README)
|
||
docs/*.jpg Image de référence du motif
|
||
tests/data/ Formes d'exemple (dont une page à l'échelle non standard)
|
||
test_dog_bandana.py Tests pytest
|
||
deploy.ps1 Déploiement / désinstallation Windows
|
||
```
|
||
|
||
API du module `dog_bandana_core` :
|
||
|
||
| Fonction | Rôle |
|
||
| -------- | ---- |
|
||
| `turing_pattern(rings, period, line_width, margin=0, seed=1, edge="cut", pixels_per_period=8, steps=60)` | Lignes centrales du labyrinthe qui remplit les anneaux (`edge` : `"cut"` ou `"follow"`) |
|
||
| `grid_pixels(rings, period)` | Taille de la grille de calcul (garde-fou de durée) |
|
||
| `rasterize(rings, x0, y0, step, nx, ny)` | Masque pair-impair des pixels intérieurs |
|
||
| `erode(mask, radius)` | Érosion par un disque (FFT) : marge et demi-épaisseur |
|
||
| `swift_hohenberg(shape, pixels_per_period, seed, steps, outside=None)` | Champ du régime labyrinthe (schéma spectral semi-implicite) |
|
||
| `skeletonize(binary)` | Squelette d'un pixel (Zhang-Suen) |
|
||
| `trace_skeleton(skeleton, min_spur=0)` | Polylignes du squelette, ergots supprimés |
|
||
| `smooth_polyline(points, passes)` / `simplify_polyline(points, tolerance)` | Lissage et simplification (Ramer-Douglas-Peucker) |
|
||
| `laser_order(polylines, start)` | Enchaîne puis ordonne les traits pour le laser |
|
||
| `chain_polylines(polylines)` / `order_polylines(polylines, start)` | Les deux étapes de `laser_order` |
|
||
| `travel_length(polylines, start)` | Longueur des déplacements à vide |
|
||
| `parse_color(value)` | Couleur Inkscape (entier RGBA) → `#rrggbb`, opacité |
|
||
| `polylines_to_d(polylines, precision)` | Données `d` d'un chemin SVG |
|
||
|
||
## Développement
|
||
|
||
```powershell
|
||
python -m venv .venv
|
||
.venv\Scripts\activate
|
||
pip install pytest numpy lxml tinycss2 cssselect
|
||
python -m pytest -q # 30 réussis, 7 ignorés (sans inkex)
|
||
$env:PYTHONPATH = 'C:\Program Files\Inkscape\share\inkscape\extensions'
|
||
python -m pytest -q # 37 réussis
|
||
```
|
||
|
||
Les tests couvrent les étapes du calcul (masque pair-impair, érosion, squelette,
|
||
suivi des branches et ergots, lissage, simplification), le motif lui-même (traits
|
||
dans la forme à la marge près dans les deux modes de bord, densité conforme à la
|
||
période, trous respectés, reproductibilité par graine, effet des itérations, cas
|
||
vides), l'ordre de gravure, l'extension de bout en bout (groupes, messages
|
||
d'erreur, page à l'échelle non standard), les traductions et la cohérence `.inx`
|
||
↔ arguments.
|
||
|
||
### Traductions
|
||
|
||
```bash
|
||
python i18n.py # extract + update + compile ; liste les msgstr manquants
|
||
```
|
||
|
||
Après modification d'un texte du `.inx` ou d'un `_("...")` : lancer
|
||
`python i18n.py`, compléter les `msgstr` vides de `po/fr.po`, relancer. `en.po` se
|
||
remplit seul ; ne jamais éditer les `.mo`. Pour une nouvelle langue : l'ajouter à
|
||
`LANGUAGES` dans `i18n.py`.
|
||
|
||
### Schéma des paramètres
|
||
|
||
```bash
|
||
python docs/schema_parametres.py # fr → docs/parametres.png (1400 px)
|
||
# en → images/parameters_en.png (900 px)
|
||
```
|
||
|
||
Les motifs du schéma sont calculés par `dog_bandana_core`, comme dans
|
||
l'extension. L'export PNG passe par `C:\Program Files\Inkscape\bin\inkscape.com`.
|