Que fait Pinceau aquarelle ?
Deux choses, distinctes : un système de pinceau (papier, pigment, eau et coups de pinceau comme code ; déterministe) et un guide du peintre (comment réaliser une image avec). Le système exécute ce qu'on lui dit ; une bonne image vient des décisions du guide, prises en regardant. Pas de mode "valeurs par défaut uniquement" : chaque étape automatique est une proposition que vous repeignez. Le moteur est constitué de quatre blocs de code dans references/engine/, les fichiers du guide sont dans references/ ; chaque commande est exécutée depuis le dossier du moteur.
Configuration du moteur, une fois par projet : le moteur est livré sous la forme de quatre fichiers Markdown dans references/engine/ (wash.md, regions.md, look.md, selftest.md), chacun contenant un bloc de code. Copiez les quatre blocs à l'aide d'une commande, sans jamais les retaper (environ 190 Ko de code), par exemple pour chaque NOM :
awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine/NOM.md > DOSSIER/NOM.py, ce qui donne wash.py, regions.py, look.py et selftest.py dans un dossier du projet (par exemple art/watercolour/ ; s'ils sont déjà présents, réutilisez-les). Ce sont de simples scripts Python 3 (3.12 ou plus récent) qui nécessitent numpy et opencv-python-headless : installez-les comme indiqué sur leurs propres pages (numpy, opencv-python-headless ; le moteur a été testé avec numpy 2.5.5 et opencv-python-headless 5.1.0.95). Ensuite, python3 selftest.py vérifie la configuration. Pour démarrer à partir d'un exemple, copiez son dossier depuis references/examples/NOM/ (source.png, areas.json, …) dans le dossier du moteur sous examples/NOM/ et enregistrez son bloc de code (references/examples/NOM/NOM.md) sous NOM.py à l'intérieur de cette copie : l'exemple trouve ses données à côté de lui (persimmon n'a pas de données : seulement son bloc, sous examples/persimmon/persimmon.py). Chaque commande ci-dessous est exécutée depuis le dossier du moteur, par exemple python3 wash.py examples/cardigan/cardigan.py examples/cardigan/out.
Partie 1 : le système de pinceau (references/engine/ ; la docstring de chaque fichier est son manuel, imprimé lorsqu'il est exécuté sans arguments)
wash.py— le moteur. Une image est une feuille de papier pressé à froid et une liste de couches.python3 wash.py DESSINS.py DOSSIER_SORTIE [nom …]; peint à 2x puis réduit ; n'importe quelle taille jusqu'à 2K.- Peinture : lavis transparents qui se multiplient (les clairs sont du papier gardé sec avec
"out"ou retiré avec"lift") ; bords durs avec une lisière, étirements humides (neuds"w"),"soft","bleed";"grade", un dégradé humide à l'intérieur d'une forme ; pinceau sec, coups de"feather"; graphite."brush": une session humide de coups de pinceau chargés, l'unité de chaque grande zone : chaque coup aussi large qu'il est pressé ("w"), se fragmentant là où sa"load"s'épuise ; à l'intérieur de la session, ils se fondent les uns dans les autres ("wet"), sa limite extérieure est un bord dur unique ; les extrémités sont"cut"en biais, UN côté qui"melt"ou"drag"."knit"et"cable": points et tresses, placés après la forme, leur force lue sur les valeurs situées en dessous. Une couche avec un"name"est une zone à laquelle d'autres se"clip"ou restent"out";"eyes"et"head"donnent des unités de tête. - Eau (désactivée sauf si demandée ; "Caractère aquarelle" indique où et combien) :
"miss","ragged","dry","settle","sediment","broken", les couches"bloom"et"sparkle", le"seed"propre d'une couche. À partir d'un dessin sous-jacent ("under","masks") :study(lavis, grands et pâles vers petits et foncés),hatch,trace. - Aides (
from wash import …;python3 wash.py helpersimprime chaque argument). Les valeurs d'un vêtement :ladder(ses glacis à partir des couleurs de la source),need(l'alpha d'une tonalité mesurée à la suivante),toned(l'eau d'un lavis à la tonalité qu'il atteint, par la tache MESURÉE sur la source),step_to(les deux). Coups de pinceau :strokes_along(un champ entre deux lignes directrices, ou une forme que vous avez dessinée, rempli de coups qui suivent la forme),hem(les extrémités inégales des coups où un vêtement s'arrête : lobes, jamais de gouttes). Marques :runs,ribs,ring,arc,beside,scallop.nodes_ofébauche une silhouette ; il n'est jamais destiné à une forme d'ombre.
- Peinture : lavis transparents qui se multiplient (les clairs sont du papier gardé sec avec
regions.py— étapes 1 et 2, secondes chacune.propose SOURCE DOSSIERdécoupe la source en régions numérotées et devineareas.json; vous le corrigez (ids, points, polygones ;"approved": true) ;buildfabrique les masques, le dessin sous-jacent, les valeurs de départ.look.py— les yeux et instruments du peintre ; rien ne peint ; tout dans les coordonnées pixels de la source. Lire la source :grid(zoomé, avec coordonnées : chaque nœud est lu dessus, un par 40–50 px d'un bord long ; à l'œil encore 10–15 px de décalage),tones(rangées de tonalités),shapes(une zone en quatre valeurs ; pour regarder, pas pour tracer),values(les plus foncés 1 / 5 / 25 / 50 %, couleur),speck(combien de papier les lavis d'un vêtement montrent : son eau),ladder,glaze,over,frame. Se vérifier :paths(vos marques sur la source),layers(une couche ou une session SEULE, ou la feuille jusqu'à la couche N),holes(papier laissé ouvert à l'intérieur d'une session),diff(rendu moins source, cellule par cellule, et par zone la part des points dans 15 / 25 : cela dirige les cycles d'un vêtement),texture,setin.selftest.py— une ligne par promesse du moteur ; exécutez-le après avoir modifiéwash.pyouregions.py.
Comment se comporte la peinture
- Les lavis se multiplient.
clair = papier × (couleur / papier) ^ alpha, par canal : la couleur d'un lavis est ce qu'il donne sur du papier nu ; sur de la peinture, c'est un multiplicateur, et le même lavis deux fois donnecouleur². Ainsi, un vêtement est une couleur locale unique et une échelle de glacis qui lui est propre :SAGE, TURN, SHADE, DEEP, DARK, RIB = ladder(lumière, ombre, foncé, sur=papier_source), à partir de trois couleurs lues sur la source (une échelle copiée porte la teinte de l'autre vêtement). La force d'un glacis est arithmétique, pas visuelle :need(SHADE, 114, 66)est l'alpha qui fait passer la tonalité 114 à 66. - Rien de clair ne passe sur quelque chose de foncé. Un bouton, un clou, un reflet sur un lavis foncé devient noir à moins d'être réservé ou relevé (
worked-example.md,winter-clothes.md3). Ainsi, le plus foncé des deux vêtements est peint en second, quel que soit celui qui est au-dessus dans la réalité, sur UNE liste partagée de nœuds. Le plus clair ne passe EN DESSOUS que s'il est proche du papier ou que le vêtement supérieur est foncé, jamais un chaud sous un froid à mi-teinte (crème sous bleu-gris : boue) :look.py over DESSOUS DESSUS. - Le foncé est une densité, et l'eau est mesurée.
"grain","pool","settle","sediment"sont des parts du pigment et se montrent plus à mesure que la valeur diminue.look.py speck SRC mask=…lit ce que CE tissu montre (un manteau lisse 3–4 %, une veste matelassée 6–10 %) ;toned(GENRE, tonalité, PAPIER, speck=…)donne chaque lavis (dark-cloth.md1,winter-clothes.md0). - Bords. Les bords durs ont une lisière. Un nœud
"w"adoucit une bande d'environ 3 ×"wet"de large."clip"/"out"coupent net et ne laissent pas de lisière : dites ce bord avec une ombre portée ou le crayon. Les formes qui partagent un bord partagent"wobble". - Taille et hasard. Les chemins, largeurs et
"wet"sont en unités de grille ; les marques du pinceau et le papier sont dimensionnés par rapport à l'image ("fine","weave";starting-values.md). La probabilité d'une couche est la sienne : son"seed"relance.
Partie 2 : le guide du peintre
Lisez style.md en premier (le style visuel, mesuré). Commencez une image à partir de l'un des deux exemples commentés, chacun un fichier et une commande (configuré comme dans "Configuration du moteur") : examples/cardigan/cardigan.py (une NOUVELLE image à partir d'un croquis pâle : tête et visage, cheveux gris, un cardigan en tricot sur une chemise claire, fond de papier uni) ou examples/winter/winter.py (une image finie peinte à NOUVEAU : un enfant, longs cheveux foncés, une veste matelassée foncée, une écharpe, un pull en tricot, son propre lavis derrière). worked-example.md parcourt les deux ; dark-cloth.md et winter-clothes.md contiennent les règles des vêtements.
Ce qu'il peut et ne peut pas faire
Il repeint la surface, pas la manière : papier, profondeur, bords du lavis, crayon. L'identité, les proportions et la façon dont un visage est dessiné viennent de la source ; un dessin animé reste un dessin animé. Le guide est écrit pour les humains ; les petites choses prennent les mêmes marques (references/examples/persimmon/persimmon.md). Il ne peut pas inventer un visage : partez d'un dessin de cette personne en particulier qui a déjà le charme ; si ce n'est pas "quelle charmante personne" au premier coup d'œil, arrêtez. Une image réalisée par code est dictée en 1:1 d'abord par ses GRANDS VÊTEMENTS, puis par le fond et les cheveux : c'est là que vont le regard et le travail manuel.
L'ordre du travail
- Étudiez, puis décidez. Placez la source en 1:1 à côté des images avec lesquelles les vôtres doivent s'accorder (l'ensemble qu'elle rejoint ; sans ensemble,
style.md) et notez, avant de peindre : quelles lignes ce style ne dessinerait pas (un filet de rides, un contour fermé, de l'encre), ce qui se trouve derrière la figure, ce qui doit se lire comme fabriqué (cadres, boutons, une fermeture éclair). Une source qui est déjà une image finie dans ce style, à peindre à nouveau :"approved": truedansareas.json, la feuille sur le papier de la source, son fond conservé ;look.py frametrouve le cadre d'un portrait qui en a été extrait. - Zones.
regions.py propose, lisezregions.png, corrigezareas.json,build, lisezareas.pngen 1:1. Coupez d'abord par lieu ("within", polygones), puis par couleur ; quelques cycles de secondes, vêtements dessinés à la main sous forme de polygones. - Corrections du dessin sous-jacent, réalisées par
build: valeurs plus complètes par zone selon ce que la source y mesure (starting-values.md) ; fines lignes foncées sur la peau fermées, un tiers mélangé en retour ; les traits du visage tels que dessinés. - Grands lavis, pâles, peints autour des clairs, en coups de pinceau (la section suivante). Vêtements à la main d'abord ; tête, cou et mains à travers le dessin sous-jacent. Avant la première peinture :
look.py speck(l'eau de chaque vêtement),tones(là où il est foncé),paths(vos contours sur la source). Les tonalités sont mesurées et échelonnées (need), pas devinées. - Ombres : chacune est votre décision. Dix à vingt par vêtement : où elle commence, gonfle et se termine, quel bord est dur, ses nœuds lus sur
look.py grid; puis posées comme des coups de pinceau. Jamais un seuil de la source tracé en chemins (nodes_of, un masque) : boue marbrée, nuages aérographe, îles de courbes de niveau, et plus lent que vingt décisions. - Foncés : engagés tard, et une seule fois. Profondeurs des cheveux, sous le col et le menton, cœurs des plis, pupilles, la ligne des cils supérieurs ; jamais en assombrissant la peau. Sur un vêtement : après que la demi-teinte a séché, peu nombreux, grands et JOINTS, chaque coup chargé directement à sa tonalité ("Les foncés", ci-dessous) ; par étapes, un foncé devient un nuage doux.
- Texture après la forme (un tricot, des tresses) : une couche sur les valeurs finies ; une forme qui ne se lit pas sans retourne à l'étape 4. 7. Traits du visage : un passage exact, puis à la main, fins et pâles. 8. Crayon en dernier, et peu : là où une forme chevauche une autre. 9. Rehaussements pour les rares clairs perdus. Arrêtez quand un coup de pinceau expliquerait le vide.
Les grandes zones se peignent en coups de pinceau
Un vêtement construit en formes remplies est une mosaïque de lentilles plates, quelle que soit la justesse de ses valeurs. L'unité du peintre y est le coup de pinceau : un pinceau chargé traîné le long de la forme, large puis s'effilant, s'asséchant. Chaque lavis d'un grand vêtement est une session de coups de pinceau ("brush"), grands et pâles d'abord, secs, puis plus petits et plus foncés (les deux exemples).
- Champs. Par forme, deux lignes directrices dessinées dans la direction du pinceau : le long d'une manche, avec la chute du tissu, le long de la crête d'une épaule.
strokes_along(a, espacement, jusqu'à=b)pose les coups ; vous donnez des plages (load,length,angle,ends; largeur parspacingetlap) et unseed, jamais une seule valeur : des coups égaux sont un peigne. - La couleur locale : une session humide de larges coups chargés (
load1.3–2,lap0.8–1.3,"wet"14–18), rognée sur le vêtement, nommée. Regardez-la seule (look.py layers … only=NOM,look.py holes) : là où une fine bande de papier reste ouverte, un coup de pinceau de plus à la main. La demi-teinte : coups plus étroits de force inégale ("wet"7–12,"vary"0.2), rognés sur la première. Un virage lent : les coups de son champwithin=FORME,"soft"dans l'humide,"grade". - Les foncés (
winter.py,jacket()étape 5 ;dark-cloth.md4). D'abordlook.py tones: là où c'est foncé, là où ça reste clair. Les clairs sont aussi des formes : réservez-les grands ("lit"). Ensuite UNE session d'un pinceau chargé ("wet"1.5, alphaneed(FONCE, DEMI, 44): une couleur, pas d'étapes), dix à quinze coups : une largeur par nœud (un point, un gonflement de 60–90, un soulèvement), extrémités"cut", UN côté gardé, l'autre abandonné ("melt","drag"), une extrémité qui se dissout ; virages plus pâles par"press". - L'ourlet est les extrémités des coups. La zone du vêtement y est ouverte : les lignes directrices des champs FINISSENT sur la ligne d'ourlet,
hem(ligne, n, longueurs, angles)ajoute des coups larges. Une extrémité humide est un lobe, plus large que long (étroit et humide : une GOUTTE ;hem(reach=)) ; seuls les coups qui s'assèchent sont traînés, dans la propre couleur mélangée du foncé (un glacis seul est gris froid). - Un tricot (
cardigan.pyétape 4) : lavis et formes comme pour tout tissu, mais calme ("bristle"0.1, large"wet"). Puis UNE couche"knit"sur le vêtement,"out"des bandes et poignets :"pitch"et"stitch"mesurés à 4x, couleurlook.py glaze FOND RAINURE,"tones"sa lumière et sa demi-teinte ; une rainure est deux tiers de son fond à TOUTE valeur ("faint"0.5). - Les formes remplies restent justes pour le petit, le plat et l'exact : la face d'un revers, un col, une ombre portée avec deux bords durs, le renflement d'un poignet, les boutons, le lavis derrière. Ce qui va mal : rubans translucides (foncés nets sur foncés nets) ; un peigne à l'ourlet ; gouttes ; rayures fines (
laptrop petit, charges trop faibles) ; aérographe (tout"soft") ; nuages marbrés ("pool"sur un foncé) ; valeurs devenues foncées (les coups couvrent plus que les formes ne le faisaient). Foncés : saucisses, tessons, un voile gris, feuilles éparses, une palissade. Tricot : épines, velours côtelé, rayures, un chevron imprimé (winter-clothes.md).
Forme avant surface
Une forme nette avec une texture dessus reste plate : contours précis, lavis calmes et côtes donnent un ballon pour un bras. Décidez du volume avant toute peinture ; look.py shapes montre où la
…
[tronqué pour la traduction]