first commit
This commit is contained in:
commit
4993833586
17 files changed
+2215
No files matched your search
@@ -0,0 +1,175 @@
|
||||
# Remplissage motif relief — extension Inkscape
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" valign="top">
|
||||
<img src="doc/a57cd56c50f5c5bb0b0601f17f08704a.jpg" alt="Motif de référence : figures en Y en relief sur une grille isométrique" width="420">
|
||||
</td>
|
||||
<td valign="top">
|
||||
|
||||
Extension Inkscape 1.x qui remplit l'**intérieur** des formes sélectionnées avec un
|
||||
motif en relief : des figures en « Y » dessinées sur une grille isométrique
|
||||
(arêtes verticales et à ±30°), relevé fidèle de l'image de référence du dossier
|
||||
`doc/`. Les traits sont coupés exactement au bord de la forme, trous compris, et le
|
||||
résultat tient dans un seul chemin par forme.
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Une capture du résultat dans Inkscape (`docs/capture-desktop.png`) reste à ajouter.
|
||||
|
||||
## Sommaire
|
||||
|
||||
- [Fonctionnalités](#fonctionnalités)
|
||||
- [Installation](#installation)
|
||||
- [Utilisation](#utilisation)
|
||||
- [Paramètres](#paramètres)
|
||||
- [Structure du projet](#structure-du-projet)
|
||||
- [Développement](#développement)
|
||||
|
||||
## Fonctionnalités
|
||||
|
||||
- Motif périodique (maille hexagonale de 5 arêtes) calculé, pas importé : taille,
|
||||
rotation et origine réglables.
|
||||
- Formes gérées : chemins (courbes aplaties), rectangles, cercles, ellipses,
|
||||
polygones, polylignes, et groupes de ces éléments (transformations prises en
|
||||
compte). Les chemins composés avec trous restent vides à l'intérieur des trous.
|
||||
- Deux modes d'origine : centre de chaque forme (motif symétrique) ou origine du
|
||||
document (motif continu d'une forme à l'autre).
|
||||
- Segments alignés fusionnés : peu de nœuds, un seul chemin par forme, pas de
|
||||
`transform` sur les chemins produits.
|
||||
- Option : tracer aussi le contour de la forme ; option : conserver ou supprimer
|
||||
la forme d'origine.
|
||||
- Garde-fou : refus au-delà de 250 000 segments, avec un message d'aide.
|
||||
- Interface traduite en français et en anglais, selon la langue d'Inkscape
|
||||
(anglais pour toute autre langue).
|
||||
- Script de déploiement Windows (`deploy.ps1`).
|
||||
|
||||
## Installation
|
||||
|
||||
Aucune dépendance externe : l'extension utilise `inkex`, fourni avec Inkscape.
|
||||
|
||||
### Windows
|
||||
|
||||
Fermer Inkscape, puis, dans PowerShell, depuis le dossier du projet :
|
||||
|
||||
```powershell
|
||||
.\deploy.ps1 # installe
|
||||
.\deploy.ps1 -Uninstall # désinstalle
|
||||
.\deploy.ps1 -Force # installe même si Inkscape est ouvert
|
||||
```
|
||||
|
||||
Les fichiers sont copiés dans `%APPDATA%\inkscape\extensions\Remplissage motif relief`.
|
||||
|
||||
### Manuelle
|
||||
|
||||
Copier `relief_fill.inx`, `relief_fill.py`, `relief_core.py`, `images/` et `locale/`
|
||||
dans un sous-dossier du dossier d'extensions utilisateur :
|
||||
|
||||
| Système | Dossier |
|
||||
| ------- | ------- |
|
||||
| Windows | `%APPDATA%\inkscape\extensions\` |
|
||||
| Linux | `~/.config/inkscape/extensions/` |
|
||||
| macOS | `~/Library/Application Support/org.inkscape.Inkscape/config/inkscape/extensions/` |
|
||||
|
||||
Redémarrer Inkscape après l'installation.
|
||||
|
||||
## Utilisation
|
||||
|
||||
1. Sélectionner une ou plusieurs formes.
|
||||
2. Menu **Extensions > AlexDesign > Remplissage motif relief…** (*Relief Pattern Fill*).
|
||||
3. Régler la longueur d'arête, la rotation et l'origine, puis **Appliquer**.
|
||||
|
||||
Le résultat est un groupe « Remplissage relief » placé juste au-dessus de chaque
|
||||
forme sélectionnée.
|
||||
|
||||
**Conseils**
|
||||
|
||||
| Symptôme | Réglage |
|
||||
| -------- | ------- |
|
||||
| Motif trop fin ou trop dense | Augmenter la longueur d'arête |
|
||||
| « Trop de traits » | Augmenter la longueur d'arête ou sélectionner une forme plus petite |
|
||||
| « Aucun trait n'y tient » | Réduire la longueur d'arête |
|
||||
| Motif discontinu entre deux formes voisines | Choisir l'origine « Origine du document » |
|
||||
| Texte non rempli | Le convertir d'abord en chemins (Chemin > Objet en chemin) |
|
||||
|
||||
## Paramètres
|
||||
|
||||

|
||||
|
||||
| Paramètre | Défaut | Rôle |
|
||||
| --------- | ------ | ---- |
|
||||
| Longueur d'arête | 5 mm | Arête unitaire de la grille ; le motif se répète toutes les 5 arêtes |
|
||||
| Unité | mm | Unité de la longueur d'arête et de l'épaisseur des traits (mm, cm, px, pt, in) |
|
||||
| Rotation (degrés, sens horaire) | 0 | Fait tourner le motif autour de l'origine du motif |
|
||||
| Origine du motif | Centre de chaque forme | Nœud de la grille au centre de chaque forme, ou à l'origine du document |
|
||||
| Couleur des traits | noir | Couleur (et opacité) des traits |
|
||||
| Épaisseur des traits | 0,3 | Dans l'unité de l'onglet Motif |
|
||||
| Dessiner aussi le contour de la forme | non | Ajoute un chemin avec le contour de la forme |
|
||||
| Conserver la forme d'origine | oui | Sinon la forme sélectionnée est supprimée |
|
||||
|
||||
## Structure du projet
|
||||
|
||||
```text
|
||||
relief_fill.inx Boîte de dialogue (textes source en anglais)
|
||||
relief_fill.py Couche inkex : sélection, unités, aplatissement, écriture SVG
|
||||
relief_core.py Logique pure, sans inkex : motif, découpe
|
||||
i18n.py Extraction / mise à jour / compilation des traductions
|
||||
po/ relief_fill.pot, en.po, fr.po
|
||||
locale/<lang>/LC_MESSAGES/relief_fill.mo (générés, déployés)
|
||||
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
|
||||
doc/ Image de référence du motif
|
||||
tests/data/ SVG d'exemple pour les tests de bout en bout
|
||||
test_relief_fill.py Tests pytest
|
||||
deploy.ps1 Déploiement / désinstallation Windows
|
||||
```
|
||||
|
||||
API du noyau (`relief_core.py`) :
|
||||
|
||||
| Fonction | Rôle |
|
||||
| -------- | ---- |
|
||||
| `fill_rings(rings, edge, angle=0, anchor=(0, 0))` | Segments du motif à l'intérieur d'un contour (pair-impair) |
|
||||
| `pattern_segments(bbox, edge)` | Segments du motif couvrant une boîte, nœud (0, 0) à l'origine |
|
||||
| `clip_segment(p, q, rings)` | Parties d'un segment situées dans le contour |
|
||||
| `point_in_rings(point, rings)` | Appartenance au contour, règle pair-impair |
|
||||
| `rotate_point(point, angle, center)` | Rotation (sens horaire à l'écran) |
|
||||
| `rings_bbox(rings)` | Boîte englobante |
|
||||
| `segments_to_polylines(segments)` / `polylines_to_d(polylines)` | Conversion vers les données `d` d'un chemin SVG |
|
||||
| `parse_color(value)` | Couleur Inkscape (entier RGBA) → `#rrggbb` + opacité |
|
||||
|
||||
## Développement
|
||||
|
||||
```powershell
|
||||
python -m venv .venv ; .\.venv\Scripts\Activate.ps1
|
||||
pip install pytest lxml tinycss2 cssselect2 cssselect
|
||||
python -m pytest -q # 23 tests passés, 11 ignorés (sans inkex)
|
||||
$env:PYTHONPATH = 'C:\Program Files\Inkscape\share\inkscape\extensions'
|
||||
python -m pytest -q # 34 tests passés (avec inkex)
|
||||
```
|
||||
|
||||
Les tests couvrent le noyau (directions, périodicité, fusion des arêtes, découpe,
|
||||
trous, rotation, ancrage), le bout en bout (formes, courbes, trou, groupe
|
||||
transformé, échelle de page non standard, options) et la cohérence des
|
||||
traductions et du `.inx`.
|
||||
|
||||
### Traductions
|
||||
|
||||
```powershell
|
||||
python i18n.py # extrait, met à jour et compile ; liste les msgstr manquants
|
||||
```
|
||||
|
||||
Après modification d'un texte du `.inx` ou d'un `_("...")` : lancer `python i18n.py`,
|
||||
compléter les `msgstr` vides de `po/fr.po`, relancer. Ne jamais éditer les `.mo`.
|
||||
Pour ajouter une langue : l'ajouter à `LANGUAGES` dans `i18n.py`.
|
||||
|
||||
### Schéma des paramètres
|
||||
|
||||
```powershell
|
||||
python docs\schema_parametres.py # fr -> docs/parametres.png, en -> images/parameters_en.png
|
||||
```
|
||||
|
||||
L'export PNG passe par `inkscape.com`. Le schéma est calculé avec les vraies
|
||||
fonctions de `relief_core`.
|
||||
Reference in new issue
Block a user