¿Qué hace Pincel de acuarela?
Dos cosas, separadas: un sistema de pincel (papel, pigmento, agua y trazos como código; determinista) y una guía del pintor (cómo hacer un cuadro con él). El sistema hace lo que se le dice; un buen cuadro surge de las decisiones en la guía, tomadas al mirar. Sin modo "solo valores predeterminados": cada paso automático es una propuesta que pintas encima. El motor son cuatro bloques de código en references/engine/, los archivos de la guía están en references/; cada comando se ejecuta desde la carpeta del motor.
Configuración del motor, una vez por proyecto: el motor se entrega como cuatro archivos Markdown en references/engine/ (wash.md, regions.md, look.md, selftest.md), cada uno con un bloque de código. Copia los cuatro bloques con un comando, nunca volviéndolos a escribir (unos 190 KB de código), por ejemplo para cada NOMBRE:
awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine/NOMBRE.md > DIR/NOMBRE.py, obteniendo wash.py, regions.py, look.py y selftest.py en una carpeta del proyecto (por ejemplo art/watercolour/; si ya están, reutilízalos). Son Python 3 plano (3.12 o más reciente) y necesitan numpy y opencv-python-headless: instálalos como indican las páginas de los paquetes (numpy, opencv-python-headless; el motor fue probado con numpy 2.5.5 y opencv-python-headless 5.1.0.95). Luego python3 selftest.py comprueba la configuración. Para empezar desde un ejemplo, copia su carpeta de references/examples/NOMBRE/ (source.png, areas.json, …) a la carpeta del motor como examples/NOMBRE/ y guarda su bloque de código (references/examples/NOMBRE/NOMBRE.md) como NOMBRE.py dentro de esa copia: el ejemplo encuentra sus datos junto a sí mismo (persimmon no tiene datos: solo su bloque, como examples/persimmon/persimmon.py). Cada comando a continuación se ejecuta desde la carpeta del motor, por ejemplo python3 wash.py examples/cardigan/cardigan.py examples/cardigan/out.
Parte 1: el sistema de pincel (references/engine/; la cadena de documentación de cada archivo es su manual, se imprime al ejecutarse sin argumentos)
wash.py— el motor. Un cuadro es una hoja de papel de prensado en frío y una lista de capas.python3 wash.py DIBUJOS.py DIR_SALIDA [nombre …]; pintado al 2x y reducido; cualquier tamaño a 2K.- Pintar: lavados transparentes que se multiplican (las luces son papel que se mantiene seco con
"out"o se levanta con"lift"); bordes duros con un ribete, estiramientos húmedos (nodos"w"),"soft","bleed";"grade", un degradado húmedo dentro de una forma; pincel seco, trazos"feather"; grafito."brush": una sesión húmeda de trazos de pincel cargados, la unidad de cada área grande: cada uno tan ancho como se presiona ("w"), rompiéndose donde se agota su"load"; dentro de la sesión se funden entre sí ("wet"), su límite exterior es un borde duro; termina con"cut"oblicuo, UN lado que"melt"o"drag"."knit"y"cable": puntadas y trenzas, colocadas después de la forma, su fuerza se lee de los valores debajo de ellas. Una capa con un"name"es un área a la que otras se"clip"o mantienen"out";"eyes"y"head"dan unidades de cabeza. - Agua (desactivada a menos que se solicite; "Carácter de la acuarela" dice dónde y cuánta):
"miss","ragged","dry","settle","sediment","broken", las capas"bloom"y"sparkle", la propia"seed"de una capa. Desde un subdibujo ("under","masks"):study(lavados, grandes y pálidos a pequeños y oscuros),hatch,trace. - Ayudantes (
from wash import …;python3 wash.py helpersimprime cada argumento). Los valores de una prenda:ladder(sus veladuras a partir de los colores de la fuente),need(el alfa de un tono medido al siguiente),toned(el agua de un lavado al tono al que llega, según la mota MEDIDA en la fuente),step_to(ambos). Trazos:strokes_along(un campo entre dos líneas guía, o una forma dibujada, lleno de trazos que siguen la forma),hem(los extremos desiguales de los trazos donde se detiene una prenda: lóbulos, nunca gotas). Marcas:runs,ribs,ring,arc,beside,scallop.nodes_ofdesbasta una silueta; nunca es para una forma de sombra.
- Pintar: lavados transparentes que se multiplican (las luces son papel que se mantiene seco con
regions.py— pasos 1 y 2, segundos cada uno.propose FUENTE DIRcorta la fuente en regiones numeradas y adivinaareas.json; lo corriges (ids, puntos, polígonos;"approved": true);buildhace máscaras, subdibujo, valores iniciales.look.py— los ojos e instrumentos del pintor; nada en él pinta; todo en las coordenadas de píxeles de la fuente. Leer la fuente:grid(ampliado, con coordenadas: cada nodo se lee de él, uno cada 40–50 px de un borde largo; a ojo aún a 10–15 px),tones(filas de tonos),shapes(un área en cuatro valores; para mirar, no para calcar),values(más oscuro 1 / 5 / 25 / 50 %, color),speck(cuánto papel muestran los lavados de una prenda: su agua),ladder,glaze,over,frame. Comprobarte a ti mismo:paths(tus marcas sobre la fuente),layers(una capa o sesión SOLA, o la hoja hasta la capa N),holes(papel abierto dentro de una sesión),diff(renderizado menos fuente, celda por celda, y por área la proporción de puntos dentro de 15 / 25: dirige las rondas de una prenda),texture,setin.selftest.py— una línea por promesa del motor; ejecútalo después de cambiarwash.pyoregions.py.
Cómo se comporta la pintura
- Los lavados se multiplican.
luz = papel × (color / papel) ^ alfa, por canal: el color de un lavado es lo que da sobre papel desnudo; sobre pintura es un multiplicador, y el mismo lavado dos veces dacolor². Así que una prenda es un color local y una escalera de veladuras que es propia de esta prenda:SAGE, TURN, SHADE, DEEP, DARK, RIB = ladder(lit, shadow, dark, on=papel_fuente), a partir de tres colores leídos de la fuente (una escalera copiada lleva el tono de la otra prenda). La intensidad de una veladura es aritmética, no visual:need(SHADE, 114, 66)es el alfa que lleva el tono 114 a 66. - Nada claro va sobre algo oscuro. Un botón, un broche, un brillo sobre un lavado oscuro sale negro a menos que se reserve o levante (
worked-example.md,winter-clothes.md3). Así que la más oscura de dos prendas se pinta segunda, independientemente de cuál esté encima en la vida real, en UNA lista compartida de nodos. La más clara corre DEBAJO de ella solo si está cerca del papel o la superior es un oscuro, nunca cálido bajo frío a medio tono (crema bajo gris azulado: barro):look.py over INFERIOR SUPERIOR. - Oscuro es densidad, y el agua se mide.
"grain","pool","settle","sediment"son proporciones del pigmento y se muestran más a medida que el valor disminuye.look.py speck SRC mask=…lee lo que MUESTRA esta tela (un abrigo liso 3–4 %, una chaqueta acolchada 6–10 %);toned(TIPO, tono, PAPEL, speck=…)da cada lavado eso (dark-cloth.md1,winter-clothes.md0). - Bordes. Los bordes duros tienen un ribete. Un nodo
"w"suaviza una banda de aproximadamente 3 ×"wet"de ancho."clip"/"out"cortan duro y no dejan ribete: di ese borde con una sombra de núcleo o el lápiz. Las formas que comparten un borde comparten"wobble". - Tamaño y azar. Los caminos, anchos y
"wet"son unidades de cuadrícula; las marcas del pincel y el papel se dimensionan según el cuadro ("fine","weave";starting-values.md). La probabilidad de una capa es propia: su"seed"vuelve a lanzar.
Parte 2: la guía del pintor
Lee style.md primero (el aspecto, medido). Empieza un cuadro desde uno de los dos ejemplos trabajados, cada uno un archivo y un comando (configurado como en "Configuración del motor"): examples/cardigan/cardigan.py (un NUEVO cuadro a partir de un boceto pálido: cabeza y rostro, cabello gris, un cárdigan de punto sobre una camisa clara, papel liso detrás) o examples/winter/winter.py (un cuadro terminado pintado DE NUEVO: un niño, cabello largo y oscuro, una chaqueta oscura acolchada, una bufanda, un suéter de punto, su propio lavado detrás). worked-example.md recorre ambos; dark-cloth.md y winter-clothes.md contienen las reglas de las prendas.
Qué puede y qué no puede hacer
Vuelve a pintar superficie, no manera: papel, profundidad, bordes de lavado, lápiz. La identidad, las proporciones y la forma en que se dibuja un rostro provienen de la fuente; una caricatura sigue siendo una caricatura. La guía está escrita para personas; las cosas pequeñas llevan las mismas marcas (references/examples/persimmon/persimmon.md). No puede inventar un rostro: empieza con un dibujo de esta misma persona que ya tenga el encanto; si no es "qué persona tan encantadora" a primera vista, detente. Un cuadro hecho con código se cuenta a 1:1 primero por sus GRANDES PRENDAS, luego por el suelo y el cabello: ahí es donde van la mirada y el trabajo manual.
El orden de trabajo
- Estudia, luego decide. Pon la fuente a 1:1 junto a las imágenes con las que deben sentarse las tuyas (el conjunto al que se une; sin conjunto,
style.md) y escribe, antes de pintar: qué líneas este aspecto no dibujaría (una red de arrugas, un contorno cerrado, tinta), qué hay detrás de la figura, qué debe leerse como hecho (marcos, botones, una cremallera). Una fuente que ya es un cuadro terminado en este aspecto, para ser pintada de nuevo:"approved": trueenareas.json, la hoja sobre el papel de la fuente, su suelo mantenido;look.py frameencuentra el marco de un retrato que se recortó de él. - Áreas.
regions.py propose, leeregions.png, corrigeareas.json,build, leeareas.pnga 1:1. Corta primero por lugar ("within", polígonos), luego por color; unas pocas rondas de segundos, prendas dibujadas a mano como polígonos. - Correcciones del subdibujo, hechas por
build: valores más completos por área según lo que la fuente mide allí (starting-values.md); líneas oscuras finas sobre la piel cerradas, un tercio mezclado de vuelta; rasgos como se dibujaron. - Grandes lavados, pálidos, pintados alrededor de las luces, en trazos (la siguiente sección). Ropa a mano, primero; cabeza, cuello y manos a través del subdibujo. Antes de la primera pintura:
look.py speck(el agua de cada prenda),tones(dónde está oscura),paths(tus contornos sobre la fuente). Los tonos se miden y escalonan (need), no se adivinan. - Sombras: cada una es tu decisión. De diez a veinte por prenda: dónde empieza, se hincha y termina, qué borde es duro, sus nodos leídos de
look.py grid; luego colocadas como trazos. Nunca un umbral de la fuente calcado en caminos (nodes_of, una máscara): barro moteado, nubes de aerógrafo, islas de mapa de contorno, y más lento que veinte decisiones. - Oscuros: comprometidos tarde, y una sola vez. Profundidades del cabello, debajo del cuello y la barbilla, núcleos de pliegues, pupilas, la línea de pestañas superior; nunca oscureciendo la piel. En una prenda: después de que el medio tono se haya secado, pocos, grandes y UNIDOS, cada trazo cargado directamente a su tono ("Los oscuros", abajo); en pasos, un oscuro se convierte en una nube suave.
- Textura después de la forma (un punto, cables): una capa sobre los valores terminados; una forma que no se lee sin ella vuelve al paso 4. 7. Rasgos: una pasada exacta, luego a mano, fina y pálida. 8. Lápiz al final, y poco: donde una forma superpone a otra. 9. Levantados para las pocas luces perdidas. Detente cuando un trazo explicaría lo claro.
Las áreas grandes se pintan en trazos
Una prenda construida con formas rellenas es un mosaico de lentes planas, por muy correctos que sean sus valores. La unidad del pintor allí es el trazo: un pincel cargado arrastrado a lo largo de la forma, ancho y luego estrechándose, secándose. Cada lavado de una prenda grande es una sesión de trazos ("brush"), grandes y pálidos primero, secos, luego más pequeños y oscuros (ambos ejemplos).
- Campos. Por forma, dos líneas guía dibujadas como va el pincel: hacia abajo de una manga, con la caída de la tela, a lo largo de la cresta de un hombro.
strokes_along(a, spacing, to=b)coloca los trazos; das rangos (load,length,angle,ends; ancho porspacingylap) y unaseed, nunca un valor: trazos iguales son un peine. - El color local: una sesión húmeda de trazos anchos cargados (
load1.3–2,lap0.8–1.3,"wet"14–18), recortada a la prenda, nombrada. Mírala sola (look.py layers … only=NOMBRE,look.py holes): donde queda abierta una tira de papel, un trazo más a mano. El medio tono: trazos más estrechos de fuerza desigual ("wet"7–12,"vary"0.2), recortados al primero. Un giro lento: los trazos de su campowithin=FORMA,"soft"en lo húmedo, con"grade". - Los oscuros (
winter.py,jacket()paso 5;dark-cloth.md4). Primerolook.py tones: dónde está oscuro, dónde permanece claro. Las luces también son formas: resérvalas grandes ("lit"). Luego UNA sesión de un pincel cargado ("wet"1.5, alfaneed(DARK, HALF, 44): un color, sin pasos), de diez a quince trazos: un ancho por nodo (un punto, un ensanchamiento de 60–90, un levantamiento), extremos"cut", UN lado mantenido, el otro cedido ("melt","drag"), un extremo que se disuelve; giros más pálidos por"press". - El dobladillo son los extremos de los trazos. El área de la prenda está abierta allí: las líneas guía de los campos TERMINAN en la línea del dobladillo,
hem(line, n, lengths, angles)añade trazos anchos. Un extremo húmedo es un lóbulo, más ancho que largo (estrecho y húmedo: una GOTA;hem(reach=)); solo los trazos que se secan se arrastran, en el color mezclado propio del oscuro (una veladura sola es gris frío). - Un punto (
cardigan.pypaso 4): lavados y formas como para cualquier tela, pero tranquilo ("bristle"0.1,"wet"ancho). Luego UNA capa"knit"sobre la prenda,"out"de bandas y puños:"pitch"y"stitch"medidos al 4x, colorlook.py glaze GROUND GROOVE,"tones"su luz y medio tono; un surco es dos tercios de su fondo en CADA valor ("faint"0.5). - Las formas rellenas se mantienen correctas para lo pequeño, lo plano y lo exacto: la cara de una solapa, un cuello, una sombra proyectada con dos bordes duros, el bulto de un puño, botones, el lavado detrás. Lo que sale mal: cintas translúcidas (oscuros nítidos sobre oscuros nítidos); un peine en el dobladillo; gotas; rayas finas (
lapdemasiado pequeño, cargas demasiado bajas); aerógrafo (todo"soft"); nubes moteadas ("pool"sobre un oscuro); valores oscurecidos (los trazos cubren más de lo que lo hicieron las formas). Oscuros: salchichas, fragmentos, un velo gris, hojas sueltas, una valla de estacas. Punto: espinas, pana, rayones, una espina de pescado impresa (winter-clothes.md).
Forma antes que superficie
Una forma limpia con textura sigue siendo plana: contornos exactos, lavados tranquilos y costillas dan un globo por un brazo. Decide el volumen antes de cualquier pintura; look.py shapes muestra dónde ...
… [truncado para la traducción]