CommunityImagegithub.com

paper-brush

Dessinez des illustrations découpées en papier (portraits, avatars, personnages, scènes, icônes) de manière déterministe, sans modèle d'image. Utilisez-le pour un ensemble cohérent ou pour ajouter des images assorties.

Qu'est-ce que paper-brush ?

Paper Brush est un moteur de rendu vectoriel déterministe pour l'illustration plate de type « découpage papier ». Chaque image est une courte pile de formes colorées en papier, chacune découpée le long d'un chemin de style plume. Le même fichier de dessin produit toujours les mêmes pixels, garantissant la cohérence d'un ensemble, et toute forme peut être ajustée en modifiant quelques nombres. La taille, la couleur du papier et les proportions sont libres. Le moteur est livré sous forme de bloc de code dans `references/engine.md`. Il peut être extrait avec une commande `awk` sans jamais le retaper. L'exécution nécessite `numpy` et `opencv-python`. Le workflow comprend la configuration d'un fichier de dessins, le repérage sur une grille, l'esquisse des formes à partir d'un masque si utile, et le rendu via `python3 paper.py`. L'accent est mis sur un style épuré : peu de grandes formes, peu de nœuds avec de longs arcs, des tons limités (2-3 par matériau), des ombres nettes sans contours, et des lignes uniquement là où un trait de plume serait présent. Une fonctionnalité clé est l'adaptation à un ensemble existant. Il faut d'abord étudier les références et écrire les règles, puis recalibrer en redessinant une référence. Les parties porteuses du style (yeux, sourcils, oreilles) peuvent être « levées » depuis les images sources avec la commande `lift`. Un test de mélange à taille vignette (environ 480 px) permet de vérifier la cohérence avant présentation. Le système supporte les parties réutilisables (`PARTS`) pour les visages, ce qui garantit une unité visuelle. Paper Brush est compatible avec tout projet nécessitant des illustrations vectorielles cohérentes, reproductibles et modifiables manuellement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/paper-brush/tree/HEAD/skills/paper-brush

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Paper brush(纸艺画笔)

Un moteur de rendu déterministe pour l'illustration plate découpée en papier : chaque image est une courte pile de formes colorées en papier, chacune découpée le long d'un chemin de style plume. Même fichier de dessin en entrée, mêmes pixels en sortie, de sorte qu'un ensemble reste cohérent et que toute forme peut être ajustée en modifiant quelques nombres. N'importe quel format, couleur de papier et taille.

Configuration du moteur, une fois par projet : le moteur est livré sous forme de bloc de code dans references/engine.md. Copiez-le à l'aide d'une commande, sans jamais le retaper : awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py, où DIR est le dossier d'art du projet (ou un dossier temporaire) ; la même commande transforme references/example_drawings.md en un fichier de dessins pour démarrer. Exécutez-le avec python3 paper.py ... (nécessite numpy et opencv-python). Les commandes ci-dessous supposent que ce fichier existe. Si paper.py existe déjà à cet emplacement, réutilisez-le.

Le style (à respecter)

Lisez references/style.md avant de dessiner. En bref : peu de grandes formes ; peu de nœuds avec de longs arcs ; les vrais coins marqués comme coins ; 2 à 3 tons par matériau (base, ombre, parfois une lumière) ; les ombres sont des formes propres découpées à l'intérieur du parent, souvent avec un bord dur et un bord dégradé ; pas de contours autour des formes ; des lignes uniquement là où un trait de plume serait présent (sourcils, cils, bouche, pli) et toujours effilées ; le blush est le seul flou ; papier blanc chaud et un fine grain uniforme sur l'ensemble.

Flux de travail

  1. Configurez un fichier de dessins dans le projet (par exemple Tools/art/drawings.py) contenant DRAWINGS = {"nom": {...}}. Le format se trouve dans le docstring de paper.py (python3 paper.py sans argument l'affiche). Partez du fichier de dessins dans references/example_drawings.md.
  2. Choisissez une grille de travail et, si vous en avez une, une image de référence (un croquis, une peinture, une image approuvée) disposée sur cette grille. Lisez les coordonnées des nœuds à une échelle connue ; une petite lambda comme h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p] convertit depuis les pixels de la référence.
  3. Esquissez les formes à partir d'un masque si utile : créez un masque noir/blanc d'une région (seuil de couleur, masque manuel) et exécutez python3 paper.py nodes MASQUE.png [échelle] — il affiche les nœuds avec les coins déjà trouvés. Ensuite, affinez-les et nettoyez-les à la main ; le passage manuel est ce qui donne un aspect découpé, pas tracé.
  4. Rendu : python3 paper.py chemin/vers/drawings.py OUT_DIR [nom …] → OUT_DIR/<nom>.png.
  5. Regardez, comparez, ajustez. Placez le résultat à côté de la référence (ou de l'ensemble approuvé) à la taille à laquelle il sera vu, par exemple ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png, et ouvrez-le. Corrigez une chose à la fois : un nœud, un ton, un découpage. Prévoyez plusieurs cycles ; validez lorsque le propriétaire approuve.
  6. Livrez à la taille et au format du projet (réduisez avec Lanczos ; JPEG q≈88 ou PNG). Les images restent ≤ 2K. Si le projet applique un filigrane à ses illustrations, scellez après approbation, avant expédition.

Adapter à un ensemble existant

Lorsque de nouvelles images doivent rejoindre un ensemble qui a déjà un style (plus d'avatars à côté d'avatars approuvés), l'ordre est d'abord les règles, puis dessiner, puis itérer :

  1. Étudiez les références et écrivez les règles. Zoomez et mesurez : comment les bords sont construits, les tons par matériau, où se situent les formes d'ombre et leur épaisseur, les tailles et positions des caractéristiques sur les axes de la tête, la part de la tête dans le cadre, la couleur et le grain du papier.
  2. Calibrez : redessinez une référence avec le brush, placez-la à côté de l'originale, ajustez jusqu'à ce qu'elles correspondent.
  3. Levez les parties qui portent le style (yeux, sourcils, intérieur des oreilles) depuis les références : python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2 affiche la forme plate sous le pixel X,Y sous forme de nœuds sur les axes de cette tête. Superposez pour vérifier ; déplacez le point de départ s'il tombe sur la peau.
  4. Dessinez sur la source : python3 paper.py grid SOURCE.jpg grille.png donne une copie quadrillée (lignes tous les 20 px, étiquettes tous les 100) pour lire les coordonnées. Peu de nœuds par forme : environ 16 pour un visage, 20 à 40 pour une masse de cheveux.
  5. Test de mélange avant de montrer à quiconque : entrelacez les nouvelles images avec les références dans une grille à taille de vignette (environ 480 px). Si une nouvelle peut être repérée, elle n'est pas terminée. Ensuite, vérifiez chaque image en pleine taille à côté de sa référence la plus proche.

Ce qui ne fonctionne pas : les formes imaginées (tous les visages se ressemblent) ; suivre une peinture réaliste par couleur (copie ses bosses) ; vectoriser automatiquement les références (taches) ; copier directement les positions des caractéristiques d'un visage réaliste (la bouche est trop basse et le visage paraît long et vieux) ; prendre les formes d'ombre des zones sombres d'une peinture (taches).

Position typique du visage sur les axes de la tête (mesurez votre propre ensemble) : sourcils environ y −0,8, parallèles à la ligne des yeux ; nez comme un petit crochet du côté éloigné, x −0,3 à −0,65, y 0,45 à 1,15 ; bouche d'environ 1,1 unité de large à y 1,6 à 1,8, presque parallèle aux yeux, les deux extrémités à peu près à la même hauteur (une extrémité relevée donne un sourire en coin) ; menton y 2,8 à 3,1. Donnez à chaque personnage sa propre silhouette de cheveux, la forme de ses yeux et de ses sourcils, et sa palette, sinon l'ensemble dérive vers un seul visage. Pour les boucles serrées, les tresses et la laine, utilisez scallop() ; pour les cols tricotés ribs() ; pour les verres et les boutons oval() (from paper import scallop, ribs, oval).

Visages : parties réutilisables

Pour un ensemble de visages cohérents, donnez à chaque dessin "eyes": ((x, y), (x, y)). Cela définit les axes propres de la tête (x le long de la ligne des yeux, y vers le bas du visage, unité = moitié de la distance entre les yeux), de sorte que les caractéristiques peuvent être écrites une fois et placées sur n'importe quelle tête :

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} — nœuds en unités de tête (largeur aussi).
  • {"part": ("nom_ensemble", "oeil_g"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} — une partie provenant d'un fichier parts.py placé à côté du fichier de dessins : PARTS = {"nom_ensemble": {"oeil_g": {"nodes": [...]}, ...}}, nœuds en unités de tête. Levez les parties une fois à partir d'images approuvées (tracez le masque d'une partie avec nodes, convertissez en unités de tête), puis chaque nouveau visage les réutilise, ce qui maintient l'ensemble cohérent comme une seule main.
  • "mirror": True fait tourner un visage pour le regarder dans l'autre sens sans le redessiner.

Pièges

  • Les formes se peignent dans l'ordre ; un "clip" ne voit que les formes déjà peintes sous ce "nom".
  • Plusieurs couches avec le même "nom" s'additionnent (union), pratique pour un corps composé de deux parties.
  • Les points "fade" sont en coordonnées de grille : forts au premier, disparus au second.
  • "soft" est en unités de grille ; réservez-le au blush et aux lueurs uniquement.
  • Les dessins peuvent from paper import flow, scallop, ribs, oval : le dossier du moteur est dans le chemin.
  • Ne laissez pas un dessin dériver vers de nombreuses petites formes ou contours ; si un détail nécessite une ligne, demandez-vous si une forme de second ton ne le traduirait pas mieux.

Skills associés