Documentation

README.md

@@ -1,10 +1,21 @@
 # Remplissage par cercles (circle packing) — extension Inkscape
 
+<table>
+<tr>
+<td width="50%" valign="top">
+<img src="docs/rendu.png" alt="Rectangle, cercle, chemin courbe et cadre troué remplis de cercles non chevauchants de tailles variées, chacun dans la couleur de sa forme source" width="420">
+</td>
+<td valign="top">
+
 Extension Inkscape 1.x qui remplit la surface d'une forme fermée avec des cercles
 non chevauchants, selon la technique du *greedy random circle packing* : des points
 sont tirés au hasard dans la forme, et sur chacun on place le plus grand cercle
 possible qui ne déborde pas du contour et ne touche aucun cercle déjà posé.
 
+</td>
+</tr>
+</table>
+
 ## Table of content
 
 - [Fonctionnalités](#fonctionnalités)
@@ -92,7 +103,9 @@ Les motifs très allongés donnent un remplissage plus lâche, leur cercle
 circonscrit étant large devant leur surface.
 
 Le fichier `tests/data/shapes.svg` contient quatre cas d'essai : rectangle, cercle,
-chemin courbe et chemin avec trou.
+chemin courbe et chemin avec trou. L'image en tête de ce README en est le rendu
+(graine 7, rayons de 0,6 à 12 mm, écart et marge de 0,4 mm, 40 000 tentatives,
+forme d'origine supprimée).
 
 Conseils de réglage :
 
@@ -131,6 +144,7 @@ packing_core.py        Noyau géométrique sans dépendance à inkex
 deploy.ps1             Déploiement / désinstallation sous Windows
 test_packing.py        Tests pytest
 tests/data/shapes.svg  Formes d'exemple
+docs/rendu.png         Image de présentation du README (non déployée)
 ```
 
 API de `packing_core.py` (utilisable seule, hors Inkscape) :