Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Photo de planche — extension Inkscape
Sommaire
- Ce qu'il faut
- Installation
- Utilisation
- Mettre en place la caméra distante
- Réglages utiles
- En cas de problème
- Limites
Ce qu'il faut
- 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 (voir Mettre en place la caméra distante).
- Pour découper : l'extension Export to LaserGRBL.
Installation
Windows
- Fermer Inkscape.
- Dans le dossier de l'extension, clic droit sur
deploy.ps1> Exécuter avec PowerShell (ou, dans PowerShell :.\deploy.ps1). - Relancer Inkscape : les commandes apparaissent dans Extensions > AlexDesign.
Pour désinstaller : .\deploy.ps1 -Uninstall.
Autres systèmes (ou à la main)
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.
| 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. Imprimer et coller les repères (une seule fois)
|
Ne plus déplacer les repères ensuite : ils donnent l'échelle et l'origine de chaque photo. |
Imprimer à la bonne taille
Si une barre mesure moins de 100 mm (souvent 97 mm), c'est l'impression qui a réduit la page :
- Enregistrer la feuille en PDF (Fichier > Enregistrer une copie…) et l'imprimer depuis le lecteur PDF en Taille réelle / 100 %.
- 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.
2. Photographier et importer la planche
- Poser la planche sur le nid d'abeille sans cacher les repères.
- Dans Inkscape, sans rien sélectionner : Extensions > AlexDesign > Photo de planche : importer et calibrer.
- 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 ; Rotation de l'image (0°, 90°, 180° ou 270° dans le sens horaire) remet droite l'image d'une caméra montée de côté ou à l'envers.
- Appliquer.
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.
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.
3. Placer les formes et découper
- 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).
- Envoyer à la laser avec Extensions > Export > Export to 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 :
- 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é.
Mettre en place la caméra distante
Au lieu de photographier la planche à la main, l'extension peut demander la
photo à une webcam USB fixée au-dessus de la laser, branchée sur un
Raspberry Pi du réseau local. Le Raspberry Pi fait tourner le petit
serveur web raspberry/capture_server.py
(Flask + OpenCV), qui prend la photo dans la meilleure résolution de la
caméra.
Installer le serveur sur le Raspberry Pi
-
Brancher la webcam en USB et vérifier qu'elle est vue (
/dev/video0) :sudo apt install v4l-utils python3-opencv python3-flask v4l2-ctl --list-devices -
Copier
raspberry/capture_server.pydans le dossier personnel du Raspberry Pi (par exemple avecscp), puis le lancer :python3 ~/capture_server.pyLe serveur écoute sur le port 5000, sur toutes les interfaces.
-
Depuis le PC, ouvrir
http://<adresse du Raspberry Pi>:5000/infodans un navigateur : la page affiche la résolution et le format retenus. Puis…/capturedoit afficher une photo. -
Pour que le serveur démarre avec le Raspberry Pi, ajouter à la crontab (
crontab -e) la ligne :@reboot python3 $HOME/capture_server.py
Réglages en tête du script : DEVICE (numéro de la caméra, 0 pour
/dev/video0), WARMUP_FRAMES (images jetées le temps que l'exposition se
règle ; à augmenter si les photos sont sombres ou floues), JPEG_QUALITY.
| Adresse | Rôle |
|---|---|
/capture |
Prend une nouvelle photo et la renvoie (utilisée par l'extension). |
/old |
Renvoie la dernière photo prise, sans en reprendre une. |
/photo |
Prend une photo et renvoie seulement sa résolution (JSON). |
/info |
Résolution et format choisis pour la caméra (JSON). |
Conseil : donner au Raspberry Pi une adresse IP fixe (réservation DHCP dans la box) pour ne pas avoir à la ressaisir dans Inkscape.
Régler l'extension
Dans Importer et calibrer, onglet Photo :
- Source de la photo : Appareil distant ;
- Adresse de la machine distante : l'adresse IP du Raspberry Pi (par
exemple
192.168.1.20), Port :5000; - Image : Prendre une nouvelle photo (
/capture) ou Reprendre la dernière photo prise (/old) ; - Rotation de l'image : selon le montage de la caméra, pour que le repère à deux pastilles apparaisse en bas à gauche ;
- Délai d'attente : 20 s par défaut, à augmenter si la caméra est lente à régler son exposition.
Réglages utiles
Dans Importer et calibrer :
| Réglage | Par défaut | À quoi il sert |
|---|---|---|
| Largeur / Hauteur (onglet Zone de travail) | 400 × 400 mm | Taille du nid d'abeille. |
| Décalage du nid d'abeille X / Y | 0 mm | Position du coin bas gauche du nid par rapport au 0 de la laser, si le nid n'y est pas aligné (X vers la droite, Y vers le haut). Mesurer en envoyant la tête au 0,0. Sert seulement avec les repères autour 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. |
L'onglet Aide de chaque commande rappelle la marche à suivre et montre le schéma ci-dessus.
En cas de problème
| 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, 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. |
| « Le serveur de capture a renvoyé une erreur : 500 Impossible d'accéder à la caméra » | Vérifier que la webcam est branchée (v4l2-ctl --list-devices) et qu'aucun autre programme ne l'utilise ; corriger DEVICE dans le script. |
| Erreur 500 avec dernière photo | Aucune photo n'a encore été prise depuis le démarrage du Raspberry Pi : choisir nouvelle photo. |
| Document trop lourd | Baisser la Résolution ou la Qualité JPEG. |
Limites
- 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.


