From 3c95582a5ca9a8f232aee285bab582dbe91ed971 Mon Sep 17 00:00:00 2001 From: Alex Date: Fri, 25 Sep 2026 17:14:49 +0200 Subject: [PATCH] version initiale Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_016S8V7WxoS7YRoM34BVBkeo --- .gitignore | 12 + README.md | 470 +++++++++++++ board_photo_common.py | 173 +++++ board_photo_core.py | 539 +++++++++++++++ board_photo_import.inx | 156 +++++ board_photo_import.py | 401 +++++++++++ board_photo_markers.inx | 98 +++ board_photo_markers.py | 228 ++++++ board_photo_remote.py | 129 ++++ board_photo_vision.py | 521 ++++++++++++++ deploy.ps1 | 115 +++ docs/apercu-feuille-a4.png | Bin 0 -> 40186 bytes docs/apercu-import.png | Bin 0 -> 689894 bytes docs/parametres.png | Bin 0 -> 182626 bytes docs/schema_parametres.py | 358 ++++++++++ i18n.py | 308 +++++++++ images/parameters_en.png | Bin 0 -> 124278 bytes locale/en/LC_MESSAGES/board_photo.mo | Bin 0 -> 18410 bytes locale/fr/LC_MESSAGES/board_photo.mo | Bin 0 -> 19813 bytes po/board_photo.pot | 575 +++++++++++++++ po/en.po | 636 +++++++++++++++++ po/fr.po | 640 +++++++++++++++++ test_board_photo.py | 999 +++++++++++++++++++++++++++ tests/data/empty_mm.svg | 7 + tests/data/empty_px.svg | 8 + tests/data/small_markers.jpg | Bin 0 -> 149896 bytes tests/fake_camera.py | 82 +++ tests/synthetic.py | 115 +++ 28 files changed, 6570 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 board_photo_common.py create mode 100644 board_photo_core.py create mode 100644 board_photo_import.inx create mode 100644 board_photo_import.py create mode 100644 board_photo_markers.inx create mode 100644 board_photo_markers.py create mode 100644 board_photo_remote.py create mode 100644 board_photo_vision.py create mode 100644 deploy.ps1 create mode 100644 docs/apercu-feuille-a4.png create mode 100644 docs/apercu-import.png create mode 100644 docs/parametres.png create mode 100644 docs/schema_parametres.py create mode 100644 i18n.py create mode 100644 images/parameters_en.png create mode 100644 locale/en/LC_MESSAGES/board_photo.mo create mode 100644 locale/fr/LC_MESSAGES/board_photo.mo create mode 100644 po/board_photo.pot create mode 100644 po/en.po create mode 100644 po/fr.po create mode 100644 test_board_photo.py create mode 100644 tests/data/empty_mm.svg create mode 100644 tests/data/empty_px.svg create mode 100644 tests/data/small_markers.jpg create mode 100644 tests/fake_camera.py create mode 100644 tests/synthetic.py diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..04f9269 --- /dev/null +++ b/.gitignore @@ -0,0 +1,12 @@ +# Cache Python et outils +__pycache__/ +*.pyc +.pytest_cache/ +.venv/ + +# Archives de distribution +*.zip + +# SVG intermediaires du schema (regeneres par docs/schema_parametres.py) +docs/*.svg + diff --git a/README.md b/README.md new file mode 100644 index 0000000..2e08a46 --- /dev/null +++ b/README.md @@ -0,0 +1,470 @@ +# Photo de planche — extension Inkscape + + + + + + +
+Photo de planche redressée sur une zone de travail de 400 × 400 mm, avec les 4 repères de calibration aux coins et le contour vectorisé de la planche et de ses trous en surimpression + + +Extension Inkscape 1.x pour réutiliser des planches déjà entamées (chutes, +panneaux percés) à la découpeuse laser. On photographie la planche posée sur +la surface de travail ; l'extension repère les **4 repères de calibration** +collés aux angles du nid d'abeille, redresse la photo et la place sur une page de la taille +exacte de la zone de travail : **1 mm sur la photo = 1 mm dans le document**. +Le contour de la planche et ses trous sont vectorisés sur un calque verrouillé. + +On positionne ensuite les formes à découper par superposition, dans le calque +« Découpes », puis on les envoie à la laser avec *Export to LaserGRBL* : le bas +gauche de la page est l'origine laser. + +
+ +## Sommaire + +- [Fonctionnalités](#fonctionnalités) +- [Installation](#installation) +- [Utilisation](#utilisation) +- [Paramètres](#paramètres) +- [Précision et limites](#précision-et-limites) +- [Structure du projet](#structure-du-projet) +- [Développement](#développement) + +## Fonctionnalités + +- **Deux entrées de menu** dans *Extensions > AlexDesign* : + - **Imprimer les repères de calibration** : dessine les 4 repères, au choix à graver une + fois pour toutes sur la surface de travail, ou sur une **feuille A4 à + imprimer** (grille à découper) accompagnée de **gabarits de pose** à graver + pour coller chaque repère à sa position exacte ; + - **Importer et calibrer** : photo → image redressée à l'échelle + contour et + trous vectorisés ; avec les repères collés aux angles du nid d'abeille, + origine laser et échelle sont déduites automatiquement. +- **Échelle garantie par construction** : homographie calculée sur les 4 + repères, photo rééchantillonnée sur toute la zone de travail et insérée avec + `preserveAspectRatio="none"` sur un rectangle de `largeur × hauteur` mm. +- **Repère laser** : coordonnées saisies en mm depuis l'origine laser, en bas à + gauche de la zone de travail ; la page du document est réglée à la taille de + la zone. +- **Orientation automatique** : le repère origine porte deux pastilles, les + autres une seule ; la photo peut être prise dans n'importe quel sens. +- **Repli manuel** : si les repères ne sont pas trouvés, la photo brute est + placée avec 4 viseurs à amener sur les repères, puis on relance. +- **Échelle du document conservée** : un document en px garde ses objets + intacts, seule la page change de taille. +- **Calques dédiés** (du bas vers le haut) : « Photo de la planche » et + « Contour de la planche » (verrouillés), « Découpes » (calque actif). + Relancer l'import remplace la + photo et le contour sans toucher aux découpes. +- **Photo locale ou distante** : fichier photo, ou prise de vue déclenchée sur + une machine distante (caméra fixe au-dessus de la laser) par son adresse IP, + via un petit serveur de capture HTTP (routes `/capture` et `/old`). +- Traitement d'image sans OpenCV ni scipy : numpy et Pillow, déjà fournis avec + le Python d'Inkscape ; environ 2 s pour une photo de 4 Mpx. +- Interface traduite en français et en anglais, selon la langue d'Inkscape + (anglais pour toute autre langue). +- Script de déploiement PowerShell. + +## Installation + +Aucune dépendance externe : l'extension utilise `inkex`, `numpy` et `Pillow`, +tous fournis avec Inkscape 1.x (vérifié avec Inkscape 1.4 : Python 3.12, +numpy 2.3, Pillow 12). + +### Windows (script) + +Fermer Inkscape, puis dans PowerShell, depuis le dossier du projet : + +```powershell +.\deploy.ps1 # installe ou met à jour +.\deploy.ps1 -Uninstall # désinstalle +.\deploy.ps1 -Force # déploie même si Inkscape est ouvert +``` + +Les fichiers sont copiés dans `%APPDATA%\inkscape\extensions\Planche photo`. +Redémarrer Inkscape. + +### Manuelle + +Copier dans un sous-dossier du répertoire des extensions utilisateur : + +- `board_photo_import.inx/.py`, `board_photo_markers.inx/.py` ; +- `board_photo_core.py`, `board_photo_vision.py`, `board_photo_common.py`, + `board_photo_remote.py` ; +- `images/parameters_en.png` et le dossier `locale/`. + +| Système | Dossier des extensions | +| ------- | ---------------------------------------------- | +| Windows | `%APPDATA%\inkscape\extensions` | +| Linux | `~/.config/inkscape/extensions` | +| macOS | `~/Library/Application Support/org.inkscape.Inkscape/config/inkscape/extensions` | + +## Utilisation + +### 1. Installer les repères (une seule fois) + +Nouveau document, **Extensions > AlexDesign > Photo de planche : imprimer les +repères de calibration** (*Board photo: print calibration markers*). Renseigner la zone de +travail et la position des repères, puis choisir la **Sortie**. + +**Repères aux angles du nid d'abeille (recommandé)** : imprimer la feuille A4 +(ci-dessous), découper les 4 pièces et les coller **autour** du nid d'abeille, +le coin intérieur de chaque pièce touchant un angle du nid, le repère à deux +pastilles en bas à gauche (schéma, panneau 1). Rien d'autre à mesurer : dans +« Importer et calibrer », position « Autour du nid d'abeille » (défaut), +l'angle bas gauche du nid est l'origine laser et l'écart entre repères vaut la +taille du nid plus deux fois la taille des repères (440 × 440 mm pour un nid de +400 × 400 et des repères de 20 mm). La photo calibrée déborde de la page pour +montrer les repères ; la page reste la zone de travail et le contour de la +planche n'est cherché que dedans (l'image n'est jamais exportée vers la laser). + +Les autres montages (repères dans la zone de travail) se règlent en position +« Personnalisée » : + +**Repères gravés** (sortie « Repères à graver sur la surface ») : graver le +calque « Repères de calibration » en remplissage, sur des plaques claires +(contreplaqué, carton) fixées à la surface de travail, avec une zone claire +d'environ deux fois la taille d'un repère autour de chacun. C'est la laser qui +les positionne : leur position est exacte dans son propre repère. + +**Repères imprimés** : + + + + + + +
+Feuille A4 : titre et consignes, 4 repères de 20 mm dans des pièces carrées de 40 mm à découper en pointillés, traits d'alignement au milieu de chaque bord, légende de chaque pièce et barres de contrôle de 100 mm (horizontale en bas, verticale à droite) + + +1. Sortie « Feuille A4 à imprimer » : la page passe en A4 et reçoit les 4 + repères dans une grille 2 × 2 (même disposition que sur la surface, repère + origine en bas à gauche), chacun dans une pièce de deux fois sa taille à + découper le long des pointillés, avec des traits d'alignement au milieu de + chaque bord. +2. Imprimer **en taille réelle (100 %)**, sans « ajuster à la page » (voir + [Imprimer à la bonne échelle](#imprimer-à-la-bonne-échelle)) ; vérifier à + la règle que les deux barres (horizontale en bas, verticale à droite) + mesurent bien 100 mm. Découper les 4 pièces. +3. Dans un document de la taille de la zone de travail, sortie « Gabarits de + pose » : contour de chaque pièce et croix passant par le centre du repère, + en traits rouges fins. Les graver légèrement sur la surface (ou sur des + plaques fixées). +4. Coller chaque pièce dans son gabarit, ses traits d'alignement dans le + prolongement de la croix : le centre du repère tombe à sa position exacte. + +
+ +Dans les deux cas, ne plus déplacer les repères : ils donnent l'échelle de +chaque photo. + +#### Imprimer à la bonne échelle + +Le fichier est exact : la page PDF fait 210 × 297 mm et les barres 100 mm. Une +barre plus courte à l'impression (typiquement 97 mm) vient du pilote ou de la +boîte d'impression, qui réduit la page pour la faire tenir dans la zone +imprimable (« Ajuster à la page », « Réduire les pages trop grandes », +« Ajuster à la zone imprimable »). Ce n'est pas un problème de DPI. + +1. Exporter la feuille en PDF (*Fichier > Enregistrer une copie…*, type PDF) + plutôt que d'imprimer depuis Inkscape. +2. L'imprimer depuis le lecteur PDF en **Taille réelle** / **100 %**, sans + ajustement. +3. Si les barres ne font toujours pas 100 mm (pilote qui réduit malgré tout), + saisir leurs longueurs mesurées dans l'onglet **Feuille imprimée** et + régénérer la feuille : le dessin est agrandi d'autant (100 / 97 = 103,1 % + pour 97 mm), la correction est rappelée en tête de feuille. Réimprimer avec + les mêmes réglages et vérifier les barres. + +Un léger écart d'échelle d'impression ne décale pas pour autant les repères : +une pièce un peu plus petite reste centrée sur la croix de son gabarit, et +c'est le centre du repère qui sert à la calibration. En revanche, au-delà de +5 %, l'import signale une taille de repère incohérente. + +### 2. Importer une planche + +1. Poser la planche **sans masquer les repères**, photographier du dessus (le + plus à la verticale possible, toute la zone dans le cadre). +2. Sans rien sélectionner, **Extensions > AlexDesign > Photo de planche : + importer et calibrer** (*Board photo: import and calibrate*), onglet + « Photo » : choisir le fichier, ou la source **Appareil distant** et + l'adresse de la machine qui porte la caméra (voir + [Caméra distante](#caméra-distante)). Garder les **mêmes réglages de zone + de travail** que pour les repères. +3. Appliquer. Un message indique la précision (mm par pixel de la photo) et le + nombre de trous trouvés. La page fait la taille de la zone de travail, la + photo et le contour sont en place, le calque « Découpes » est actif. + +#### Caméra distante + +La photo peut être prise par une caméra fixe reliée à une autre machine +(Raspberry Pi…), qui fait tourner un serveur de capture HTTP. L'extension +appelle : + +| Route | Rôle | +| ----- | ---- | +| `GET /capture` | Prend une nouvelle photo et la renvoie (`image/jpeg`). | +| `GET /old` | Renvoie la dernière photo prise, sans en prendre de nouvelle. | + +Un serveur Flask avec OpenCV qui expose ces deux routes sur le port 5000 +convient tel quel. En cas d'erreur, le message renvoyé par le serveur +(« Error: Could not access the camera »…) est affiché dans Inkscape. + +Dans l'onglet « Photo » : *Source de la photo* = *Appareil distant*, adresse +`192.168.1.20` (ou `192.168.1.20:5000`, ou une URL `http://…`), port, choix +entre nouvelle photo et dernière photo, délai d'attente. Les proxys du système +sont ignorés (la caméra est sur le réseau local). Une transmission interrompue +est retentée une fois automatiquement. + +Conseils pour le serveur de capture : + +- **Résolution** : c'est elle qui fixe la précision. En 1024 × 768, une zone de + 400 mm occupe au mieux ~700 px de haut, soit environ 0,5 à 0,6 mm par pixel + (valeur affichée après l'import). Demander la résolution maximale de la + caméra (1920 × 1080, 2592 × 1944…) améliore la précision d'autant. +- **Premières images** : beaucoup de webcams livrent des premières images + sombres ou floues, le temps que l'exposition automatique se règle. Lire et + jeter quelques images avant de garder celle qui est enregistrée. +- Libérer la caméra (`camera.release()`) aussi dans les chemins d'erreur, sinon + les appels suivants peuvent échouer avec « Could not access the camera ». +- Fixer la caméra au-dessus de la laser : les repères n'ont pas à être + parfaitement cadrés au même endroit d'une photo à l'autre, mais les 4 doivent + être visibles. + +Si la détection échoue, la photo brute est placée dans le calque +« Calibration manuelle » avec 4 viseurs rouges : amener chaque viseur au centre +d'un repère (en zoomant), sélectionner le contenu du calque (Ctrl+A) et +relancer l'extension. + +### 3. Placer et découper + +1. Dessiner ou coller les formes dans le calque « Découpes », en les posant sur + les zones pleines de la planche (le contour et les trous servent de guide). +2. Envoyer à la laser avec **Extensions > Export > Export to LaserGRBL**. + +#### Export vers LaserGRBL + +L'extension *Export to LaserGRBL* (v1.21) écrit le G-code en mm, **origine au +coin bas gauche de la page** : la page ayant la taille de la zone de travail, +ce coin est l'origine laser, et les pièces gardent leur place et leur taille, +que le document soit en mm ou en px. Elle exporte tout le document (calques +masqués compris) et retient chaque chemin, rectangle, cercle ou ellipse dont +la couleur de contour ou de remplissage *propre* est l'une de ses trois +couleurs (gravure, découpe intérieure, découpe extérieure, réglées dans +`export_lasergrbl.ini` ou mémorisées dans le document). + +Les formes d'aide de « Photo de planche » (contour de la planche, viseurs) +ne portent donc aucune couleur à elles : elles +héritent celle de leur calque, s'affichent pareil, mais ne sont **jamais +exportées**, même rouges, et il n'est pas nécessaire de masquer ces calques. +La photo (image) n'est pas exportée non plus. + +Pour que l'export soit juste : + +- garder *Mettre la page à la taille de la zone de travail* coché (l'origine du + G-code est le bas gauche de la page ; l'import avertit sinon) ; +- partir d'un document dont la page commence en 0, 0 (le remplissage de + l'export ignore un viewBox décalé) ; +- n'utiliser que des chemins, rectangles, cercles et ellipses (*Chemin > Objet + en chemin* pour le reste), d'une couleur d'export opaque portée par la forme + elle-même, et ne pas placer de formes remplies dans un groupe déplacé. + +Pour lire dans Inkscape les coordonnées dans le repère de la laser (origine en +bas à gauche), décocher *Préférences > Interface > Origine en haut à gauche avec +l'axe des y vers le bas*. + +### Conseils + +| Symptôme | Réglage | +| -------- | ------- | +| « détection automatique des repères a échoué » | Repères masqués, reflets ou trop petits : photo plus proche, éclairage diffus, ou calibration manuelle. | +| « Un repère mesure … mm au lieu de … mm » | Taille des repères différente de celle imprimée (mesurer un carré noir), ou pièces ne touchant pas exactement les angles du nid. | +| « le repère origine n'a pas été reconnu » | Pastilles du repère origine peu visibles : la photo est supposée droite, vérifier que l'import n'est pas tourné. | +| « Aucune planche trouvée » | Changer la *Teinte de la planche*, ou régler le *Seuil* à la main. | +| Contour qui déborde sur le nid d'abeille, trous parasites | Augmenter le *Lissage* ou l'*Aire minimale d'un trou*. | +| Document trop lourd | Baisser la *Résolution* (px/mm) ou la *Qualité JPEG*. | + +## Paramètres + +![Schéma des paramètres](docs/parametres.png) + +### Importer et calibrer — onglet Zone de travail + +Ces réglages sont identiques dans « Repères de calibration », qui propose en +plus la **Sortie** : repères à graver sur la surface (défaut), feuille A4 à +imprimer, ou gabarits de pose. Les gabarits (pièce de deux fois la taille du +repère et croix) demandent que chaque centre de repère soit à au moins +1,5 fois la taille du repère des bords (30 mm pour des repères de 20 mm) ; la +feuille A4 accepte des repères jusqu'à 40 mm. + +| Paramètre (onglet Feuille imprimée) | Défaut | Rôle | +| --------- | ------ | ---- | +| Longueur mesurée de la barre horizontale (mm) | 100 | Longueur réelle de la barre X après impression ; sous 100, la feuille est élargie pour compenser. | +| Longueur mesurée de la barre verticale (mm) | 100 | Idem pour la barre Y. Valeurs admises : 80 à 120 mm. | + +| Paramètre | Défaut | Rôle | +| --------- | ------ | ---- | +| Largeur (mm) | 400 | Largeur du nid d'abeille = zone de travail de la laser. | +| Hauteur (mm) | 400 | Hauteur du nid d'abeille. | +| Mettre la page à la taille de la zone de travail | coché | Page = zone de travail ; l'échelle des objets existants est conservée. | +| Position des repères (import seulement) | Autour du nid d'abeille | Coin intérieur de chaque pièce sur un angle du nid : origine et écart déduits. *Personnalisée* : valeurs ci-dessous. | +| Taille des repères (mm) | 20 | Côté du carré noir (pièce de papier : deux fois plus grande) ; sert aussi à contrôler l'échelle mesurée. | +| Centre du repère origine X (mm) | 30 | Position personnalisée : distance de l'origine laser au centre du repère à deux pastilles, selon X ; négative si le repère est hors de la zone. | +| Centre du repère origine Y (mm) | 30 | Idem selon Y, vers le haut. | +| Écart entre repères X (mm) | 340 | Position personnalisée : distance entre centres de repères, selon X. | +| Écart entre repères Y (mm) | 340 | Idem selon Y. | + +### Importer et calibrer — onglets Photo et Détection de la planche + +| Paramètre | Défaut | Rôle | +| --------- | ------ | ---- | +| Source de la photo | Fichier photo | Fichier photo, ou appareil distant (serveur de capture). | +| Photo de la planche | — | Photo prise du dessus, les 4 repères visibles (JPEG, PNG, TIFF…). L'orientation EXIF est respectée. | +| Adresse de la machine distante | — | IP, IP:port ou URL du serveur de capture. | +| Port | 5000 | Port du serveur (ignoré si l'adresse en contient un). | +| Image | Prendre une nouvelle photo | `/capture`, ou reprendre la dernière photo prise (`/old`). | +| Délai d'attente (s) | 20 | Temps maximal d'attente de la photo. | +| Résolution de la photo calibrée (px/mm) | 4 | 4 px/mm = 0,25 mm par pixel. | +| Qualité JPEG | 85 | Compression de la photo incorporée. | +| Vectoriser le contour et les trous de la planche | coché | Décocher pour n'importer que la photo. | +| Teinte de la planche | Plus claire que le fond | Ou plus foncée (planche sombre sur surface claire). | +| Seuil (0 = automatique) | 0 | Niveau de gris planche / fond ; 0 = méthode d'Otsu. | +| Lissage (mm) | 0,5 | Ouverture puis fermeture morphologiques : retire poussières et petites encoches. | +| Aire minimale d'un trou (mm²) | 4 | Les trous plus petits sont bouchés. | +| Tolérance du contour (mm) | 0,3 | Écart maximal de la simplification (Douglas-Peucker). | +| Couleur du contour | bleu `#1971c2` | Trait et remplissage léger du contour. | + +## Précision et limites + +- **Précision** : de l'ordre d'un pixel de la photo au niveau de la surface + de travail (affiché après l'import). Sur photo synthétique en perspective + (2400 × 1800 px, flou et bruit), les centres et diamètres des trous sont + retrouvés à 0,15 mm près ; les tests exigent 0,5 mm. +- **Distorsion de l'objectif** non corrigée : l'homographie suppose une + projection parfaite. Éviter les grands angles ; les smartphones corrigent en + général déjà leur distorsion. +- **Épaisseur de la planche** ignorée : sa face supérieure, plus proche de + l'objectif, paraît légèrement agrandie par rapport aux repères (environ + épaisseur / hauteur de prise de vue, soit 0,6 % pour 6 mm à 1 m). Photographier + de haut réduit l'écart. +- La planche ne doit pas masquer les repères, qui doivent rester sur une zone + claire. + +## Structure du projet + +```text +board_photo_import.inx / .py Importer et calibrer (photo, contour, calques) +board_photo_markers.inx / .py Imprimer les repères de calibration : feuille A4 (ou gravure, gabarits) +board_photo_core.py Géométrie pure (numpy) : repères, homographie, + contours, vérification ; sans inkex +board_photo_vision.py Traitement d'image (numpy + Pillow) : composantes + connexes, détection des repères, redressement, + vectorisation ; sans inkex +board_photo_common.py Outils inkex partagés : page, calques, aplatissement +board_photo_remote.py Photo demandée au serveur de capture distant (urllib) +i18n.py Extraction / mise à jour / compilation des traductions +po/ board_photo.pot, en.po, fr.po +locale//LC_MESSAGES/ Catalogues compilés board_photo.mo +images/parameters_en.png Schéma de l'onglet « Diagram » (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-import.png Aperçu d'un import (photo synthétique) +docs/apercu-feuille-a4.png Aperçu de la feuille A4 de repères à imprimer +tests/synthetic.py Photo synthétique : planche trouée en perspective +tests/fake_camera.py Faux serveur de capture (/capture, /old) pour les tests +tests/data/ Documents vides en mm et en px, vraie photo à petits + repères (caméra distante 800 x 600) +test_board_photo.py Tests pytest +deploy.ps1 Déploiement / désinstallation Windows +``` + +### API du noyau (`board_photo_core`) + +| Fonction | Rôle | +| -------- | ---- | +| `laser_to_svg(point, height)` / `svg_to_laser(...)` | Conversion repère laser (y vers le haut) ↔ repère SVG. | +| `marker_layout(height, origin_x, origin_y, spacing_x, spacing_y)` | Centres des 4 repères, ordre HG, HD, BD, BG (repère origine = BG). | +| `corner_layout(width, height, size)` | Origine et écart des repères dont les pièces touchent les angles du nid d'abeille. | +| `photo_extent(width, height, origin_x, origin_y, spacing_x, spacing_y, size, resolution)` | Rectangle couvert par la photo redressée : zone de travail agrandie jusqu'aux repères qui l'entourent. | +| `layout_problems(width, height, ...)` | Défauts de disposition des repères (`outside`, `too_close`, `non_positive`). | +| `marker_rings(center, size, origin=False)` | Anneaux d'un repère : carré + pastille(s), pair-impair. | +| `sheet_layout(size, page=A4, ...)` | Centres des 4 pièces sur la feuille imprimée (2 × 2 ou une colonne), `None` si trop grand. | +| `piece_side(size)` / `piece_outline(center, size)` / `piece_ticks(center, size)` | Pièce à découper (deux fois le repère) et ses traits d'alignement. | +| `guide_lines(center, size)` / `guide_reach(size)` | Gabarit de pose (contour + croix) et son emprise autour du centre. | +| `scale_bar(start, length=100, vertical=False)` | Barre graduée de contrôle d'impression. | +| `print_correction(measured_x, measured_y)` / `stretch_rings(rings, fx, fy, center)` | Correction d'une imprimante qui réduit : facteurs 100 / mesure et étirement. | +| `homography(src, dst)` / `apply_homography(matrix, points)` | Homographie exacte sur 4 points (normalisation de Hartley). | +| `local_scale(matrix, point)` | Échelle locale d'une homographie. | +| `order_corners(points)` / `rotate_to_origin(ordered, index)` | Ordonne 4 points et fixe l'orientation par le repère origine. | +| `mask_to_rings(mask)` | Contours d'un masque binaire (milieux des arêtes de pixels). | +| `simplify_ring(ring, tolerance)` | Simplification Douglas-Peucker d'un anneau fermé. | +| `ring_area(ring)` / `ring_centroid(ring)` | Aire signée et barycentre. | + +`board_photo_vision` fournit `load_photo`, `label_components`, `fill_holes`, +`otsu_threshold`, `detect_markers`, `dots_near`, `rectify` et `extract_board`. + +## Développement + +```powershell +python -m venv .venv +.venv\Scripts\activate +pip install pytest numpy pillow lxml tinycss2 cssselect +python -m pytest -q # 57 passés, 20 ignorés (sans inkex) +$env:PYTHONPATH = 'C:\Program Files\Inkscape\share\inkscape\extensions' +python -m pytest -q # 77 passés +``` + +Les tests couvrent : + +- le noyau : conversion de repère, disposition des repères, homographie, + contours, simplification, vérification du placement (9 cas), disposition de + la feuille A4, traits d'alignement, gabarits, barres de contrôle et + correction d'impression ; +- le traitement d'image : composantes connexes, trous, seuil d'Otsu, grille + de pixels du redressement (aucun décalage d'un demi-pixel), détection des + repères dans les 4 orientations, repères imprimés collés sur leur gabarit, + et **test d'échelle** complet sur photo synthétique en perspective (trous à + 0,5 mm près) ; +- le bout en bout des deux entrées de menu : repères gravés, feuille A4 (tailles + imprimées exactes, barres de 100 mm, dessin dans la page, correction + d'imprimante), gabarits de pose, document en mm et en px, import + répété, erreurs, repli et calibration manuelle, repères aux angles du nid + d'abeille (origine et écart déduits, photo débordant de la page) ; +- l'**export LaserGRBL simulé** (sélection des formes et coordonnées du G-code de + l'extension v1.21) : seules les formes de « Découpes » partent, à la bonne + place et à la bonne taille en document mm et px ; photo et contour ne sont + pas exportés ; +- la caméra distante, contre un faux serveur lancé dans son propre processus : + adresses acceptées, nouvelle et dernière photo, erreur 500 du serveur, + réponse qui n'est pas une image, transmission coupée (nouvelle tentative), + machine injoignable ; +- les traductions et la cohérence des `.inx` (paramètres ↔ arguments et + défauts, réglages de zone de travail identiques entre import et repères). + +### Traductions + +```bash +python i18n.py # extract + update + compile +python i18n.py extract # po/board_photo.pot depuis les .inx et les .py +python i18n.py update # reporte le modèle dans po/en.po et po/fr.po +python i18n.py compile # po/*.po -> locale/*/LC_MESSAGES/board_photo.mo +``` + +Les textes source (`.inx` et appels `_()`) sont en anglais ; les deux `.inx` +partagent le domaine `board_photo`. Après modification d'un texte : lancer +`python i18n.py`, compléter les `msgstr` vides de `po/fr.po`, relancer. 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) +``` + +Le schéma est dessiné avec les fonctions du noyau (disposition et dessin des +repères, homographie). L'export PNG passe par +`C:\Program Files\Inkscape\bin\inkscape.com`. diff --git a/board_photo_common.py b/board_photo_common.py new file mode 100644 index 0000000..3b94cb0 --- /dev/null +++ b/board_photo_common.py @@ -0,0 +1,173 @@ +# coding=utf-8 +""" +Outils inkex partages par les entrees de menu « Board photo ». + +Page a la taille de la zone de travail, calques reperes par un attribut +`data-board-photo`. Les textes +affiches restent dans les scripts (appels _() extraits par i18n.py). +""" + +import re + +import inkex + +DATA = "data-board-photo" # attribut qui marque nos calques et chemins +OUTLINE_SHAPE = "outline-path" # valeur portee par le chemin du contour +# Sur le calque de la photo : zone de travail (mm) utilisee pour la calibrer, « l h ». +AREA_ATTR = "data-board-photo-area" + +# Enfants de la racine qui ne sont pas du dessin : on insere les calques +# du fond juste apres eux. +_NOT_DRAWING = {"defs", "namedview", "metadata", "title", "desc", "style", "script"} + + +def mm_scale(svg): + """Unites utilisateur par millimetre du document.""" + return svg.unittouu("1mm") + + +def length_uu(svg, value, default=0.0): + """Attribut de longueur d'un element en unites utilisateur. + + Sans unite, la valeur est deja en unites utilisateur ; `unittouu` la + prendrait pour des px et la convertirait a tort. + """ + text = str(value if value is not None else "").strip() + if not text: + return default + if re.match(r"^[-+]?(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?$", text): + return float(text) + return svg.unittouu(text) + + +def prepare_page(svg, width, height, set_page=True): + """Page de `width` x `height` mm ; renvoie (uu par mm, origine x, origine y). + + L'echelle utilisateur existante est conservee (le viewBox suit la + nouvelle taille) : les objets deja presents gardent leurs dimensions. + """ + scale = mm_scale(svg) + box = svg.get("viewBox") + ox = oy = 0.0 + if box: + values = [float(v) for v in box.replace(",", " ").split()] + if len(values) == 4: + ox, oy = values[0], values[1] + if set_page: + svg.set("width", "{}mm".format(fmt(width))) + svg.set("height", "{}mm".format(fmt(height))) + svg.set("viewBox", "{} {} {} {}".format( + fmt(ox), fmt(oy), fmt(width * scale), fmt(height * scale))) + pages = svg.namedview.findall(inkex.addNS("page", "inkscape")) + if len(pages) == 1: + pages[0].set("width", fmt(width * scale)) + pages[0].set("height", fmt(height * scale)) + return scale, ox, oy + + +def fmt(value): + return "{:.6f}".format(value).rstrip("0").rstrip(".") + + +# Couleur des viseurs, portee par leur calque (voir `paint_layer`). +TARGET_COLOR = "#ff0000" + + +def paint_layer(layer, fill="none", stroke="none"): + """Donne au calque les couleurs de remplissage et de contour de ses formes. + + L'extension « Export to LaserGRBL » grave ou decoupe chaque chemin selon + les couleurs `fill` / `stroke` de son propre attribut style, sans tenir + compte des calques masques : nos formes d'aide (contour de la planche, + viseurs, rapport) ne portent donc aucune couleur a elles et heritent + celles de leur calque. Affichees a l'identique, jamais exportees. + """ + layer.style = inkex.Style({"fill": fill, "stroke": stroke}) + return layer + + +def target(cx, cy, radius, scale, label): + """Viseur (croix dans un cercle) centre en (cx, cy), unites utilisateur. + + Sans couleur propre : le poser dans un calque colore par `paint_layer`. + """ + path = inkex.PathElement() + path.set("d", ("M {x0},{cy} L {x1},{cy} M {cx},{y0} L {cx},{y1} " + "M {x1},{cy} A {r},{r} 0 1 1 {x0},{cy} " + "A {r},{r} 0 1 1 {x1},{cy} Z").format( + x0=fmt(cx - radius), x1=fmt(cx + radius), y0=fmt(cy - radius), + y1=fmt(cy + radius), cx=fmt(cx), cy=fmt(cy), r=fmt(radius))) + path.style = inkex.Style({"stroke-width": str(0.4 * scale)}) + path.label = label + return path + + +def center_of(elem): + """Centre de la boite englobante d'un element, en coordonnees du document.""" + return elem.bounding_box(elem.getparent().composed_transform()).center + + +def find_all(svg, key): + """Elements dont l'attribut data-board-photo vaut `key`.""" + return svg.xpath("//*[@{}='{}']".format(DATA, key)) + + +def remove_layers(svg, key): + for elem in find_all(svg, key): + elem.delete() + + +def new_layer(label, key, locked=False): + layer = inkex.Layer.new(label) + layer.set(DATA, key) + if locked: + layer.set("sodipodi:insensitive", "true") + return layer + + +def insert_bottom(svg, layer): + """Place un calque sous tout le dessin existant.""" + index = 0 + for index, child in enumerate(svg): + tag = child.TAG if hasattr(child, "TAG") else "" + local = str(child.tag).rsplit("}", 1)[-1] + if local not in _NOT_DRAWING and tag not in _NOT_DRAWING: + break + else: + index = len(svg) + svg.insert(index, layer) + + +def set_current_layer(svg, layer): + """Calque actif a l'ouverture : l'utilisateur dessine directement dedans.""" + svg.namedview.set(inkex.addNS("current-layer", "inkscape"), layer.get_id()) + + +# -------------------------------------------------------------------------- +# « Export to LaserGRBL » : origine du G-code au coin bas gauche de la page +# (viewBox), le remplissage ignorant l'abscisse du viewBox ; la page doit donc +# etre la zone de travail et commencer en 0 0. +# -------------------------------------------------------------------------- + + +def page_problems(svg): + """Defauts de la page qui decaleraient le G-code. + + `viewbox_offset` : viewBox ne commencant pas en 0 0 (le remplissage de + l'export ignore ce decalage) ; `page_size` : page differente de la zone + de travail de la photo calibree (l'origine du G-code est le bas gauche + de la page). + """ + problems = [] + box = svg.get_viewbox() + if abs(box[0]) > 1e-6 or abs(box[1]) > 1e-6: + problems.append("viewbox_offset") + photos = find_all(svg, "photo") + area = photos[0].get(AREA_ATTR) if photos else None + if area: + width, height = (float(v) for v in area.split()) + page_w = svg.unit_to_viewport(box[2], "mm") + page_h = svg.unit_to_viewport(box[3], "mm") + if abs(page_w - width) > 0.01 or abs(page_h - height) > 0.01: + problems.append("page_size") + return problems diff --git a/board_photo_core.py b/board_photo_core.py new file mode 100644 index 0000000..e49957c --- /dev/null +++ b/board_photo_core.py @@ -0,0 +1,539 @@ +# coding=utf-8 +""" +Noyau geometrique de l'extension « Board photo », sans dependance a inkex. + +Testable avec pytest seul et reutilisable hors Inkscape (scripts, schema +des parametres). Seule dependance : numpy, fourni avec Inkscape 1.x. + +Conventions : +- toutes les longueurs sont en millimetres ; +- repere SVG : origine en haut a gauche de la zone de travail, y vers le bas ; +- repere laser : origine en bas a gauche de la zone de travail, y vers le haut + (conversion par `laser_to_svg` / `svg_to_laser`, seul endroit ou l'on + retourne l'axe y) ; +- coordonnees image « continues » : le pixel (ligne r, colonne c) couvre le + carre [c, c+1] x [r, r+1], son centre est donc en (c + 0.5, r + 0.5) ; +- un contour (`rings`) est une liste d'anneaux, chaque anneau etant une liste + de points (x, y) fermee implicitement ; les trous suivent la regle pair-impair ; +- les 4 reperes de calibration sont toujours ranges dans l'ordre + haut-gauche, haut-droite, bas-droite, bas-gauche (repere SVG) ; le repere + « origine » (deux pastilles) est celui du bas-gauche, a l'origine laser. +""" + +import math + +import numpy as np + +# Indices des reperes dans l'ordre standard. +TOP_LEFT, TOP_RIGHT, BOTTOM_RIGHT, BOTTOM_LEFT = range(4) +ORIGIN_MARKER = BOTTOM_LEFT + +# Geometrie d'un repere, en fraction du cote du carre. +DOT_DIAMETER = 0.30 # pastille unique des reperes ordinaires +ORIGIN_DOT_DIAMETER = 0.25 # deux pastilles du repere origine +ORIGIN_DOT_OFFSET = 0.18 # decalage de chaque pastille sur la diagonale + + +def parse_color(value, default=("#b3b3b3", 1.0)): + """Couleur Inkscape (entier RGBA decimal ou 0x..., ou #rrggbb[aa]). + + Renvoie (couleur CSS #rrggbb, opacite entre 0 et 1). Le parametre + « color » d'Inkscape arrive sous forme d'entier RGBA ; on le decode + nous-memes pour ne pas dependre de l'API couleur d'inkex, qui a change + entre les versions 1.x. + """ + text = str(value).strip() + try: + if text.startswith("#"): + digits = text[1:] + if len(digits) == 3: + digits = "".join(c * 2 for c in digits) + if len(digits) == 6: + digits += "ff" + if len(digits) != 8: + return default + number = int(digits, 16) + else: + number = int(text, 0) + except ValueError: + return default + number &= 0xFFFFFFFF + red, green, blue = (number >> 24) & 255, (number >> 16) & 255, (number >> 8) & 255 + alpha = (number & 255) / 255.0 + return "#{:02x}{:02x}{:02x}".format(red, green, blue), round(alpha, 4) + + +def polylines_to_d(polylines, precision=4, closed=False): + """Donnees `d` d'un chemin SVG : une polyligne par sous-chemin.""" + fmt = "{:.%df},{:.%df}" % (precision, precision) + parts = [] + for polyline in polylines: + if len(polyline) < 2: + continue + parts.append("M " + fmt.format(*polyline[0])) + parts.extend("L " + fmt.format(*point) for point in polyline[1:]) + if closed: + parts.append("Z") + return " ".join(parts) + + +# -------------------------------------------------------------------------- +# Reperes laser / SVG et disposition des reperes de calibration +# -------------------------------------------------------------------------- + +def laser_to_svg(point, height): + """Point du repere laser (y vers le haut) -> repere SVG (y vers le bas).""" + return float(point[0]), float(height) - float(point[1]) + + +def svg_to_laser(point, height): + """Point du repere SVG -> repere laser ; la conversion est son propre inverse.""" + return laser_to_svg(point, height) + + +def marker_layout(height, origin_x, origin_y, spacing_x, spacing_y): + """Centres des 4 reperes en repere SVG, ordre HG, HD, BD, BG. + + (origin_x, origin_y) est le centre du repere origine en repere laser, + (spacing_x, spacing_y) l'ecart entre centres de reperes. + """ + laser = [(origin_x, origin_y + spacing_y), + (origin_x + spacing_x, origin_y + spacing_y), + (origin_x + spacing_x, origin_y), + (origin_x, origin_y)] + return [laser_to_svg(p, height) for p in laser] + + +PHOTO_MARGIN = 1.5 # marge autour des reperes, en tailles de repere + + +def photo_extent(width, height, origin_x, origin_y, spacing_x, spacing_y, size, + resolution): + """Rectangle (x0, y0, x1, y1) en mm, repere SVG, couvert par la photo redressee. + + La zone de travail, agrandie pour montrer les reperes en entier (avec leur + zone claire) quand ils sont colles autour. Bornes alignees sur la grille + des pixels (multiples de 1 / resolution) : la zone de travail tombe sur + des pixels entiers de l'image. + """ + centers = marker_layout(height, origin_x, origin_y, spacing_x, spacing_y) + reach = PHOTO_MARGIN * size + xs = [c[0] for c in centers] + ys = [c[1] for c in centers] + x0, x1 = min(0.0, min(xs) - reach), max(float(width), max(xs) + reach) + y0, y1 = min(0.0, min(ys) - reach), max(float(height), max(ys) + reach) + res = float(resolution) + return (math.floor(x0 * res + 1e-9) / res, math.floor(y0 * res + 1e-9) / res, + math.ceil(x1 * res - 1e-9) / res, math.ceil(y1 * res - 1e-9) / res) + + +def layout_problems(width, height, origin_x, origin_y, spacing_x, spacing_y, size, + reach=None): + """Liste des defauts de disposition (vide si les reperes tiennent dans la zone). + + `reach` : demi-emprise autour de chaque centre qui doit tenir dans la zone + (par defaut le demi-cote du repere ; `guide_reach` pour les gabarits). + """ + problems = [] + if min(width, height, spacing_x, spacing_y, size) <= 0: + problems.append("non_positive") + return problems + half = size / 2.0 if reach is None else reach + if (origin_x - half < 0 or origin_y - half < 0 + or origin_x + spacing_x + half > width + or origin_y + spacing_y + half > height): + problems.append("outside") + if spacing_x < 2 * size or spacing_y < 2 * size: + problems.append("too_close") + return problems + + +def circle_ring(center, radius, segments=72): + """Polygone regulier approchant un cercle (sens trigonometrique ecran).""" + cx, cy = center + return [(cx + radius * math.cos(2 * math.pi * k / segments), + cy + radius * math.sin(2 * math.pi * k / segments)) + for k in range(segments)] + + +def marker_rings(center, size, origin=False): + """Anneaux d'un repere : carre plein + pastille(s) claire(s) (pair-impair). + + Le repere ordinaire porte une pastille centrale ; le repere origine en + porte deux sur la diagonale, ce qui permet de retrouver l'orientation + de la photo. + """ + cx, cy = center + half = size / 2.0 + square = [(cx - half, cy - half), (cx + half, cy - half), + (cx + half, cy + half), (cx - half, cy + half)] + if origin: + radius = ORIGIN_DOT_DIAMETER * size / 2.0 + offset = ORIGIN_DOT_OFFSET * size + dots = [circle_ring((cx - offset, cy - offset), radius), + circle_ring((cx + offset, cy + offset), radius)] + else: + dots = [circle_ring((cx, cy), DOT_DIAMETER * size / 2.0)] + return [square] + dots + + +# -------------------------------------------------------------------------- +# Reperes imprimes : feuille A4 a decouper et gabarits de pose +# -------------------------------------------------------------------------- + +A4 = (210.0, 297.0) +PIECE_FACTOR = 2.0 # cote d'une piece decoupee / cote du repere (zone claire) +TICK_LENGTH = 0.15 # longueur des traits d'alignement, en fraction du repere + + +def piece_side(size): + """Cote de la piece de papier a decouper autour d'un repere.""" + return PIECE_FACTOR * size + + +def sheet_layout(size, page=A4, margin=12.0, header=38.0, footer=22.0, gap=14.0): + """Centres des 4 pieces sur une feuille, ordre HG, HD, BD, BG ; None si trop grand. + + Grille 2 x 2 si elle tient (meme disposition que sur la surface : le + repere origine en bas a gauche), sinon une colonne. `gap` separe les + pieces et laisse la place d'une legende sous chacune. + """ + side = piece_side(size) + width = page[0] - 2 * margin + height = page[1] - 2 * margin - header - footer + if size <= 0: + return None + for columns in (2, 1): + rows = 4 // columns + grid_w = columns * side + (columns - 1) * gap + grid_h = rows * side + rows * gap + if grid_w <= width and grid_h <= height: + break + else: + return None + x0 = (page[0] - grid_w) / 2.0 + side / 2.0 + y0 = margin + header + side / 2.0 + pitch = side + gap + if columns == 2: + cells = [(0, 0), (1, 0), (1, 1), (0, 1)] + else: + cells = [(0, 0), (0, 1), (0, 2), (0, 3)] + return [(x0 + c * pitch, y0 + r * pitch) for c, r in cells] + + +def corner_layout(width, height, size): + """Reperes colles autour de la zone de travail, le coin interieur de chaque + piece de papier touchant un angle de la zone (nid d'abeille). + + Le centre de chaque repere est a une demi-piece (= taille du repere) de + l'angle, en X et en Y. Renvoie (origin_x, origin_y, spacing_x, spacing_y), + en mm, repere laser (origine a l'angle bas gauche de la zone). + """ + half = piece_side(size) / 2.0 + return -half, -half, float(width) + 2 * half, float(height) + 2 * half + + +def piece_ticks(center, size): + """Traits d'alignement au milieu de chaque bord de la piece, vers le centre. + + Ils se posent sur la croix du gabarit grave : le centre du repere tombe + alors exactement sur la position attendue. + """ + cx, cy = center + half = piece_side(size) / 2.0 + inner = half - TICK_LENGTH * size + return [[(cx - half, cy), (cx - inner, cy)], [(cx + inner, cy), (cx + half, cy)], + [(cx, cy - half), (cx, cy - inner)], [(cx, cy + inner), (cx, cy + half)]] + + +def piece_outline(center, size): + """Contour ferme de la piece (ligne de decoupe, ou gabarit de pose).""" + cx, cy = center + half = piece_side(size) / 2.0 + ring = [(cx - half, cy - half), (cx + half, cy - half), + (cx + half, cy + half), (cx - half, cy + half)] + return ring + [ring[0]] + + +def guide_reach(size): + """Demi-emprise d'un gabarit de pose : piece + croix qui depasse de size / 2.""" + return piece_side(size) / 2.0 + size / 2.0 + + +def guide_lines(center, size, overshoot=None): + """Gabarit de pose : contour de la piece et croix qui depasse de chaque cote.""" + cx, cy = center + half = piece_side(size) / 2.0 + reach = half + (size / 2.0 if overshoot is None else overshoot) + return [piece_outline(center, size), + [(cx - reach, cy), (cx - half, cy)], [(cx + half, cy), (cx + reach, cy)], + [(cx, cy - reach), (cx, cy - half)], [(cx, cy + half), (cx, cy + reach)]] + + +def scale_bar(start, length=100.0, step=10.0, tick=3.0, vertical=False): + """Barre de controle d'impression : trait de `length` mm gradue tous les `step`. + + Horizontale, graduations vers le haut ; verticale (vers le bas depuis + `start`), graduations vers la gauche. + """ + x0, y0 = start + count = int(round(length / step)) + if vertical: + lines = [[(x0, y0), (x0, y0 + length)]] + else: + lines = [[(x0, y0), (x0 + length, y0)]] + for k in range(count + 1): + h = tick * (1.6 if k in (0, count) else 1.0) + if vertical: + y = y0 + k * step + lines.append([(x0, y), (x0 - h, y)]) + else: + x = x0 + k * step + lines.append([(x, y0), (x, y0 - h)]) + return lines + + +def print_correction(measured_x, measured_y, nominal=100.0): + """Facteurs d'agrandissement qui compensent une imprimante qui reduit. + + Une barre de `nominal` mm mesuree `measured` mm apres impression : on + dessine `nominal / measured` fois plus grand pour qu'elle ressorte juste. + """ + return nominal / float(measured_x), nominal / float(measured_y) + + +def stretch_rings(rings, fx, fy, center): + """Etire les anneaux de (fx, fy) autour de `center`.""" + cx, cy = center + return [[(cx + (x - cx) * fx, cy + (y - cy) * fy) for x, y in ring] for ring in rings] + + +# -------------------------------------------------------------------------- +# Homographie (projection plane) a partir de 4 correspondances +# -------------------------------------------------------------------------- + +def _normalizer(points): + """Similitude qui centre les points et ramene leur distance moyenne a sqrt(2). + + Normalisation de Hartley : rend la resolution numerique stable quel que + soit l'ordre de grandeur des coordonnees (pixels contre millimetres). + """ + pts = np.asarray(points, dtype=float) + center = pts.mean(axis=0) + spread = np.sqrt(((pts - center) ** 2).sum(axis=1)).mean() + scale = math.sqrt(2) / spread if spread > 0 else 1.0 + return np.array([[scale, 0, -scale * center[0]], + [0, scale, -scale * center[1]], + [0, 0, 1]]) + + +def homography(src, dst): + """Matrice 3x3 qui envoie exactement 4 points `src` sur 4 points `dst`. + + Leve ValueError si la configuration est degeneree (3 points alignes). + """ + src = np.asarray(src, dtype=float) + dst = np.asarray(dst, dtype=float) + if src.shape != (4, 2) or dst.shape != (4, 2): + raise ValueError("4 points attendus") + ts, td = _normalizer(src), _normalizer(dst) + s = apply_homography(ts, src) + d = apply_homography(td, dst) + rows, rhs = [], [] + for (x, y), (u, v) in zip(s, d): + rows.append([x, y, 1, 0, 0, 0, -u * x, -u * y]) + rows.append([0, 0, 0, x, y, 1, -v * x, -v * y]) + rhs += [u, v] + a = np.array(rows) + if abs(np.linalg.det(a)) < 1e-12: + raise ValueError("points degeneres") + h = np.append(np.linalg.solve(a, np.array(rhs)), 1.0).reshape(3, 3) + matrix = np.linalg.inv(td) @ h @ ts + return matrix / matrix[2, 2] + + +def apply_homography(matrix, points): + """Applique une homographie a une liste de points (renvoie un tableau Nx2).""" + pts = np.asarray(points, dtype=float).reshape(-1, 2) + homog = np.hstack([pts, np.ones((len(pts), 1))]) @ np.asarray(matrix).T + return homog[:, :2] / homog[:, 2:3] + + +def local_scale(matrix, point): + """Facteur d'echelle local (moyenne geometrique) de l'homographie en un point.""" + x, y = point + eps = 1.0 + p = apply_homography(matrix, [(x, y), (x + eps, y), (x, y + eps)]) + jac = np.array([p[1] - p[0], p[2] - p[0]]) / eps + return math.sqrt(abs(np.linalg.det(jac))) + + +def is_convex_quad(points): + """Vrai si les 4 points (dans l'ordre) forment un quadrilatere convexe.""" + pts = np.asarray(points, dtype=float) + signs = [] + for k in range(4): + a, b, c = pts[k], pts[(k + 1) % 4], pts[(k + 2) % 4] + cross = (b[0] - a[0]) * (c[1] - b[1]) - (b[1] - a[1]) * (c[0] - b[0]) + signs.append(cross) + return all(s > 0 for s in signs) or all(s < 0 for s in signs) + + +def order_corners(points): + """Range 4 points (repere image, y vers le bas) en HG, HD, BD, BG. + + Tri par angle autour du barycentre : robuste a une rotation de la + photo jusqu'a 45 degres ; au-dela, c'est le repere origine qui + retablit l'orientation (`rotate_to_origin`). + """ + pts = [tuple(map(float, p)) for p in points] + cx = sum(p[0] for p in pts) / 4.0 + cy = sum(p[1] for p in pts) / 4.0 + # atan2 en y vers le bas : HG ~ -135 deg, HD ~ -45, BD ~ 45, BG ~ 135. + return sorted(pts, key=lambda p: math.atan2(p[1] - cy, p[0] - cx)) + + +def rotate_to_origin(ordered, origin_index): + """Decale cycliquement 4 points ordonnes pour que `origin_index` passe en BG.""" + shift = (origin_index - ORIGIN_MARKER) % 4 + return [ordered[(k + shift) % 4] for k in range(4)] + + +# -------------------------------------------------------------------------- +# Contours d'un masque binaire +# -------------------------------------------------------------------------- + +# Rotation d'un quart de tour dans le sens horaire a l'ecran (y vers le bas). +def _turn_right(direction): + dx, dy = direction + return -dy, dx + + +def mask_to_rings(mask): + """Contours d'un masque binaire (tableau 2D) en coordonnees image continues. + + Suit les aretes entre pixels allumes et eteints (le premier plan reste a + droite du sens de parcours), puis prend le milieu de chaque arete : on + obtient un contour qui suit la frontiere a mieux que le demi-pixel, sans + marches d'escalier. Aux sommets en « damier », on tourne a droite, ce qui + separe deux pixels qui ne se touchent que par un coin. + """ + m = np.pad(np.asarray(mask, dtype=bool), 1) + edges = {} + + def add(rows, cols, start, direction): + for r, c in zip(rows.tolist(), cols.tolist()): + # (r, c) indices dans le masque borde : pixel d'origine (r-1, c-1). + x0, y0 = c - 1 + start[0], r - 1 + start[1] + edges.setdefault((x0, y0), []).append(direction) + + inner = m[1:-1, 1:-1] + # Arete du haut, parcourue vers la droite ; bas vers la gauche ; + # droite vers le bas ; gauche vers le haut (sens horaire a l'ecran). + r, c = np.nonzero(inner & ~m[:-2, 1:-1]) + add(r + 1, c + 1, (0, 0), (1, 0)) + r, c = np.nonzero(inner & ~m[2:, 1:-1]) + add(r + 1, c + 1, (1, 1), (-1, 0)) + r, c = np.nonzero(inner & ~m[1:-1, 2:]) + add(r + 1, c + 1, (1, 0), (0, 1)) + r, c = np.nonzero(inner & ~m[1:-1, :-2]) + add(r + 1, c + 1, (0, 1), (0, -1)) + + rings = [] + while edges: + start = next(iter(edges)) + direction = edges[start][0] + vertex = start + ring = [] + while True: + outgoing = edges.get(vertex) + if not outgoing or (ring and vertex == start): + break + if len(outgoing) == 1: + chosen = outgoing[0] + else: + # Sommet en damier : on tourne a droite. + right = _turn_right(direction) + chosen = right if right in outgoing else outgoing[0] + outgoing.remove(chosen) + if not outgoing: + del edges[vertex] + ring.append((vertex[0] + chosen[0] / 2.0, vertex[1] + chosen[1] / 2.0)) + vertex = (vertex[0] + chosen[0], vertex[1] + chosen[1]) + direction = chosen + if len(ring) >= 3: + rings.append(ring) + return rings + + +def _dp(points, tolerance): + """Douglas-Peucker iteratif sur une polyligne ouverte (extremites gardees).""" + pts = np.asarray(points, dtype=float) + keep = np.zeros(len(pts), dtype=bool) + keep[0] = keep[-1] = True + stack = [(0, len(pts) - 1)] + while stack: + first, last = stack.pop() + if last - first < 2: + continue + a, b = pts[first], pts[last] + seg = pts[first + 1:last] + ab = b - a + norm = math.hypot(ab[0], ab[1]) + if norm == 0: + dist = np.hypot(seg[:, 0] - a[0], seg[:, 1] - a[1]) + else: + dist = np.abs(ab[0] * (seg[:, 1] - a[1]) - ab[1] * (seg[:, 0] - a[0])) / norm + index = int(np.argmax(dist)) + if dist[index] > tolerance: + split = first + 1 + index + keep[split] = True + stack.append((first, split)) + stack.append((split, last)) + return [tuple(p) for p in pts[keep]] + + +def simplify_ring(ring, tolerance): + """Simplifie un anneau ferme (Douglas-Peucker) ; renvoie au moins 3 points.""" + if tolerance <= 0 or len(ring) <= 4: + return list(ring) + pts = np.asarray(ring, dtype=float) + # Coupe l'anneau entre deux points eloignes pour simplifier deux moities. + far = int(np.argmax(np.hypot(pts[:, 0] - pts[0, 0], pts[:, 1] - pts[0, 1]))) + if far == 0: + return list(ring) + first = _dp(list(pts[:far + 1]), tolerance) + second = _dp(list(pts[far:]) + [tuple(pts[0])], tolerance) + result = first[:-1] + second[:-1] + return result if len(result) >= 3 else list(ring) + + +def ring_area(ring): + """Aire signee (formule du lacet) ; le signe depend du sens de parcours.""" + pts = np.asarray(ring, dtype=float) + x, y = pts[:, 0], pts[:, 1] + return 0.5 * float(np.dot(x, np.roll(y, -1)) - np.dot(y, np.roll(x, -1))) + + +def ring_centroid(ring): + """Barycentre de la surface delimitee par un anneau.""" + pts = np.asarray(ring, dtype=float) + x, y = pts[:, 0], pts[:, 1] + xn, yn = np.roll(x, -1), np.roll(y, -1) + cross = x * yn - xn * y + area = cross.sum() / 2.0 + if area == 0: + return float(x.mean()), float(y.mean()) + return (float(((x + xn) * cross).sum() / (6 * area)), + float(((y + yn) * cross).sum() / (6 * area))) + + +def scale_rings(rings, factor, offset=(0.0, 0.0)): + """Multiplie les coordonnees des anneaux puis les decale.""" + ox, oy = offset + return [[(x * factor + ox, y * factor + oy) for x, y in ring] for ring in rings] + + +# -------------------------------------------------------------------------- +# Verification du placement des formes sur la planche +# -------------------------------------------------------------------------- diff --git a/board_photo_import.inx b/board_photo_import.inx new file mode 100644 index 0000000..7e84f29 --- /dev/null +++ b/board_photo_import.inx @@ -0,0 +1,156 @@ + + + + Board photo: import and calibrate + fr.alexp.board_photo.import + + + + + 400.0 + 400.0 + true + + + + + + + 20.0 + + 30.0 + 30.0 + 340.0 + 340.0 + + + + + + + + + + + + + + 5000 + + + + + 20 + + 4.0 + 85 + + + + true + + + + + 0 + 0.5 + 4.0 + 0.3 + 426885887 + + + + + images/parameters_en.png + + + + + + + + + all + + + + + + + diff --git a/board_photo_import.py b/board_photo_import.py new file mode 100644 index 0000000..5ec8bbf --- /dev/null +++ b/board_photo_import.py @@ -0,0 +1,401 @@ +#!/usr/bin/env python3 +# coding=utf-8 +""" +Extension Inkscape : importe la photo d'une planche posee sur la surface de +travail d'une decoupeuse laser, a l'echelle exacte de la zone de travail. + +Les 4 reperes de calibration (voir « Board photo: print calibration markers ») sont +detectes sur la photo, qui est redressee par homographie puis inseree sur la +page (1 mm photo = 1 mm document) ; le contour de la planche et ses trous +sont vectorises. Si la detection echoue, la photo brute est inseree avec 4 +viseurs a poser sur les reperes : on relance alors l'extension sur cette +selection (calibration manuelle). + +Traitement d'image dans board_photo_vision, geometrie dans board_photo_core, +sans dependance a inkex. +""" + +import base64 +import os +import sys +from urllib.parse import unquote, urlparse + +import inkex +from inkex.localization import localize + +# L'extension vit dans son propre sous-dossier des extensions Inkscape, qui +# n'est pas forcement dans sys.path : on l'y ajoute pour trouver ses modules. +sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) + +import board_photo_common as common # noqa: E402 +import board_photo_core as core # noqa: E402 +import board_photo_remote as remote # noqa: E402 +import board_photo_vision as vision # noqa: E402 + +# Installe _() dans les builtins : catalogue « board_photo » de la langue +# de l'interface (Inkscape transmet domaine et dossier par l'environnement), +# textes anglais d'origine sinon. +localize() + +# Au-dela, la taille mesuree des reperes trahit une erreur de reglage +# (positions ou taille des reperes) ou une mauvaise detection. +MARKER_SIZE_TOLERANCE = 0.05 + + +class BoardPhotoImport(inkex.EffectExtension): + """Photo calibree + contour vectorise de la planche, sur des calques dedies.""" + + def add_arguments(self, pars): + # Un argument par du .inx, memes noms et memes valeurs par defaut. + pars.add_argument("--tab", default="work_area") + pars.add_argument("--work_width", type=float, default=400.0) + pars.add_argument("--work_height", type=float, default=400.0) + pars.add_argument("--origin_x", type=float, default=30.0) + pars.add_argument("--origin_y", type=float, default=30.0) + pars.add_argument("--spacing_x", type=float, default=340.0) + pars.add_argument("--spacing_y", type=float, default=340.0) + pars.add_argument("--marker_size", type=float, default=20.0) + pars.add_argument("--marker_placement", default="corners") + pars.add_argument("--set_page", type=inkex.Boolean, default=True) + pars.add_argument("--photo_source", default="file") + pars.add_argument("--photo", default="") + pars.add_argument("--remote_host", default="") + pars.add_argument("--remote_port", type=int, default=5000) + pars.add_argument("--remote_endpoint", default="capture") + pars.add_argument("--remote_timeout", type=int, default=20) + pars.add_argument("--resolution", type=float, default=4.0) + pars.add_argument("--jpeg_quality", type=int, default=85) + pars.add_argument("--vectorize", type=inkex.Boolean, default=True) + pars.add_argument("--board_tone", default="lighter") + pars.add_argument("--threshold", type=int, default=0) + pars.add_argument("--smoothing", type=float, default=0.5) + pars.add_argument("--min_hole_area", type=float, default=4.0) + pars.add_argument("--simplify", type=float, default=0.3) + pars.add_argument("--outline_color", default="426885887") + + # ------------------------------------------------------------------ + # Point d'entree + # ------------------------------------------------------------------ + + def effect(self): + opt = self.options + self.notes = [] + if opt.marker_placement == "corners": + # Pieces de papier aux angles du nid d'abeille : positions deduites. + opt.origin_x, opt.origin_y, opt.spacing_x, opt.spacing_y = \ + core.corner_layout(opt.work_width, opt.work_height, opt.marker_size) + problems = core.layout_problems(opt.work_width, opt.work_height, opt.origin_x, + opt.origin_y, opt.spacing_x, opt.spacing_y, + opt.marker_size) + if "non_positive" in problems: + inkex.errormsg(_("Work area, marker spacing and marker size must be " + "strictly positive.")) + return + # Des reperes autour de la zone de travail (hors de portee de la laser) + # calibrent aussi bien la photo : seule leur gravure l'interdit + # (« print calibration markers »). + + selection = list(self.svg.selection.values()) + if selection: + found = self.manual_points(selection) + if found is None: + return + photo, points, oriented, manual_layer = found + areas = None + else: + photo = self.open_photo() + if photo is None: + return + gray = vision.gray_array(photo) + try: + detected = vision.detect_markers(gray) + except vision.MarkerError as error: + self.insert_manual(photo, error) + return + points, oriented, areas = (detected["points"], detected["oriented"], + detected["areas"]) + manual_layer = None + + self.calibrate(photo, points, oriented, areas) + if manual_layer is not None: + manual_layer.delete() + + # ------------------------------------------------------------------ + # Sources de la photo + # ------------------------------------------------------------------ + + def open_photo(self): + if self.options.photo_source == "remote": + return self.remote_photo() + path = (self.options.photo or "").strip() + if not path: + inkex.errormsg(_("Choose the photo of the board in the \"Photo\" tab " + "(or select a photo and 4 markers for a manual " + "calibration).")) + return None + if not os.path.isfile(path): + inkex.errormsg(_("Photo not found: {}").format(path)) + return None + try: + return vision.load_photo(path) + except (OSError, ValueError): + inkex.errormsg(_("This file cannot be read as an image: {}").format(path)) + return None + + def remote_photo(self): + """Photo demandee au serveur de capture de la machine distante.""" + opt = self.options + try: + url = remote.remote_url(opt.remote_host, opt.remote_port, opt.remote_endpoint) + data = remote.fetch_photo(url, opt.remote_timeout) + except remote.RemoteError as error: + messages = { + "no_host": _("Enter the address of the remote machine in the " + "\"Photo\" tab (for example 192.168.1.20)."), + "bad_host": _("Invalid remote address: {}"), + "unreachable": _("The remote machine cannot be reached ({}): check " + "its address, that the capture server is running " + "and that the port is open."), + "timeout": _("The remote machine did not answer in time ({}): " + "increase the timeout or check the network."), + "interrupted": _("The transfer of the photo was interrupted ({}), " + "even after a second attempt: check the network " + "and try again."), + "http": _("The capture server returned an error: {}"), + "not_image": _("The capture server did not return an image: {}"), + "too_large": _("The image returned by the capture server is too " + "large ({})."), + } + message = messages.get(error.reason, _("Remote capture failed: {}")) + inkex.errormsg(message.format(error.detail or error.reason)) + return None + try: + photo = vision.load_photo(data) + except (OSError, ValueError): + inkex.errormsg(_("The capture server did not return a readable image " + "({}).").format(url)) + return None + self.notes.append(_("Photo received from {} ({} x {} px).").format( + url, photo.width, photo.height)) + return photo + + def image_photo(self, image): + """Contenu d'un element : donnees incorporees ou fichier lie.""" + href = image.get("xlink:href") or image.get("href") or "" + try: + if href.startswith("data:"): + return vision.load_photo(base64.b64decode(href.split(",", 1)[1])) + if href.startswith("file:"): + href = unquote(urlparse(href).path).lstrip("/") if os.name == "nt" \ + else unquote(urlparse(href).path) + return vision.load_photo(self.absolute_href(href)) + except (OSError, ValueError, IndexError): + return None + + def manual_points(self, selection): + """Calibration manuelle : une photo et 4 viseurs poses sur les reperes.""" + images = [e for e in selection if isinstance(e, inkex.Image)] + others = [e for e in selection if not isinstance(e, inkex.Image)] + if len(images) != 1 or len(others) != 4: + inkex.errormsg(_("Manual calibration: select the photo and exactly 4 " + "small shapes centred on the markers (for example " + "Ctrl+A in the \"Manual calibration\" layer). " + "Deselect everything to import a new photo.")) + return None + image = images[0] + photo = self.image_photo(image) + if photo is None: + inkex.errormsg(_("The selected image cannot be read (embed it, or " + "check that the linked file still exists).")) + return None + + # Du document vers les pixels de la photo, a travers la transformation + # de l'image et de ses parents. + to_local = -image.composed_transform() + x = common.length_uu(self.svg, image.get("x")) + y = common.length_uu(self.svg, image.get("y")) + width = common.length_uu(self.svg, image.get("width")) + height = common.length_uu(self.svg, image.get("height")) + if width <= 0 or height <= 0: + inkex.errormsg(_("The selected image has no size.")) + return None + points = [] + for elem in others: + local = to_local.apply_to_point(common.center_of(elem)) + points.append(((local.x - x) * photo.width / width, + (local.y - y) * photo.height / height)) + dots = vision.dots_near(vision.gray_array(photo), points) + ordered = vision.orient_points(points, [d or 0 for d in dots]) + layer = image.getparent() + manual_layer = layer if layer is not None and layer.get(common.DATA) == "manual" \ + else None + return photo, ordered["points"], ordered["oriented"], manual_layer + + def insert_manual(self, photo, error): + """Detection impossible : photo brute + 4 viseurs a poser sur les reperes.""" + opt = self.options + scale, ox, oy = common.prepare_page(self.svg, opt.work_width, opt.work_height, + opt.set_page) + common.remove_layers(self.svg, "manual") + layer = common.paint_layer(common.new_layer(_("Manual calibration"), "manual"), + stroke=common.TARGET_COLOR) + self.svg.add(layer) + common.set_current_layer(self.svg, layer) + + # Photo ajustee a la page, proportions conservees. + fit = min(opt.work_width / photo.width, opt.work_height / photo.height) + width, height = photo.width * fit * scale, photo.height * fit * scale + image = self.make_image(photo, ox, oy, width, height) + layer.add(image) + + # Viseurs vers les coins de la photo, a deplacer sur les reperes. + radius = opt.marker_size * 0.4 * scale + for fx, fy in ((0.1, 0.1), (0.9, 0.1), (0.9, 0.9), (0.1, 0.9)): + layer.add(common.target(ox + fx * width, oy + fy * height, radius, scale, + _("Marker target"))) + + reason = {"none": _("no dark shape found"), + "too_few": _("{} marker(s) found out of 4").format(error.found), + "layout": _("the markers found do not form a rectangle")} + inkex.errormsg(_("Automatic marker detection failed ({}).").format( + reason.get(error.reason, error.reason))) + inkex.errormsg(_("The raw photo was placed in the \"Manual calibration\" " + "layer with 4 red targets: move each target onto the " + "centre of a marker (zoom in), select the layer " + "content (Ctrl+A) and run this extension again.")) + + # ------------------------------------------------------------------ + # Calibration et calques + # ------------------------------------------------------------------ + + def calibrate(self, photo, points, oriented, areas): + opt = self.options + targets = core.marker_layout(opt.work_height, opt.origin_x, opt.origin_y, + opt.spacing_x, opt.spacing_y) + if not core.is_convex_quad(points): + inkex.errormsg(_("The 4 marker positions do not form a convex " + "quadrilateral: check them and try again.")) + return + try: + matrix = core.homography(points, targets) + except ValueError: + inkex.errormsg(_("The 4 marker positions are aligned: check them " + "and try again.")) + return + + warnings = [] + if not oriented: + warnings.append(_("The origin marker (two dots) was not recognised: " + "the photo is assumed upright (origin at the " + "bottom left of the photo).")) + if areas: + sizes = [(area ** 0.5) * core.local_scale(matrix, point) + for area, point in zip(areas, points)] + worst = max(sizes, key=lambda s: abs(s - opt.marker_size)) + if abs(worst - opt.marker_size) > MARKER_SIZE_TOLERANCE * opt.marker_size: + warnings.append(_("A marker measures {:.1f} mm instead of {:.1f} mm: " + "check the marker positions and size in the " + "\"Work area\" tab.").format(worst, opt.marker_size)) + + # Photo agrandie autour de la zone de travail pour montrer les reperes + # colles autour ; la planche n'est cherchee que dans la zone de travail. + extent = core.photo_extent(opt.work_width, opt.work_height, opt.origin_x, + opt.origin_y, opt.spacing_x, opt.spacing_y, + opt.marker_size, opt.resolution) + rectified, valid = vision.rectify(photo, matrix, extent[2] - extent[0], + extent[3] - extent[1], opt.resolution, + offset=extent[:2]) + board = None + if opt.vectorize: + half = opt.marker_size + exclude = [(x - half, y - half, x + half, y + half) for x, y in targets] + col = int(round(-extent[0] * opt.resolution)) + row = int(round(-extent[1] * opt.resolution)) + area_w, area_h = vision.output_size(opt.work_width, opt.work_height, + opt.resolution) + board = vision.extract_board( + vision.gray_array(rectified)[row:row + area_h, col:col + area_w], + valid[row:row + area_h, col:col + area_w], opt.resolution, + lighter=opt.board_tone == "lighter", threshold=opt.threshold, + smoothing=opt.smoothing, min_hole_area=opt.min_hole_area, + simplify=opt.simplify, exclude=exclude) + if board is None: + warnings.append(_("No board found on the photo: try the other " + "\"Board tone\" or set the threshold by hand.")) + + scale, ox, oy = common.prepare_page(self.svg, opt.work_width, opt.work_height, + opt.set_page) + self.write_layers(rectified, board, scale, ox, oy, extent) + if "page_size" in common.page_problems(self.svg): + warnings.append(_("The page is not the size of the work area: the export " + "to LaserGRBL takes the bottom left of the page as the " + "laser origin, so tick \"Set the page to the work area " + "size\" before cutting.")) + + # Precision : taille d'un pixel de la photo au centre de la zone. + centre = (opt.work_width / 2.0, opt.work_height / 2.0) + pixel = 1.0 / core.local_scale(core.homography(targets, points), centre) + summary = _("Board photo calibrated: {:.2f} mm per photo pixel.").format(pixel) + summary = " ".join(self.notes + [summary]) + if board is not None: + summary += " " + _("{} hole(s) found.").format(board["holes"]) + for message in warnings: + inkex.errormsg(message) + inkex.errormsg(summary) + + def make_image(self, picture, x, y, width, height): + data = vision.encode_image(picture, quality=self.options.jpeg_quality) + image = inkex.Image() + image.set("xlink:href", "data:image/jpeg;base64," + + base64.b64encode(data).decode("ascii")) + for name, value in (("x", x), ("y", y), ("width", width), ("height", height)): + image.set(name, common.fmt(value)) + # Etirement exact sur le rectangle : c'est ce qui garantit l'echelle. + image.set("preserveAspectRatio", "none") + image.style = inkex.Style({"image-rendering": "optimizeQuality"}) + return image + + def write_layers(self, rectified, board, scale, ox, oy, extent=None): + opt = self.options + for key in ("photo", "outline"): + common.remove_layers(self.svg, key) + + photo_layer = common.new_layer(_("Board photo"), "photo", locked=True) + common.insert_bottom(self.svg, photo_layer) + x0, y0, x1, y1 = extent or (0.0, 0.0, opt.work_width, opt.work_height) + image = self.make_image(rectified, ox + x0 * scale, oy + y0 * scale, + (x1 - x0) * scale, (y1 - y0) * scale) + image.label = _("Calibrated photo") + photo_layer.add(image) + # Zone de travail de la calibration (controle de la page avant export). + photo_layer.set(common.AREA_ATTR, "{} {}".format( + common.fmt(opt.work_width), common.fmt(opt.work_height))) + + if board is not None: + color, opacity = core.parse_color(opt.outline_color) + outline_layer = common.paint_layer( + common.new_layer(_("Board outline"), "outline", locked=True), + fill=color, stroke=color) + photo_layer.addnext(outline_layer) + path = inkex.PathElement() + path.set("d", core.polylines_to_d( + core.scale_rings(board["rings"], scale, (ox, oy)), closed=True)) + path.style = inkex.Style({ + "fill-opacity": str(round(0.18 * opacity, 4)), + "fill-rule": "evenodd", + "stroke-opacity": str(opacity), "stroke-width": str(0.3 * scale)}) + path.set(common.DATA, common.OUTLINE_SHAPE) + path.label = _("Board outline ({} holes)").format(board["holes"]) + outline_layer.add(path) + + cuts = common.find_all(self.svg, "cuts") + if cuts: + cuts_layer = cuts[0] + else: + cuts_layer = common.new_layer(_("Cuts"), "cuts") + self.svg.add(cuts_layer) + common.set_current_layer(self.svg, cuts_layer) + + +if __name__ == "__main__": + BoardPhotoImport().run() diff --git a/board_photo_markers.inx b/board_photo_markers.inx new file mode 100644 index 0000000..b36d265 --- /dev/null +++ b/board_photo_markers.inx @@ -0,0 +1,98 @@ + + + + Board photo: print calibration markers + fr.alexp.board_photo.markers + + + + + + + + + + + 400.0 + 400.0 + true + + + 30.0 + 30.0 + 340.0 + 340.0 + 20.0 + + + + + 100.0 + 100.0 + + + + images/parameters_en.png + + + + + + + + + all + + + + + + + diff --git a/board_photo_markers.py b/board_photo_markers.py new file mode 100644 index 0000000..a7ccf5f --- /dev/null +++ b/board_photo_markers.py @@ -0,0 +1,228 @@ +#!/usr/bin/env python3 +# coding=utf-8 +""" +Extension Inkscape : dessine les 4 reperes de calibration de la surface de +travail de la decoupeuse laser, selon trois sorties : + +- « bed » (parametre mode) : reperes a graver directement sur la surface ; graves par la + laser elle-meme, ils sont exactement la ou l'import les attend ; +- « sheet » : feuille A4 a imprimer, reperes en grille a decouper, avec une + barre de 100 mm pour controler l'echelle d'impression ; +- « guides » : gabarits de pose a graver sur la surface (contour de la piece + et croix) pour coller les reperes imprimes a leur position exacte. + +Le repere origine (deux pastilles, en bas a gauche = origine laser) donne +l'orientation de la photo. + +Geometrie dans board_photo_core, sans dependance a inkex. +""" + +import os +import sys + +import inkex +from inkex.localization import localize + +# L'extension vit dans son propre sous-dossier des extensions Inkscape, qui +# n'est pas forcement dans sys.path : on l'y ajoute pour trouver ses modules. +sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) + +import board_photo_common as common # noqa: E402 +import board_photo_core as core # noqa: E402 + +# Installe _() dans les builtins : catalogue « board_photo » de la langue +# de l'interface, textes anglais d'origine sinon. +localize() + +SHEET_MARGIN = 12.0 # marge de la feuille imprimee (mm) + + +class BoardPhotoMarkers(inkex.EffectExtension): + """Reperes a graver, feuille A4 a imprimer, ou gabarits de pose.""" + + def add_arguments(self, pars): + # Un argument par du .inx, memes noms et memes valeurs par defaut. + pars.add_argument("--tab", default="work_area") + pars.add_argument("--mode", default="bed") + pars.add_argument("--work_width", type=float, default=400.0) + pars.add_argument("--work_height", type=float, default=400.0) + pars.add_argument("--origin_x", type=float, default=30.0) + pars.add_argument("--origin_y", type=float, default=30.0) + pars.add_argument("--spacing_x", type=float, default=340.0) + pars.add_argument("--spacing_y", type=float, default=340.0) + pars.add_argument("--marker_size", type=float, default=20.0) + pars.add_argument("--set_page", type=inkex.Boolean, default=True) + pars.add_argument("--print_x", type=float, default=100.0) + pars.add_argument("--print_y", type=float, default=100.0) + + def effect(self): + opt = self.options + if opt.mode == "sheet": + self.print_sheet() + return + # Un gabarit de pose (piece + croix) est plus grand que le repere seul. + reach = core.guide_reach(opt.marker_size) if opt.mode == "guides" else None + problems = core.layout_problems(opt.work_width, opt.work_height, opt.origin_x, + opt.origin_y, opt.spacing_x, opt.spacing_y, + opt.marker_size, reach) + if "non_positive" in problems: + inkex.errormsg(_("Work area, marker spacing and marker size must be " + "strictly positive.")) + return + if "outside" in problems and reach is not None: + inkex.errormsg(_("The placement guides do not fit in the work area: keep " + "every marker centre at least {:g} mm from the edges " + "(1.5 x the marker size).").format(reach)) + return + if "outside" in problems: + inkex.errormsg(_("The markers do not fit in the work area, so the laser " + "cannot engrave them: reduce the spacing or move the " + "origin marker. Markers placed around the work area " + "(negative origin, larger spacing) are printed instead " + "(\"Output\": A4 sheet) and stuck in place by hand.")) + return + if "too_close" in problems: + inkex.errormsg(_("The markers are too close to each other: the spacing " + "must be at least twice the marker size.")) + return + + scale, ox, oy = common.prepare_page(self.svg, opt.work_width, opt.work_height, + opt.set_page) + centers = core.marker_layout(opt.work_height, opt.origin_x, opt.origin_y, + opt.spacing_x, opt.spacing_y) + if opt.mode == "guides": + self.draw_guides(centers, scale, ox, oy) + return + common.remove_layers(self.svg, "markers") + layer = common.new_layer(_("Calibration markers"), "markers") + self.svg.add(layer) + convert = self.converter(scale, ox, oy) + for index, center in enumerate(centers): + self.add_marker(layer, center, index == core.ORIGIN_MARKER, convert) + + # ------------------------------------------------------------------ + # Elements dessines + # ------------------------------------------------------------------ + + @staticmethod + def converter(scale, ox, oy, stretch=(1.0, 1.0), center=(0.0, 0.0)): + """Fonction anneaux en mm -> anneaux en unites du document. + + `stretch` agrandit autour de `center` (correction d'imprimante). + """ + def convert(rings): + rings = core.stretch_rings(rings, stretch[0], stretch[1], center) + return core.scale_rings(rings, scale, (ox, oy)) + return convert + + def add_marker(self, layer, center, origin, convert): + """Un chemin plein pair-impair par repere (carre + pastilles).""" + rings = core.marker_rings(center, self.options.marker_size, origin=origin) + path = inkex.PathElement() + path.set("d", core.polylines_to_d(convert(rings), closed=True)) + path.style = inkex.Style({"fill": "#000000", "fill-rule": "evenodd", + "stroke": "none"}) + path.label = _("Origin marker") if origin else _("Marker") + layer.add(path) + + @staticmethod + def add_lines(layer, polylines, style, convert, label): + """Un chemin de traits (polylignes en mm) dans le calque.""" + path = inkex.PathElement() + path.set("d", core.polylines_to_d(convert(polylines))) + path.style = style + path.label = label + layer.add(path) + + def draw_guides(self, centers, scale, ox, oy): + """Gabarits de pose : contour de chaque piece et croix passant par son centre.""" + size = self.options.marker_size + common.remove_layers(self.svg, "guides") + layer = common.new_layer(_("Marker placement guides"), "guides") + self.svg.add(layer) + style = inkex.Style({"fill": "none", "stroke": "#ff0000", + "stroke-width": str(0.1 * scale)}) + convert = self.converter(scale, ox, oy) + for index, center in enumerate(centers): + label = _("Origin marker") if index == core.ORIGIN_MARKER else _("Marker") + self.add_lines(layer, core.guide_lines(center, size), style, convert, label) + + def print_sheet(self): + """Feuille A4 : les 4 reperes en grille a decouper, legendes et barres de 100 mm.""" + opt = self.options + size = opt.marker_size + centers = core.sheet_layout(size, margin=SHEET_MARGIN) + if centers is None: + inkex.errormsg(_("These markers are too large for an A4 sheet: reduce the " + "marker size, or engrave them directly on the bed.")) + return + if not (80 <= opt.print_x <= 120 and 80 <= opt.print_y <= 120): + inkex.errormsg(_("The measured bar lengths must be between 80 and 120 mm.")) + return + width, height = core.A4 + # La feuille impose sa page : c'est elle que l'on imprime a 100 %. + scale, ox, oy = common.prepare_page(self.svg, width, height, True) + common.remove_layers(self.svg, "sheet") + layer = common.new_layer(_("Calibration markers (print)"), "sheet") + self.svg.add(layer) + + # Correction d'imprimante : tout le dessin est agrandi autour du centre + # de la page, pour que les barres ressortent a 100 mm une fois imprimees. + fx, fy = core.print_correction(opt.print_x, opt.print_y) + convert = self.converter(scale, ox, oy, (fx, fy), (width / 2.0, height / 2.0)) + + def text(x, y, content, font=3.5, bold=False, anchor="start"): + px, py = convert([[(x, y)]])[0][0] + node = inkex.TextElement() + node.set("x", common.fmt(px)) + node.set("y", common.fmt(py)) + node.text = content + node.style = inkex.Style({ + "font-family": "sans-serif", "font-size": common.fmt(font * fy * scale), + "font-weight": "bold" if bold else "normal", "text-anchor": anchor, + "fill": "#000000"}) + layer.add(node) + + m = SHEET_MARGIN + text(m, m + 7, _("Calibration markers - print at 100 %"), 6, True) + text(m, m + 15, _("Print at actual size (no \"fit to page\"), then check that " + "both bars measure 100 mm.")) + text(m, m + 21, _("Cut along the dashed lines and stick each piece outside a " + "corner of the honeycomb, its inner corner on that corner.")) + line = _("Marker size: {:g} mm").format(size) + if (fx, fy) != (1.0, 1.0): + line += " - " + _("printer correction: X {:.1f} %, Y {:.1f} %").format( + 100 * fx, 100 * fy) + text(m, m + 27, line) + + cut = inkex.Style({"fill": "none", "stroke": "#868e96", + "stroke-width": str(0.2 * scale), + "stroke-dasharray": "{0},{0}".format(common.fmt(1.5 * scale))}) + black = inkex.Style({"fill": "none", "stroke": "#000000", + "stroke-width": str(0.3 * scale)}) + names = [_("Top left"), _("Top right"), _("Bottom right"), + _("Origin - bottom left")] + half = core.piece_side(size) / 2.0 + for index, center in enumerate(centers): + origin = index == core.ORIGIN_MARKER + self.add_lines(layer, [core.piece_outline(center, size)], cut, convert, + _("Cutting line")) + self.add_lines(layer, core.piece_ticks(center, size), black, convert, + _("Alignment ticks")) + self.add_marker(layer, center, origin, convert) + text(center[0], center[1] + half + 5, names[index], 3.2, origin, "middle") + + # Deux barres : une imprimante peut reduire differemment en X et en Y. + bar_y = height - m - 6 + self.add_lines(layer, core.scale_bar((m, bar_y)), black, convert, + _("Scale bar X")) + text(m + 104, bar_y, _("100 mm (X)"), 3.5, True) + bar_x = width - m + 4 + top = m + 45 + self.add_lines(layer, core.scale_bar((bar_x, top), vertical=True), black, convert, + _("Scale bar Y")) + text(bar_x, top + 106, _("100 mm (Y)"), 3.5, True, "end") + + +if __name__ == "__main__": + BoardPhotoMarkers().run() diff --git a/board_photo_remote.py b/board_photo_remote.py new file mode 100644 index 0000000..2edc2f2 --- /dev/null +++ b/board_photo_remote.py @@ -0,0 +1,129 @@ +# coding=utf-8 +""" +Recuperation de la photo sur une machine distante (serveur HTTP de capture). + +Le serveur (par exemple un petit serveur Flask sur la machine qui porte la +camera) expose : +- /capture : prend une nouvelle photo et la renvoie (image/jpeg) ; +- /old : renvoie la derniere photo prise, sans en prendre de nouvelle. + +Bibliotheque standard seulement (urllib), sans dependance a inkex. +""" + +import http.client +import socket +from urllib.error import HTTPError, URLError +from urllib.parse import urlsplit, urlunsplit +from urllib.request import ProxyHandler, Request, build_opener + +DEFAULT_PORT = 5000 +ENDPOINTS = {"capture": "/capture", "old": "/old"} +MAX_BYTES = 64 * 1024 * 1024 # garde-fou : une photo ne depasse pas 64 Mo + + +class RemoteError(Exception): + """Echec de la recuperation ; `reason` est un code court, `detail` le message.""" + + def __init__(self, reason, detail=""): + Exception.__init__(self, reason) + self.reason = reason + self.detail = detail + + +def remote_url(host, port=DEFAULT_PORT, endpoint="capture"): + """URL de la photo : accepte « 192.168.1.20 », « 192.168.1.20:5000 » ou une URL. + + Un port ecrit dans l'adresse l'emporte sur `port` ; le chemin eventuel + de l'adresse est remplace par celui du point d'acces choisi. + """ + text = (host or "").strip() + if not text: + raise RemoteError("no_host") + if endpoint not in ENDPOINTS: + raise RemoteError("bad_endpoint", endpoint) + if "://" not in text: + if text.count(":") > 1 and not text.startswith("["): + text = "[{}]".format(text) # IPv6 nue : « fe80::1 » + text = "http://" + text + parts = urlsplit(text) + try: + explicit_port = parts.port + except ValueError: + raise RemoteError("bad_host", host) + hostname = parts.hostname + if not hostname or parts.scheme not in ("http", "https"): + raise RemoteError("bad_host", host) + if ":" in hostname: # IPv6 : crochets obligatoires + hostname = "[{}]".format(hostname) + netloc = "{}:{}".format(hostname, explicit_port or int(port)) + return urlunsplit((parts.scheme, netloc, ENDPOINTS[endpoint], "", "")) + + +def _read_limited(response, chunk=256 * 1024): + """Lit la reponse par blocs, jusqu'a MAX_BYTES + 1 octets au plus. + + Un read(MAX_BYTES + 1) allouerait d'emblee un tampon de 64 Mo : la + lecture par blocs borne la memoire a la taille reelle de la photo. + """ + parts, total = [], 0 + while total <= MAX_BYTES: + block = response.read(chunk) + if not block: + break + parts.append(block) + total += len(block) + return b"".join(parts) + + +def _fetch_once(url, timeout): + """Une tentative : ouverture (erreurs de connexion) puis lecture (coupures).""" + opener = build_opener(ProxyHandler({})) + request = Request(url, headers={"User-Agent": "Inkscape board_photo"}) + try: + response = opener.open(request, timeout=timeout) + except HTTPError as error: + # Le serveur explique l'echec dans le corps (« Error: Could not access + # the camera ») : on le fait suivre a l'utilisateur. + body = error.read(500).decode("utf-8", "replace").strip() + raise RemoteError("http", "{} {}".format(error.code, body).strip()) + except (socket.timeout, TimeoutError): + raise RemoteError("timeout", url) + except URLError as error: + if isinstance(error.reason, (socket.timeout, TimeoutError)): + raise RemoteError("timeout", url) + raise RemoteError("unreachable", str(error.reason)) + except OSError as error: + raise RemoteError("unreachable", str(error)) + # Connexion etablie : une erreur a partir d'ici est une transmission + # interrompue (reseau instable, coupure), pas une machine injoignable. + with response: + content_type = response.headers.get_content_type() + expected = response.headers.get("Content-Length") + try: + data = _read_limited(response) + except (OSError, http.client.HTTPException) as error: + raise RemoteError("interrupted", str(error) or type(error).__name__) + if len(data) > MAX_BYTES: + raise RemoteError("too_large", url) + if expected and expected.isdigit() and len(data) < int(expected): + raise RemoteError("interrupted", "{} / {}".format(len(data), expected)) + if not content_type.startswith("image/"): + text = data[:200].decode("utf-8", "replace").strip() + raise RemoteError("not_image", text) + return data + + +def fetch_photo(url, timeout=20.0, retries=1): + """Telecharge la photo ; renvoie ses octets ou leve RemoteError. + + Les proxys du systeme sont ignores : la camera est sur le reseau local, + un proxy d'entreprise ne saurait pas la joindre. Une transmission + interrompue est retentee `retries` fois ; les autres erreurs (machine + injoignable, erreur du serveur) sont remontees tout de suite. + """ + for attempt in range(retries + 1): + try: + return _fetch_once(url, timeout) + except RemoteError as error: + if error.reason != "interrupted" or attempt == retries: + raise diff --git a/board_photo_vision.py b/board_photo_vision.py new file mode 100644 index 0000000..bfb3d73 --- /dev/null +++ b/board_photo_vision.py @@ -0,0 +1,521 @@ +# coding=utf-8 +""" +Traitement d'image de l'extension « Board photo », sans dependance a inkex. + +Detection des reperes de calibration, redressement de la photo et +vectorisation de la planche. Dependances : numpy et Pillow, tous deux +fournis avec le Python d'Inkscape 1.x (pas d'OpenCV ni de scipy : les +composantes connexes sont calculees ici, par plages de pixels). + +Memes conventions que board_photo_core : millimetres, repere SVG (y vers le +bas), coordonnees image continues (centre du pixel (r, c) en (c+0.5, r+0.5)). +""" + +import io +import itertools +import math + +import numpy as np +from PIL import Image, ImageFilter, ImageOps + +import board_photo_core as core + +# Photo reduite a ce cote maximal pour la recherche des reperes (rapide, et +# le centre est ensuite affine en pleine resolution). +SEARCH_SIDE = 1600 + +# Passes du seuil adaptatif : (diviseur du cote de l'image donnant le rayon +# du voisinage, ecart de gris). La premiere convient aux reperes bien visibles ; +# les suivantes, plus locales, aux petits reperes (photo basse resolution ou +# prise de loin) colles a des pieces sombres qui assombrissent le voisinage. +ADAPTIVE_PASSES = ((12, 20), (32, 20), (32, 10), (64, 20), (64, 10)) + +# Moment d'inertie normalise (Ixx + Iyy) / aire^2 : 1/6 pour un carre, quelle +# que soit sa taille ; une perspective moderee le change peu. +SQUARE_MOMENT = 1.0 / 6.0 + +# Ecart minimal (niveaux de gris) entre planche et fond pour vectoriser. +MIN_CONTRAST = 25 + + +class MarkerError(Exception): + """Reperes introuvables ; `reason` est un code court, `found` le nombre vu.""" + + def __init__(self, reason, found=0): + Exception.__init__(self, reason) + self.reason = reason + self.found = found + + +# -------------------------------------------------------------------------- +# Chargement +# -------------------------------------------------------------------------- + +def load_photo(source): + """Ouvre une photo (chemin ou octets), redressee selon son EXIF, en RVB.""" + if isinstance(source, (bytes, bytearray)): + source = io.BytesIO(source) + image = Image.open(source) + image = ImageOps.exif_transpose(image) + return image.convert("RGB") + + +def gray_array(image): + """Niveaux de gris (0-255) en tableau numpy uint8.""" + return np.asarray(image.convert("L"), dtype=np.uint8) + + +def encode_image(image, fmt="JPEG", quality=90): + """Octets d'une image PIL (JPEG par defaut), pour l'incorporer au SVG.""" + buffer = io.BytesIO() + if fmt == "JPEG": + image.convert("RGB").save(buffer, "JPEG", quality=int(quality), optimize=True) + else: + image.save(buffer, fmt) + return buffer.getvalue() + + +# -------------------------------------------------------------------------- +# Composantes connexes (par plages de pixels, vectorise) +# -------------------------------------------------------------------------- + +def label_components(mask, connectivity=4): + """Etiquette les composantes connexes d'un masque booleen 2D. + + Renvoie (labels, count, areas) : image d'etiquettes int32 (0 = fond, + 1..count), nombre de composantes et aire de chacune (areas[0] = 0). + Travaille sur les plages horizontales de pixels, bien moins nombreuses + que les pixels : c'est assez rapide sans scipy. + """ + mask = np.asarray(mask, dtype=bool) + h, w = mask.shape + stride = w + 2 + padded = np.zeros((h, w + 2), dtype=np.int8) + padded[:, 1:-1] = mask + diff = np.diff(padded, axis=1) + rows, starts = np.nonzero(diff == 1) + _rows_end, ends = np.nonzero(diff == -1) # meme ordre que les debuts + count_runs = len(rows) + if count_runs == 0: + return np.zeros((h, w), dtype=np.int32), 0, np.zeros(1) + + # Plages de la ligne precedente qui touchent chaque plage : recherche + # dichotomique sur des cles (ligne, colonne) globalement triees. + k = 1 if connectivity == 8 else 0 + start_keys = rows * stride + starts + end_keys = rows * stride + ends + lo = np.searchsorted(end_keys, (rows - 1) * stride + starts - k, side="right") + hi = np.searchsorted(start_keys, (rows - 1) * stride + ends + k, side="left") + counts = np.clip(hi - lo, 0, None) + total = int(counts.sum()) + if total: + pi = np.repeat(np.arange(count_runs), counts) + offsets = np.arange(total) - np.repeat(np.cumsum(counts) - counts, counts) + pj = np.repeat(lo, counts) + offsets + else: + pi = pj = np.zeros(0, dtype=np.int64) + + # Fusion par accrochage au plus petit representant + compression des + # chemins, jusqu'a stabilite (quelques iterations). + parent = np.arange(count_runs) + while True: + ri, rj = parent[pi], parent[pj] + low = np.minimum(ri, rj) + new = parent.copy() + np.minimum.at(new, ri, low) + np.minimum.at(new, rj, low) + while True: + jumped = new[new] + if np.array_equal(jumped, new): + break + new = jumped + if np.array_equal(new, parent): + break + parent = new + + roots, run_labels = np.unique(parent, return_inverse=True) + run_labels = run_labels.astype(np.int64) + 1 + count = len(roots) + lengths = ends - starts + areas = np.bincount(run_labels, weights=lengths, minlength=count + 1) + + # Peinture des plages : +label au debut, -label a la fin, puis somme cumulee. + paint = np.zeros((h, w + 1), dtype=np.int64) + np.add.at(paint, (rows, starts), run_labels) + np.add.at(paint, (rows, ends), -run_labels) + labels = np.cumsum(paint, axis=1)[:, :w].astype(np.int32) + return labels, count, areas + + +def component_boxes(labels, count): + """Boites englobantes (r0, c0, r1, c1 exclus) de chaque etiquette 1..count.""" + rr, cc = np.nonzero(labels) + lab = labels[rr, cc] + r0 = np.full(count + 1, labels.shape[0]) + c0 = np.full(count + 1, labels.shape[1]) + r1 = np.zeros(count + 1, dtype=np.int64) + c1 = np.zeros(count + 1, dtype=np.int64) + np.minimum.at(r0, lab, rr) + np.minimum.at(c0, lab, cc) + np.maximum.at(r1, lab, rr + 1) + np.maximum.at(c1, lab, cc + 1) + return r0, c0, r1, c1 + + +def fill_holes(mask, connectivity=8, min_area=0): + """Bouche les trous d'un masque. + + Renvoie (masque plein, [masques des trous d'au moins `min_area` pixels]). + Les petits trous sont bouches mais pas renvoyes : on evite de construire + un masque par grain de bruit. + """ + mask = np.asarray(mask, dtype=bool) + labels, count, areas = label_components(~mask, connectivity) + border = set(np.concatenate([labels[0], labels[-1], labels[:, 0], + labels[:, -1]]).tolist()) + inner = np.array([k not in border for k in range(count + 1)]) + inner[0] = False + filled = mask | inner[labels] + holes = [labels == k for k in np.nonzero(inner & (areas >= min_area))[0].tolist()] + return filled, holes + + +def otsu_threshold(values): + """Seuil d'Otsu (0-255) d'un ensemble de niveaux de gris.""" + hist = np.bincount(np.asarray(values, dtype=np.uint8).ravel(), minlength=256) + hist = hist.astype(float) + total = hist.sum() + if total == 0: + return 128 + levels = np.arange(256) + weight0 = np.cumsum(hist) + weight1 = total - weight0 + sum0 = np.cumsum(hist * levels) + mean0 = np.divide(sum0, weight0, out=np.zeros(256), where=weight0 > 0) + mean1 = np.divide(sum0[-1] - sum0, weight1, out=np.zeros(256), where=weight1 > 0) + between = weight0 * weight1 * (mean0 - mean1) ** 2 + return int(np.argmax(between)) + + +# -------------------------------------------------------------------------- +# Detection des reperes de calibration +# -------------------------------------------------------------------------- + +def _shape_measures(filled): + """Barycentre (x, y continus), moment normalise et rapport d'allongement.""" + rr, cc = np.nonzero(filled) + area = float(len(rr)) + x, y = cc + 0.5, rr + 0.5 + mx, my = x.mean(), y.mean() + cov = np.cov(np.vstack([x, y]), bias=True) if area > 1 else np.eye(2) + eig = np.linalg.eigvalsh(cov) + moment = (cov[0, 0] + cov[1, 1]) / area if area else 0.0 + ratio = eig[0] / eig[1] if eig[1] > 0 else 0.0 + return (mx, my), moment, ratio, area + + +def analyse_marker(mask): + """Examine une composante sombre isolee (masque recadre). + + Renvoie un dictionnaire (barycentre, nombre de pastilles, aire pleine, + ecart au carre ideal) si la forme ressemble a un repere, None sinon. + """ + filled, holes = fill_holes(mask) + (cx, cy), moment, ratio, area = _shape_measures(filled) + if area < 36: + return None + rows, cols = filled.shape + if area / float(rows * cols) < 0.42 or ratio < 0.45: + return None + if not 0.14 <= moment <= 0.20: + return None + dots = [] + for hole in holes: + hole_area = float(hole.sum()) + if hole_area < 0.008 * area: + continue + (hx, hy), _m, _r, _a = _shape_measures(hole) + if math.hypot(hx - cx, hy - cy) > 0.4 * math.sqrt(area): + return None + dots.append(hole_area) + if len(dots) not in (1, 2): + return None + if not 0.02 <= sum(dots) / area <= 0.2: + return None + return {"center": (cx, cy), "dots": len(dots), "area": area, + "score": abs(moment - SQUARE_MOMENT)} + + +def _dark_mask_adaptive(gray, radius, offset=20): + """Pixels nettement plus sombres que leur voisinage (seuil adaptatif).""" + image = Image.fromarray(gray) + local = np.asarray(image.filter(ImageFilter.BoxBlur(radius)), dtype=np.int16) + return gray.astype(np.int16) < local - offset + + +def _best_four(candidates): + """Parmi les candidats, les 4 qui forment le plus grand quadrilatere convexe. + + Les reperes ont tous la meme taille : on ecarte les combinaisons dont les + aires varient de plus d'un facteur 4 (perspective forte comprise). + """ + pool = sorted(candidates, key=lambda c: c["score"])[:12] + best, best_area = None, 0.0 + for combo in itertools.combinations(pool, 4): + areas = [c["area"] for c in combo] + if max(areas) > 4 * min(areas): + continue + ordered = core.order_corners([c["center"] for c in combo]) + if not core.is_convex_quad(ordered): + continue + quad = abs(core.ring_area(ordered)) + if quad > best_area: + best, best_area = combo, quad + return list(best) if best else None + + +def _refine(gray, center, half): + """Affine un repere en pleine resolution autour de `center` (seuil d'Otsu local).""" + h, w = gray.shape + cx, cy = center + r0, r1 = max(0, int(cy - half)), min(h, int(cy + half) + 1) + c0, c1 = max(0, int(cx - half)), min(w, int(cx + half) + 1) + crop = gray[r0:r1, c0:c1] + if crop.size == 0: + return None + dark = crop < otsu_threshold(crop) + labels, count, areas = label_components(dark, 8) + if not count: + return None + # Le centre tombe souvent sur une pastille claire : on essaie, de la plus + # petite a la plus grande, les composantes sombres dont la boite englobe + # le centre, et l'on garde la premiere qui a la forme d'un repere. + lr, lc = cy - r0, cx - c0 + b0, a0, b1, a1 = component_boxes(labels, count) + around = [k for k in range(1, count + 1) + if b0[k] <= lr < b1[k] and a0[k] <= lc < a1[k]] + for k in sorted(around, key=lambda k: areas[k]): + box = labels[b0[k]:b1[k], a0[k]:a1[k]] == k + info = analyse_marker(box) + if info is not None: + x, y = info["center"] + info["center"] = (x + a0[k] + c0, y + b0[k] + r0) + return info + return None + + +def _same_marker(a, b): + """Vrai si deux candidats designent le meme repere (passes successives).""" + (ax, ay), (bx, by) = a["center"], b["center"] + return math.hypot(ax - bx, ay - by) < 0.5 * math.sqrt(min(a["area"], b["area"])) + + +def _marker_candidates(small, factor, divisor, offset): + """Formes de repere trouvees par une passe du seuil adaptatif. + + `small` : photo reduite d'un facteur `factor` ; les centres et aires + renvoyes sont ramenes a la pleine resolution. + """ + sh, sw = small.shape + dark = _dark_mask_adaptive(small, max(4, max(sh, sw) // divisor), offset) + labels, count, areas = label_components(dark, 8) + if not count: + return [] + min_area = 64 + max_area = sh * sw / 40.0 + r0, c0, r1, c1 = component_boxes(labels, count) + candidates = [] + for k in np.nonzero((areas >= min_area) & (areas <= max_area))[0].tolist(): + bh, bw = r1[k] - r0[k], c1[k] - c0[k] + if bh < 8 or bw < 8 or not 0.4 <= bw / float(bh) <= 2.5: + continue + crop = labels[r0[k]:r1[k], c0[k]:c1[k]] == k + info = analyse_marker(crop) + if info is None: + continue + x, y = info["center"] + info["center"] = ((x + c0[k]) / factor, (y + r0[k]) / factor) + info["area"] /= factor * factor + info["half"] = 0.9 * max(bh, bw) / factor + candidates.append(info) + return candidates + + +def detect_markers(gray): + """Trouve les 4 reperes dans une photo (tableau de gris pleine resolution). + + Renvoie un dictionnaire : `points` (4 centres en coordonnees image, + ordre HG, HD, BD, BG du repere SVG), `areas` (aires pleines en pixels), + `oriented` (vrai si le repere origine a fixe l'orientation). Leve + MarkerError sinon. + """ + h, w = gray.shape + factor = min(1.0, SEARCH_SIDE / float(max(h, w))) + if factor < 1.0: + small_img = Image.fromarray(gray).resize( + (max(1, round(w * factor)), max(1, round(h * factor))), Image.BOX) + small = np.asarray(small_img, dtype=np.uint8) + else: + small = gray + candidates = [] + for divisor, offset in ADAPTIVE_PASSES: + for info in _marker_candidates(small, factor, divisor, offset): + if not any(_same_marker(info, other) for other in candidates): + candidates.append(info) + chosen = _best_four(candidates) if len(candidates) >= 4 else None + if chosen is not None: + break + if len(candidates) < 4: + raise MarkerError("too_few", len(candidates)) + if chosen is None: + raise MarkerError("layout", len(candidates)) + + refined = [] + for info in chosen: + better = _refine(gray, info["center"], info["half"]) if factor < 1.0 else None + refined.append(better or info) + return orient_points([r["center"] for r in refined], + [r["dots"] for r in refined], + [r["area"] for r in refined]) + + +def orient_points(points, dots, areas=None): + """Range les centres en HG, HD, BD, BG et fixe l'orientation par le repere origine.""" + if areas is None: + areas = [0.0] * len(points) + items = list(zip(points, dots, areas)) + angle_order = core.order_corners(points) + items.sort(key=lambda item: angle_order.index(tuple(map(float, item[0])))) + origins = [k for k, item in enumerate(items) if item[1] == 2] + oriented = len(origins) == 1 + if oriented: + items = core.rotate_to_origin(items, origins[0]) + return {"points": [item[0] for item in items], + "dots": [item[1] for item in items], + "areas": [item[2] for item in items], + "oriented": oriented} + + +def dots_near(gray, points): + """Nombre de pastilles du repere autour de chaque point (placement manuel). + + La taille de recherche vient de l'ecart entre points ; renvoie None pour + un point ou aucun repere n'est reconnu. + """ + pts = np.asarray(points, dtype=float) + spacing = min(math.hypot(*(pts[i] - pts[j])) + for i in range(len(pts)) for j in range(i + 1, len(pts))) + half = max(10.0, spacing / 8.0) + result = [] + for point in points: + info = _refine(gray, point, half) + result.append(info["dots"] if info else None) + return result + + +# -------------------------------------------------------------------------- +# Redressement +# -------------------------------------------------------------------------- + +def output_size(width_mm, height_mm, resolution): + """Taille en pixels de l'image redressee (au moins 1 x 1).""" + return (max(1, int(round(width_mm * resolution))), + max(1, int(round(height_mm * resolution)))) + + +def rectify(image, image_to_mm, width_mm, height_mm, resolution, fill=(255, 255, 255), + offset=(0.0, 0.0)): + """Photo redressee couvrant exactement le rectangle `width_mm` x `height_mm` + dont le coin haut gauche est en `offset` (mm, repere SVG ; zone de travail + par defaut). + + `image_to_mm` : homographie coordonnees image -> millimetres (repere SVG). + Le pixel (i, j) du resultat couvre offset + [j, j+1] x [i, i+1] / resolution mm. + Renvoie (image, masque des pixels couverts par la photo). + """ + out_w, out_h = output_size(width_mm, height_mm, resolution) + # Pillow attend l'application inverse : sortie (pixels) -> entree (pixels). + to_mm = np.array([[width_mm / out_w, 0.0, offset[0]], + [0.0, height_mm / out_h, offset[1]], + [0.0, 0.0, 1.0]]) + inverse = np.linalg.inv(image_to_mm) @ to_mm + inverse = inverse / inverse[2, 2] + coeffs = tuple(inverse.ravel()[:8].tolist()) + result = image.transform((out_w, out_h), Image.PERSPECTIVE, coeffs, + Image.BICUBIC, fillcolor=fill) + coverage = Image.new("L", image.size, 255).transform( + (out_w, out_h), Image.PERSPECTIVE, coeffs, Image.NEAREST, fillcolor=0) + return result, np.asarray(coverage) > 0 + + +# -------------------------------------------------------------------------- +# Vectorisation de la planche +# -------------------------------------------------------------------------- + +def _morph(mask, size, operation): + """Ouverture ('open') ou fermeture ('close') par un carre de cote `size` px.""" + if size < 3: + return mask + image = Image.fromarray(mask.astype(np.uint8) * 255) + first, second = ((ImageFilter.MinFilter, ImageFilter.MaxFilter) if operation == "open" + else (ImageFilter.MaxFilter, ImageFilter.MinFilter)) + image = image.filter(first(size)).filter(second(size)) + return np.asarray(image) > 127 + + +def extract_board(gray, valid, resolution, lighter=True, threshold=0, + smoothing=0.5, min_hole_area=4.0, simplify=0.2, exclude=()): + """Contour et trous de la planche sur une image redressee (grille en mm). + + `valid` : pixels couverts par la photo ; `exclude` : rectangles + (x0, y0, x1, y1) en mm ignores (zones des reperes). Renvoie un + dictionnaire : `rings` (anneau exterieur puis trous, en mm), `holes` + (nombre), `threshold` (seuil utilise), `area` (mm2) ; None si aucune + planche n'est trouvee. + """ + gray = np.asarray(gray, dtype=np.uint8) + valid = np.asarray(valid, dtype=bool).copy() + h, w = gray.shape + for x0, y0, x1, y1 in exclude: + c0, c1 = max(0, int(math.floor(x0 * resolution))), min(w, int(math.ceil(x1 * resolution))) + r0, r1 = max(0, int(math.floor(y0 * resolution))), min(h, int(math.ceil(y1 * resolution))) + valid[r0:r1, c0:c1] = False + if not valid.any(): + return None + values = gray[valid] + level = int(threshold) if threshold and threshold > 0 else otsu_threshold(values) + # Sans contraste entre les deux classes, pas de planche discernable (photo + # uniforme, ou seuil manuel hors de la plage des gris). + low, high = values[values <= level], values[values > level] + if not len(low) or not len(high) or float(high.mean()) - float(low.mean()) < MIN_CONTRAST: + return None + board = (gray > level) if lighter else (gray <= level) + board &= valid + size = 2 * int(round(smoothing * resolution)) + 1 + board = _morph(_morph(board, size, "open"), size, "close") + + labels, count, areas = label_components(board, 4) + if not count: + return None + main = int(np.argmax(areas)) + pixel_area = 1.0 / (resolution * resolution) + if areas[main] * pixel_area < 100.0: # moins de 1 cm2 : pas de planche + return None + rr, cc = np.nonzero(labels == main) + r0, r1 = rr.min(), rr.max() + 1 + c0, c1 = cc.min(), cc.max() + 1 + # Marge d'un pixel pour que le fond exterieur touche toujours le bord du cadre. + comp = np.pad(labels[r0:r1, c0:c1] == main, 1) + outer_mask, kept = fill_holes(comp, 8, min_area=min_hole_area / pixel_area) + + def to_mm(ring): + return [((x + c0 - 1) / resolution, (y + r0 - 1) / resolution) for x, y in ring] + + def main_ring(mask): + rings = core.mask_to_rings(mask) + ring = max(rings, key=lambda r: abs(core.ring_area(r))) + return core.simplify_ring(to_mm(ring), simplify) + + rings = [main_ring(outer_mask)] + [main_ring(hole) for hole in kept] + area = abs(core.ring_area(rings[0])) - sum(abs(core.ring_area(r)) for r in rings[1:]) + return {"rings": rings, "holes": len(kept), "threshold": level, "area": area} diff --git a/deploy.ps1 b/deploy.ps1 new file mode 100644 index 0000000..034269c --- /dev/null +++ b/deploy.ps1 @@ -0,0 +1,115 @@ +<# +.SYNOPSIS + Déploie l'extension « Photo de planche » (2 entrées de menu) dans Inkscape. + +.DESCRIPTION + Copie les deux entrées de menu (board_photo_import, board_photo_markers : + .inx + .py), les modules board_photo_core, + board_photo_vision, board_photo_common et board_photo_remote, le schéma de l'onglet + « Diagram » (images\parameters_en.png) et les traductions + compilées (locale\\LC_MESSAGES\board_photo.mo) dans un + sous-dossier dédié du répertoire des extensions utilisateur d'Inkscape + (Inkscape explore récursivement ce répertoire). Refuse de s'exécuter si + Inkscape est ouvert : les extensions ne sont chargées qu'au démarrage. + +.PARAMETER ExtensionsDir + Répertoire des extensions Inkscape. Par défaut : %APPDATA%\inkscape\extensions + +.PARAMETER FolderName + Nom du sous-dossier de l'extension. Par défaut : Planche photo + +.PARAMETER Uninstall + Supprime le sous-dossier de l'extension au lieu de le créer. + +.PARAMETER Force + Déploie même si Inkscape est en cours d'exécution. + +.EXAMPLE + .\deploy.ps1 + .\deploy.ps1 -Uninstall + .\deploy.ps1 -FolderName 'autre-nom' +#> + +[CmdletBinding()] +param( + [string] $ExtensionsDir = (Join-Path $env:APPDATA 'inkscape\extensions'), + [string] $FolderName = 'Planche photo', + [switch] $Uninstall, + [switch] $Force +) + +$ErrorActionPreference = 'Stop' + +$files = @( + 'board_photo_import.inx', 'board_photo_import.py', + 'board_photo_markers.inx', 'board_photo_markers.py', + 'board_photo_core.py', 'board_photo_vision.py', 'board_photo_common.py', + 'board_photo_remote.py', + 'images\parameters_en.png' +) +$localeDir = 'locale' +$source = $PSScriptRoot +$destination = Join-Path $ExtensionsDir $FolderName + +# --- Inkscape doit être fermé : les extensions sont lues au démarrage --------- +$running = Get-Process -Name 'inkscape' -ErrorAction SilentlyContinue +if ($running -and -not $Force) { + Write-Error "Inkscape est ouvert. Fermez-le puis relancez le script (ou utilisez -Force)." + exit 1 +} + +# --- Désinstallation --------------------------------------------------------- +if ($Uninstall) { + if (Test-Path -LiteralPath $destination) { + Remove-Item -LiteralPath $destination -Recurse -Force + Write-Host "Supprimé : $destination" -ForegroundColor Green + } + else { + Write-Host "Rien à supprimer : $destination n'existe pas." -ForegroundColor Yellow + } + exit 0 +} + +# --- Vérification des sources ------------------------------------------------ +$missing = $files | Where-Object { -not (Test-Path -LiteralPath (Join-Path $source $_)) } +if (-not (Test-Path -LiteralPath (Join-Path $source $localeDir))) { + $missing = @($missing) + "$localeDir\ (lancer : python i18n.py)" +} +if ($missing) { + Write-Error "Fichier(s) introuvable(s) dans $source : $($missing -join ', ')" + exit 1 +} + +# --- Copie ------------------------------------------------------------------- +if (-not (Test-Path -LiteralPath $destination)) { + New-Item -ItemType Directory -Path $destination -Force | Out-Null + Write-Host "Dossier créé : $destination" +} + +foreach ($file in $files) { + $from = Join-Path $source $file + $to = Join-Path $destination $file + $action = if (Test-Path -LiteralPath $to) { 'remplacé' } else { 'copié ' } + New-Item -ItemType Directory -Path (Split-Path $to) -Force | Out-Null + Copy-Item -LiteralPath $from -Destination $to -Force + Write-Host " $action $file" +} + +# Traductions : le dossier est remplacé en entier (langue retirée => supprimée) +$localeTo = Join-Path $destination $localeDir +if (Test-Path -LiteralPath $localeTo) { + Remove-Item -LiteralPath $localeTo -Recurse -Force +} +Copy-Item -LiteralPath (Join-Path $source $localeDir) -Destination $localeTo -Recurse +$languages = Get-ChildItem -LiteralPath $localeTo -Directory | ForEach-Object Name +Write-Host " copié $localeDir\ ($($languages -join ', '))" + +# Le cache Python d'une version précédente peut masquer les fichiers copiés +$pycache = Join-Path $destination '__pycache__' +if (Test-Path -LiteralPath $pycache) { + Remove-Item -LiteralPath $pycache -Recurse -Force +} + +Write-Host "" +Write-Host "Extension déployée dans $destination" -ForegroundColor Green +Write-Host "Redémarrez Inkscape, puis : Extensions > AlexDesign > Photo de planche : ..." diff --git a/docs/apercu-feuille-a4.png b/docs/apercu-feuille-a4.png new file mode 100644 index 0000000000000000000000000000000000000000..9e0c670e332b6d789a5b050d45f052395b66d545 GIT binary patch literal 40186 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