From 8aa057e40c981e0552cf114b25f87c51c522d5b2 Mon Sep 17 00:00:00 2001 From: Alex Date: Fri, 25 Sep 2026 17:40:17 +0200 Subject: [PATCH] Simplification du readme --- README.md | 518 ++++++++++++------------------------------------------ 1 file changed, 114 insertions(+), 404 deletions(-) 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) +![Schéma : repères collés autour du nid d'abeille, repères imprimés, photo redressée, contour et trous](docs/parametres.png) -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)
-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) +Feuille A4 : 4 repères noirs dans des pièces carrées à découper en pointillés, le repère origine à deux pastilles en bas à gauche, et deux barres de contrôle de 100 mm -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 -![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 « 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.