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

12 KiB
Raw Permalink Blame History

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

  • 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

  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

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.