Paper brush (Pincel de papel recortado)
Un renderizador determinista para ilustraciones planas de papel recortado: cada imagen es una pila corta de formas de papel de colores, cada una cortada a lo largo de un trazado de pluma. Mismo archivo de dibujo, mismos píxeles de salida, por lo que un conjunto se mantiene coherente y cualquier forma se puede ajustar editando unos pocos números. Cualquier proporción, color de papel y tamaño.
Configuración del motor, una vez por proyecto: el renderizador se entrega como un bloque de código en references/engine.md. Cópialo con un comando, nunca volviéndolo a escribir: awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py, donde DIR es la carpeta de arte del proyecto (o una carpeta temporal); el mismo comando convierte references/example_drawings.md en un archivo de dibujos para empezar. Ejecútalo con python3 paper.py ... (necesita numpy y opencv-python). Los comandos a continuación asumen ese archivo. Si paper.py ya existe allí, reutilízalo.
El estilo (mantenlo)
Lee references/style.md antes de dibujar. En resumen: pocas formas grandes; pocos nodos con arcos largos; esquinas reales marcadas como esquinas; 2–3 tonos por material (base, sombra, a veces una luz); las sombras son formas limpias recortadas dentro de su padre, a menudo con un borde duro y otro difuminado; sin contornos alrededor de las formas; líneas solo donde habría una línea de pluma (cejas, pestañas, boca, un pliegue) y siempre afinadas; el rubor es la única borrosidad; papel blanco cálido y un grano fino y uniforme sobre todo.
Flujo de trabajo
- Configura un archivo de dibujos en el proyecto (por ejemplo,
Tools/art/drawings.py) que contengaDRAWINGS = {"nombre": {...}}. El formato está en el docstring depaper.py(python3 paper.pysin argumentos lo imprime). Comienza desde el archivo de dibujos enreferences/example_drawings.md. - Elige una cuadrícula de autor y, si tienes una, una imagen de referencia (un boceto, una pintura, una imagen aprobada) colocada sobre esa cuadrícula. Lee las coordenadas de los nodos a una escala conocida; una lambda pequeña como
h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p]convierte desde los píxeles de la referencia. - Delinea las formas a partir de una máscara si es útil: haz una máscara en blanco y negro de una región (umbral de color, máscara manual) y ejecuta
python3 paper.py nodes MASK.png [scale]— imprime nodos con esquinas ya encontradas. Luego adelgázalos y ordénalos a mano; el paso manual es lo que hace que se vea recortado, no trazado. - Renderiza:
python3 paper.py ruta/al/drawings.py OUT_DIR [nombre …]→OUT_DIR/<nombre>.png. - Observa, compara, ajusta. Pon el resultado junto a la referencia (o al conjunto aprobado) al tamaño en que se verá, por ejemplo
ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png, y ábrelo. Corrige una cosa a la vez: un nodo, un tono, un recorte. Espera varias iteraciones; confirma cuando el propietario lo apruebe. - Entrega al tamaño y formato del proyecto (reduce con Lanczos; JPEG q≈88 o PNG). Las imágenes no superan los 2K. Si el proyecto marca sus imágenes con marca de agua, sella después de la aprobación, antes de enviar.
Coincidir con un conjunto existente
Cuando las nuevas imágenes deben unirse a un conjunto que ya tiene un estilo (más avatares junto a los aprobados), el orden es primero las reglas, luego dibujar, luego iterar:
- Estudia las referencias y escribe las reglas. Acerca y mide: cómo se construyen los bordes, tonos por material, dónde se sitúan las formas de sombra y qué tan finas son, tamaños y posiciones de los rasgos en los ejes de la cabeza, cuánto del encuadre ocupa la cabeza, color del papel y grano.
- Calibra: redibuja una referencia con el pincel, ponla junto al original, ajusta hasta que coincidan.
- Extrae las partes que transmiten el estilo (ojos, cejas, interiores de oreja) de las referencias:
python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2imprime la forma plana debajo del píxel X,Y como nodos en los ejes de esa cabeza. Superpón para verificar; mueve la semilla si cae sobre piel. - Dibuja sobre la fuente:
python3 paper.py grid SOURCE.jpg grid.pngda una copia cuadriculada (líneas cada 20 px, etiquetas cada 100) para leer coordenadas. Pocos nodos por forma: una cara unas 16, una masa de cabello 20–40. - Prueba de mezcla antes de mostrar a nadie: intercala las nuevas imágenes con las referencias en una cuadrícula a tamaño miniatura (unos 480 px). Si se puede distinguir una nueva, no está lista. Luego verifica cada una a tamaño completo junto a su referencia más cercana.
Lo que no funciona: formas de la imaginación (todas las caras salen iguales); trazar una pintura realista por color (copia sus grumos); vectorizar automáticamente referencias (manchado); copiar posiciones de rasgos directamente de una cara realista (la boca queda demasiado baja y la cara se ve larga y vieja); formas de sombra tomadas de las áreas oscuras de una pintura (manchas).
Colocación típica de la cara en los ejes de la cabeza (mide tu propio conjunto): cejas aproximadamente y −0.8, paralelas a la línea del ojo; nariz un gancho corto en el lado lejano, x −0.3 a −0.65, y 0.45 a 1.15; boca aproximadamente 1.1 unidades de ancho en y 1.6 a 1.8, casi paralela a los ojos, ambos extremos a aproximadamente la misma altura (un extremo elevado se lee como sonrisa burlona); barbilla y 2.8 a 3.1. Dale a cada personaje su propia silueta de cabello, forma de ojo y ceja, y paleta, o el conjunto deriva hacia una sola cara. Para rizos apretados, trenzas y lana usa scallop(); para cuellos de punto ribs(); para lentes y botones oval() (from paper import scallop, ribs, oval).
Caras: partes reutilizables
Para un conjunto de caras que combinen, dale a cada dibujo "eyes": ((x, y), (x, y)). Esto define los ejes propios de la cabeza (x a lo largo de la línea del ojo, y hacia abajo de la cara, unidad = mitad de la distancia entre ojos), de modo que los rasgos se puedan escribir una vez y colocarse en cualquier cabeza:
{"head": True, "stroke": [...], "w": 0.12, "color": ...}— nodos en unidades de cabeza (ancho también).{"part": ("nombreconjunto", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4}— una parte de un archivoparts.pyubicado junto al archivo de dibujos:PARTS = {"nombreconjunto": {"eye_l": {"nodes": [...]}, ...}}, nodos en unidades de cabeza. Extrae partes una vez de imágenes aprobadas (traza la máscara de una parte connodes, convierte a unidades de cabeza), luego cada nueva cara las reutiliza, lo que mantiene el conjunto con la misma mano."mirror": Truegira una cara para mirar hacia el otro lado sin redibujarla.
Errores comunes
- Las formas se pintan en orden; un
"clip"solo ve formas ya pintadas bajo ese"name". - Varias capas con el mismo
"name"se suman (unión), útil para un cuerpo hecho de dos piezas. - Los puntos de
"fade"están en coordenadas de cuadrícula: fuerte en el primero, desaparecido en el segundo. "soft"está en unidades de cuadrícula; úsalo solo para rubor y brillos.- Los dibujos pueden
from paper import flow, scallop, ribs, oval: la carpeta del motor está en la ruta. - No dejes que un dibujo derive en muchas formas pequeñas o contornos; si un detalle necesita una línea, pregúntate si una segunda forma de tono lo expresaría mejor.