Initiale version

This commit is contained in:
Alex committed 2026-10-24 20:39:34 +02:00
commit 00e9ba3434
19 files changed
+2586

No files matched your search

+203
View File
@@ -0,0 +1,203 @@
# 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
![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`.