253 lines
11 KiB
Markdown
253 lines
11 KiB
Markdown
# Photo de planche — extension Inkscape
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="top">
|
||
<img src="docs/apercu-import.png" alt="Photo de planche redressée sur une zone de travail de 400 × 400 mm, avec les 4 repères de calibration aux coins et le contour vectorisé de la planche et de ses trous en surimpression" width="420">
|
||
</td>
|
||
<td valign="top">
|
||
|
||
Extension Inkscape pour réutiliser des planches déjà entamées (chutes,
|
||
panneaux percés) à la découpeuse 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>
|
||
</table>
|
||
|
||
## Sommaire
|
||
|
||
- [Ce qu'il faut](#ce-quil-faut)
|
||
- [Installation](#installation)
|
||
- [Utilisation](#utilisation)
|
||
- [Mettre en place la caméra distante](#mettre-en-place-la-caméra-distante)
|
||
- [Réglages utiles](#réglages-utiles)
|
||
- [En cas de problème](#en-cas-de-problème)
|
||
- [Limites](#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](#mettre-en-place-la-caméra-distante)).
|
||
- Pour découper : l'extension **Export to LaserGRBL**.
|
||
|
||
## Installation
|
||
|
||
### Windows
|
||
|
||
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**.
|
||
|
||
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)
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="40%" valign="top">
|
||
<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. 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>
|
||
|
||
#### 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 :
|
||
|
||
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.
|
||
|
||
### 2. Photographier et importer la planche
|
||
|
||
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* ; *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.
|
||
4. *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
|
||
|
||
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**.
|
||
|
||
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`](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
|
||
|
||
1. Brancher la webcam en USB et vérifier qu'elle est vue
|
||
(`/dev/video0`) :
|
||
|
||
```bash
|
||
sudo apt install v4l-utils python3-opencv python3-flask
|
||
v4l2-ctl --list-devices
|
||
```
|
||
|
||
2. Copier `raspberry/capture_server.py` dans le dossier personnel du
|
||
Raspberry Pi (par exemple avec `scp`), puis le lancer :
|
||
|
||
```bash
|
||
python3 ~/capture_server.py
|
||
```
|
||
|
||
Le serveur écoute sur le **port 5000**, sur toutes les interfaces.
|
||
|
||
3. Depuis le PC, ouvrir `http://<adresse du Raspberry Pi>:5000/info` dans
|
||
un navigateur : la page affiche la résolution et le format retenus. Puis
|
||
`…/capture` doit afficher une photo.
|
||
|
||
4. Pour que le serveur démarre avec le Raspberry Pi, ajouter à la crontab
|
||
(`crontab -e`) la ligne :
|
||
|
||
```text
|
||
@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.
|