diff --git a/README.md b/README.md
index b9b2306..5127bb4 100644
--- a/README.md
+++ b/README.md
@@ -7,16 +7,16 @@
-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é.
+Extension Inkscape pour réutiliser des planches déjà entamées (chutes,
+panneaux percés) à la découpeuse laser.
-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.
+On photographie la planche posée sur le nid d'abeille. L'extension redresse la
+photo et la place dans Inkscape **à l'échelle exacte** : 1 mm sur la photo =
+1 mm dans le document. Le contour de la planche et ses trous sont dessinés
+par-dessus.
+
+On place ensuite les formes à découper sur les parties pleines de la planche,
+puis on les envoie à la laser avec *Export to LaserGRBL*.
|
@@ -24,447 +24,157 @@ gauche de la page est l'origine laser.
## Sommaire
-- [Fonctionnalités](#fonctionnalités)
+- [Ce qu'il faut](#ce-quil-faut)
- [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)
+- [Réglages utiles](#réglages-utiles)
+- [En cas de problème](#en-cas-de-problème)
+- [Limites](#limites)
-## Fonctionnalités
+## Ce qu'il faut
-- **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.
+- **Inkscape 1.x** (testé avec Inkscape 1.4), rien d'autre à installer.
+- Une **imprimante** pour les 4 repères de calibration.
+- Un **appareil photo** (smartphone) ou une **caméra fixe** au-dessus de la
+ laser, reliée à une machine du réseau local qui fait tourner un serveur de
+ capture.
+- Pour découper : l'extension **Export to LaserGRBL**.
## 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
-### Windows (script)
+1. Fermer Inkscape.
+2. Dans le dossier de l'extension, clic droit sur `deploy.ps1` >
+ *Exécuter avec PowerShell* (ou, dans PowerShell : `.\deploy.ps1`).
+3. Relancer Inkscape : les commandes apparaissent dans
+ **Extensions > AlexDesign**.
-Fermer Inkscape, puis dans PowerShell, depuis le dossier du projet :
+Pour désinstaller : `.\deploy.ps1 -Uninstall`.
-```powershell
-.\deploy.ps1 # installe ou met à jour
-.\deploy.ps1 -Uninstall # désinstalle
-.\deploy.ps1 -Force # déploie même si Inkscape est ouvert
-```
+### Autres systèmes (ou à la main)
-Les fichiers sont copiés dans `%APPDATA%\inkscape\extensions\Planche photo`.
-Redémarrer Inkscape.
+Copier dans un nouveau dossier du répertoire des extensions d'Inkscape les
+fichiers `board_photo_*.inx`, `board_photo_*.py`, le dossier `images/` et le
+dossier `locale/`, puis relancer 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` |
+| Système | Répertoire 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** :
+### 1. Imprimer et coller les repères (une seule fois)
-
+
|
-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.
+1. Nouveau document, **Extensions > AlexDesign > Photo de planche : imprimer
+ les repères de calibration**.
+2. *Sortie* : **Feuille A4 à imprimer**, puis *Appliquer*.
+3. Imprimer **en taille réelle (100 %)**, sans « ajuster à la page ».
+ Vérifier à la règle que les deux barres mesurent bien **100 mm** (voir
+ [Imprimer à la bonne taille](#imprimer-à-la-bonne-taille)).
+4. Découper les 4 pièces le long des pointillés.
+5. Les coller **autour du nid d'abeille**, le coin intérieur de chaque pièce
+ sur un angle du nid. Le repère à **deux pastilles** va en **bas à gauche**.
+
+Ne plus déplacer les repères ensuite : ils donnent l'échelle et l'origine de
+chaque photo.
|
-Dans les deux cas, ne plus déplacer les repères : ils donnent l'échelle de
-chaque photo.
+#### Imprimer à la bonne taille
-#### Imprimer à la bonne échelle
+Si une barre mesure moins de 100 mm (souvent 97 mm), c'est l'impression qui a
+réduit la page :
-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. Enregistrer la feuille en PDF (*Fichier > Enregistrer une copie…*) et
+ l'imprimer depuis le lecteur PDF en **Taille réelle / 100 %**.
+2. Si les barres restent trop courtes, saisir leurs longueurs mesurées dans
+ l'onglet **Feuille imprimée**, régénérer la feuille et réimprimer.
-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.
+### 2. Photographier et importer la planche
-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.
+1. Poser la planche sur le nid d'abeille **sans cacher les repères**.
+2. Dans Inkscape, sans rien sélectionner : **Extensions > AlexDesign > Photo
+ de planche : importer et calibrer**.
+3. Onglet **Photo** :
+ - *Fichier photo* : choisir la photo, prise du dessus, les 4 repères
+ visibles ;
+ - ou *Appareil distant* : saisir l'adresse IP de la machine qui porte la
+ caméra (par exemple `192.168.1.20`) et choisir *nouvelle photo* ou
+ *dernière photo*.
+4. *Appliquer*.
-### 2. Importer une planche
+La page prend la taille du nid d'abeille, avec la photo redressée et le
+contour de la planche. Son **coin bas gauche est l'origine de la laser**. Le
+calque « Découpes » est prêt à recevoir les formes.
-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.
+Si les repères ne sont pas trouvés, la photo est posée telle quelle 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.
-#### Caméra distante
+### 3. Placer les formes et découper
-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).
+1. Dessiner ou coller les formes dans le calque **« Découpes »**, sur les
+ parties 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
+La photo et le contour de la planche ne sont jamais envoyés à la laser. Pour
+que la découpe tombe au bon endroit :
-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).
+- laisser cochée l'option *Mettre la page à la taille de la zone de travail* ;
+- utiliser des chemins, rectangles, cercles ou ellipses (sinon *Chemin > Objet
+ en chemin*), dans une couleur de l'export (gravure ou découpe) ;
+- ne pas mettre de formes remplies dans un groupe que l'on a déplacé.
-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.
+## Réglages utiles
-Pour que l'export soit juste :
+Dans **Importer et calibrer** :
-- 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é.
+| Réglage | Par défaut | À quoi il sert |
+| ------- | ---------- | -------------- |
+| Largeur / Hauteur (onglet *Zone de travail*) | 400 × 400 mm | Taille du nid d'abeille. |
+| Taille des repères | 20 mm | Côté du carré noir imprimé. À corriger si l'impression l'a réduit. |
+| Position des repères | Autour du nid d'abeille | Laisser ainsi avec des repères collés aux angles du nid. |
+| Teinte de la planche (onglet *Détection de la planche*) | Plus claire que le fond | Choisir *plus foncée* pour une planche sombre. |
+| Seuil | 0 (automatique) | À régler à la main si le contour est mal trouvé. |
+| Lissage | 0,5 mm | Plus grand : moins de poussières et de petits trous parasites. |
+| Aire minimale d'un trou | 4 mm² | Les trous plus petits sont ignorés. |
+| Résolution de la photo calibrée (onglet *Photo*) | 4 px/mm | Plus bas : document plus léger. |
-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*.
+L'onglet **Aide** de chaque commande rappelle la marche à suivre et montre le
+schéma ci-dessus.
-### Conseils
+## En cas de problème
-| 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é. |
+| Message ou symptôme | Que faire |
+| ------------------- | --------- |
+| « La détection automatique des repères a échoué » | Vérifier que les 4 repères sont visibles et bien éclairés, sans reflet ; rapprocher la caméra ; ou utiliser les 4 viseurs rouges. |
+| « Un repère mesure … mm au lieu de … mm » | Mesurer un carré noir à la règle et saisir sa vraie taille ; vérifier que chaque pièce touche bien un angle du nid. |
+| « Le repère origine (deux pastilles) n'a pas été reconnu » | Le repère à deux pastilles doit être en bas à gauche et bien visible. |
| « 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*. |
+| Contour qui déborde, trous parasites | Augmenter le *Lissage* ou l'*Aire minimale d'un trou*. |
+| « La machine distante est injoignable » | Vérifier l'adresse IP, que la machine est allumée et que le serveur de capture tourne. |
+| Document trop lourd | Baisser la *Résolution* ou la *Qualité JPEG*. |
-## Paramètres
+## Limites
-
-
-### 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 « Help » (déployé)
-docs/schema_parametres.py Générateur du schéma (fr pour le README, en pour le dialogue)
-docs/parametres.png Schéma du README
-docs/apercu-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`.
+- La précision dépend de la photo : environ la taille d'un pixel de la photo
+ au niveau du nid d'abeille (affichée après l'import). Une caméra en haute
+ résolution donne un résultat plus précis.
+- Éviter les objectifs grand angle : leur déformation n'est pas corrigée.
+- L'épaisseur de la planche n'est pas prise en compte : photographier d'assez
+ haut limite l'écart.
+- La planche ne doit pas cacher les repères.