Simplification du readme

This commit is contained in:
Alex committed 2026-09-25 17:40:17 +02:00
1 parent 9306f80c76
commit 8aa057e40c
1 file changed
+114 -404
+114 -404
View File
@@ -7,16 +7,16 @@
</td>
<td valign="top">
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*.
</td>
</tr>
@@ -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)
<table>
<tr>
<td width="40%" valign="top">
<img src="docs/apercu-feuille-a4.png" alt="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)" width="300">
<img src="docs/apercu-feuille-a4.png" alt="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" width="300">
</td>
<td valign="top">
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.
</td>
</tr>
</table>
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/<langue>/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.