Files
2026-10-24 21:38:03 +02:00

228 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
- [Licence](#licence)
## 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, capture inkscape.org)
docs/make_icon.py Générateur de l'icône de la galerie (docs/icon.png)
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
package.py Zip à publier sur inkscape.org (dist/)
PUBLICATION.md Marche à suivre pour inkscape.org
README.en.md README anglais (livré dans le zip)
LICENSE GPL-2.0
```
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`.
### Publication sur inkscape.org
```bash
python docs/make_icon.py # docs/icon.png, icône de la galerie
python package.py # dist/dog_bandana-<version>.zip + .md5
python package.py --sign # + signature GnuPG détachée (.sig)
```
`package.py` vérifie la compatibilité Python 3.8 des fichiers livrés et la
présence des traductions compilées. Marche à suivre complète, description
anglaise à coller et état des exigences : [PUBLICATION.md](PUBLICATION.md).
Les commentaires du code sont en anglais, comme l'exige la relecture
d'inkscape.org.
## Licence
GPL-2.0-or-later — voir [LICENSE](LICENSE).