Files
inkscape.calibrationDecoupe…/README.md
T
2026-09-27 12:55:02 +02:00

183 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
- [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.
- 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
![Schéma : repères collés autour du nid d'abeille, repères imprimés, photo redressée, contour et trous](docs/parametres.png)
### 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é.
## 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. |
| 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. |
| 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.