# Dog Bandana — extension Inkscape
Formes de test (rectangle, cercle, forme libre, rectangle troué, ellipse) remplies d'un labyrinthe de Turing : lignes noires sinueuses à bouts ronds 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.
## 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 `` 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 ![Schéma des paramètres](docs/parametres.png) | 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`.