Documentation
This commit is contained in:
1 parent
d61686458e
commit
5dc977f9dd
9 files changed
+621
-3
No files matched your search
@@ -1,19 +1,32 @@
|
||||
# Boîte à créneaux pour Inkscape
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/apercu-boite.png" alt="Patron généré pour une boîte fermée de 100 × 80 × 50 mm : six pièces à créneaux rouges (avant, arrière, gauche, droite, fond, couvercle) disposées en grille" width="420">
|
||||
</td>
|
||||
<td valign="top">
|
||||
|
||||
Extension Inkscape 1.x qui génère le patron d'une boîte à découper au laser. Les faces s'assemblent par queues d'aronde droites (créneaux, _finger joints_) dont la largeur est paramétrable. Chaque pièce est un objet indépendant, déplaçable seul pour optimiser le placement sur la plaque.
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
## Table des matières
|
||||
|
||||
- [Fonctionnalités](#fonctionnalités)
|
||||
- [Installation](#installation)
|
||||
- [Utilisation](#utilisation)
|
||||
- [En ligne de commande](#en-ligne-de-commande)
|
||||
- [Paramètres](#paramètres)
|
||||
- [Le kerf : compensation du trait laser](#le-kerf--compensation-du-trait-laser)
|
||||
- [Le problème](#le-problème)
|
||||
- [Ce que fait l'extension](#ce-que-fait-lextension)
|
||||
- [Mesurer son kerf](#mesurer-son-kerf)
|
||||
- [Régler l'ajustement](#régler-lajustement)
|
||||
- [Structure du projet](#structure-du-projet)
|
||||
- [Développement](#développement)
|
||||
|
||||
## Fonctionnalités
|
||||
|
||||
@@ -29,12 +42,21 @@ Extension Inkscape 1.x qui génère le patron d'une boîte à découper au laser
|
||||
|
||||
## Installation
|
||||
|
||||
Copier `box_maker.inx`, `box_maker.py` et `box_core.py` dans `%APPDATA%\inkscape\extensions\boxMaker\`, puis redémarrer Inkscape.
|
||||
Inkscape fermé, depuis le dossier du projet (PowerShell) :
|
||||
|
||||
```powershell
|
||||
.\deploy.ps1 # installe dans %APPDATA%\inkscape\extensions\boxMaker
|
||||
.\deploy.ps1 -Uninstall # désinstalle
|
||||
```
|
||||
|
||||
Le script copie `box_maker.inx`, `box_maker.py`, `box_core.py` et le dossier `images\` (schéma de l'onglet « Schéma »). Options : `-ExtensionsDir`, `-FolderName`, `-Force` (déploie même si Inkscape est ouvert). Redémarrer ensuite Inkscape.
|
||||
|
||||
Installation manuelle : copier ces mêmes fichiers et le dossier `images\` dans `%APPDATA%\inkscape\extensions\boxMaker\`.
|
||||
|
||||
## Utilisation
|
||||
|
||||
1. Menu **Extensions > AlexDesign > Boîte à créneaux…**
|
||||
2. Régler les paramètres, cocher **Aperçu en direct** si besoin
|
||||
2. Régler les paramètres (illustrés dans l'onglet **Schéma**), cocher **Aperçu en direct** si besoin
|
||||
3. **Appliquer**
|
||||
|
||||
### En ligne de commande
|
||||
@@ -51,6 +73,23 @@ $env:PYTHONPATH = "C:\Program Files\Inkscape\share\inkscape\extensions"
|
||||
|
||||
Les options booléennes exigent une valeur (`--lid=true` / `--lid=false`). La couleur est un entier RGBA (`4278190335` = `0xff0000ff`, rouge).
|
||||
|
||||
## Paramètres
|
||||
|
||||

|
||||
|
||||
| Onglet | Paramètre | Défaut | Rôle |
|
||||
| ------------------- | -------------------------------------------- | ------------- | ------------------------------------------------------------------------ |
|
||||
| Dimensions | Longueur / Largeur / Hauteur (mm) | 100 / 80 / 50 | Taille de la boîte (schéma 1) |
|
||||
| Dimensions | Les dimensions sont | Extérieures | Intérieures : l'épaisseur est ajoutée (schéma 2) |
|
||||
| Dimensions | Boîte fermée (avec couvercle) | coché | Décoché : 5 pièces, bord haut des côtés droit |
|
||||
| Matière et créneaux | Épaisseur de la matière (mm) | 3 | Profondeur des créneaux et des encoches |
|
||||
| Matière et créneaux | Largeur des créneaux (mm, 0 = 3 × épaisseur) | 0 | Ajustée pour un nombre impair de créneaux par bord (schéma 3) |
|
||||
| Matière et créneaux | Compensation du trait laser, kerf (mm) | 0,1 | Contour élargi de kerf / 2 (schéma 4, [détails](#le-kerf--compensation-du-trait-laser)) |
|
||||
| Tracé | Espacement entre les pièces (mm) | 5 | Écart entre les pièces de la grille |
|
||||
| Tracé | Épaisseur du trait (mm) | 0,1 | Largeur du trait de découpe |
|
||||
| Tracé | Couleur du trait | rouge | Couleur du trait de découpe |
|
||||
| Tracé | Nommer les pièces (texte gravé !) | décoché | Ajoute le nom de chaque pièce en texte bleu |
|
||||
|
||||
## Le kerf : compensation du trait laser
|
||||
|
||||
### Le problème
|
||||
@@ -98,6 +137,39 @@ Le kerf dépend de la matière : refaire la mesure en changeant de matériau ou
|
||||
├── box_maker.py # Extension inkex : conversion en SVG, placement dans le calque
|
||||
├── box_core.py # Géométrie pure Python (mm) : créneaux, kerf, mise en page
|
||||
├── deploy.ps1 # Installation / désinstallation dans Inkscape
|
||||
├── images/
|
||||
│ └── parametres.png # Schéma de l'onglet « Schéma » (déployé)
|
||||
├── docs/ # Illustrations du README (non déployées)
|
||||
│ ├── apercu-boite.png # Patron d'exemple
|
||||
│ ├── parametres.png # Schéma des paramètres (+ sources .svg)
|
||||
│ └── schema_parametres.py # Générateur des deux versions du schéma
|
||||
└── tests/
|
||||
└── test_box_core.py # Tests unitaires de la géométrie
|
||||
```
|
||||
|
||||
## Développement
|
||||
|
||||
Environnement et tests (13 tests, géométrie pure, sans `inkex`) :
|
||||
|
||||
```powershell
|
||||
python -m venv .venv
|
||||
.\.venv\Scripts\Activate.ps1
|
||||
pip install pytest
|
||||
python -m pytest -q
|
||||
```
|
||||
|
||||
### Schéma des paramètres
|
||||
|
||||
`docs/schema_parametres.py` dessine le schéma avec les fonctions de `box_core.py` (il reste fidèle au rendu réel) et l'exporte en PNG via `C:\Program Files\Inkscape\bin\inkscape.com` :
|
||||
|
||||
```powershell
|
||||
python docs/schema_parametres.py # les deux versions
|
||||
python docs/schema_parametres.py readme # docs/parametres.png, 1400 px
|
||||
python docs/schema_parametres.py dialogue # images/parametres.png, 900 px, textes agrandis
|
||||
```
|
||||
|
||||
Relancer après toute modification de la géométrie ou des paramètres, puis `.\deploy.ps1`.
|
||||
|
||||
### Patron d'exemple
|
||||
|
||||
`docs/apercu-boite.png` est le résultat de l'extension sur un document vierge de 300 × 300 mm (boîte fermée 100 × 80 × 50 mm, épaisseur 3 mm, étiquettes activées, trait 0,4 mm), exporté par `inkscape.com --export-area-drawing --export-width=900`.
|
||||
Reference in new issue
Block a user