12 KiB
Dog Bandana — extension Inkscape
Sommaire
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 :
.\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
- Sélectionner une ou plusieurs formes fermées (ou des groupes).
- Menu Extensions › AlexDesign › Remplissage par motif Dog Bandana (Dog Bandana Pattern Fill en anglais).
- 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.
- 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
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
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
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
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
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.
Les commentaires du code sont en anglais, comme l'exige la relecture
d'inkscape.org.
Licence
GPL-2.0-or-later — voir LICENSE.

