CommunityImagemgithub.com

Pincel de aquarela

Pintar ilustrações de lápis e aguada como código determinístico: retratos, figuras, roupas e vinhetas, sem modelo de imagem.

O que é Pincel de aquarela?

Um pintor em código para lápis e aguada. Lavagens, passadas do pincel e bordas secas são geometria, então uma série sai da mesma mão.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Pincel de aquarela faz?

Duas coisas separadas: um sistema de pincel (papel, pigmento, água e pinceladas como código; determinístico) e um guia do pintor (como fazer uma imagem com ele). O sistema faz o que lhe é dito; uma boa imagem vem das decisões no guia, tomadas olhando. Não existe modo "apenas padrões": cada etapa automática é uma proposta que você pinta por cima. O motor são quatro blocos de código em references/engine/, os arquivos do guia estão em references/; cada comando é executado a partir da pasta do motor.

Configuração do motor, uma vez por projeto: o motor é fornecido como quatro arquivos Markdown em references/engine/ (wash.md, regions.md, look.md, selftest.md), cada um contendo um bloco de código. Copie os quatro blocos com um comando, nunca redigitando-os (cerca de 190 KB de código), por exemplo, para cada NOME: awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine/NOME.md > DIR/NOME.py, resultando em wash.py, regions.py, look.py e selftest.py em uma pasta do projeto (por exemplo, art/watercolour/; se já estiverem lá, reutilize-os). Eles são Python 3 puro (3.12 ou mais recente) e precisam de numpy e opencv-python-headless: instale-os conforme as próprias páginas dos pacotes dizem (numpy, opencv-python-headless; o motor foi testado com numpy 2.5.5 e opencv-python-headless 5.1.0.95). Em seguida, python3 selftest.py verifica a configuração. Para começar a partir de um exemplo, copie sua pasta de references/examples/NOME/ (source.png, areas.json, …) para a pasta do motor como examples/NOME/ e salve seu bloco de código (references/examples/NOME/NOME.md) como NOME.py dentro dessa cópia: o exemplo encontra seus dados ao lado de si mesmo (persimmon não tem dados: apenas seu bloco, como examples/persimmon/persimmon.py). Cada comando abaixo é executado a partir da pasta do motor, por exemplo, python3 wash.py examples/cardigan/cardigan.py examples/cardigan/out.

Parte 1: o sistema de pincel (references/engine/; a docstring de cada arquivo é seu manual, impresso quando executado sem argumentos)

  • wash.py — o motor. Uma imagem é uma folha de papel de prensa fria e uma lista de camadas. python3 wash.py DESENHOS.py DIR_SAIDA [nome …]; pintado em 2x e reduzido; qualquer tamanho até 2K.
    • Pintar: aguadas transparentes que multiplicam (claros são papel mantido seco com "out" ou removidos com "lift"); bordas duras com um rebordo, esticamentos úmidos (nós "w"), "soft", "bleed"; "grade", um gradiente úmido dentro de uma forma; pincel seco, traços "feather"; grafite. "brush": uma sessão úmida de pinceladas carregadas, a unidade de cada grande área: cada uma tão larga quanto é pressionada ("w"), quebrando onde sua "load" acaba; dentro da sessão elas se fundem ("wet"), seu limite externo é uma borda dura; as extremidades "cut" enviesadas, UM lado que "melt" ou "drag". "knit" e "cable": pontos e tranças, colocados após a forma, sua força lida a partir dos valores sob eles. Uma camada com um "name" é uma área à qual outras "clip" ou mantêm "out"; "eyes" e "head" fornecem unidades de cabeça.
    • Água (desligada a menos que solicitada; "Caráter da aquarela" diz onde e quanto): "miss", "ragged", "dry", "settle", "sediment", "broken", as camadas "bloom" e "sparkle", a própria "seed" de uma camada. A partir de um subdesenho ("under", "masks"): study (aguadas, grandes e pálidas a pequenas e escuras), hatch, trace.
    • Ajudantes (from wash import …; python3 wash.py helpers imprime cada argumento). Os valores de uma peça de roupa: ladder (suas velaturas a partir das cores da fonte), need (o alfa de um tom medido ao próximo), toned (a água de uma aguada no tom em que chega, pela mancha MEDIDA na fonte), step_to (ambos). Traços: strokes_along (um campo entre duas linhas-guia, ou uma forma que você desenhou, preenchida com traços que seguem a forma), hem (as extremidades desiguais onde uma peça de roupa para: lóbulos, nunca gotas). Marcas: runs, ribs, ring, arc, beside, scallop. nodes_of aproxima uma silhueta; nunca é para uma forma de sombra.
  • regions.py — etapas 1 e 2, segundos cada. propose FONTE DIR corta a fonte em regiões numeradas e adivinha areas.json; você a corrige (ids, pontos, polígonos; "approved": true); build cria máscaras, subdesenho, valores iniciais.
  • look.py — os olhos e instrumentos do pintor; nada nele pinta; tudo nas coordenadas de pixels da fonte. Ler a fonte: grid (ampliado, com coordenadas: cada nó é lido a partir dele, um a cada 40–50 px de uma borda longa; ainda assim 10–15 px de distância a olho), tones (linhas de tons), shapes (uma área em quatro valores; para olhar, não traçar), values (mais escuro 1 / 5 / 25 / 50 %, cor), speck (quanto papel as aguadas de uma peça de roupa mostram: sua água), ladder, glaze, over, frame. Verificar a si mesmo: paths (suas marcas sobre a fonte), layers (uma camada ou sessão SOZINHA, ou a folha até a camada N), holes (papel deixado aberto dentro de uma sessão), diff (renderização menos fonte, célula por célula, e por área a parcela de pontos dentro de 15 / 25: guia as rodadas de uma peça de roupa), texture, setin.
  • selftest.py — uma linha por promessa do motor; execute-o após alterar wash.py ou regions.py.

Como a tinta se comporta

  • Aguadas multiplicam. claro = papel × (cor / papel) ^ alfa, por canal: a cor de uma aguada é o que ela dá no papel puro; sobre tinta é um multiplicador, e a mesma aguada duas vezes dá cor². Portanto, uma peça de roupa é uma cor local e uma escada de velaturas que é própria desta peça: SAGE, TURN, SHADE, DEEP, DARK, RIB = ladder(luz, sombra, escuro, on=papel_fonte), a partir de três cores lidas na fonte (uma escada copiada carrega o matiz da outra peça). Quão forte uma velatura vai é aritmético, não a olho: need(SHADE, 114, 66) é o alfa que leva o tom 114 a 66.
  • Nada claro vai sobre algo escuro. Um botão, um encaixe, um brilho numa aguada escura sai preto a menos que seja reservado ou levantado (worked-example.md, winter-clothes.md 3). Portanto, o mais escuro de duas peças de roupa é pintado em segundo lugar, qualquer que esteja em cima na vida, numa ÚNICA lista compartilhada de nós. A mais clara corre DEBAIXO dela apenas se estiver perto do papel ou a superior for um escuro, nunca quente sob frio no meio-tom (creme sob cinza-azulado: lama): look.py over DEBAIXO CIMA.
  • Escuro é densidade, e a água é medida. "grain", "pool", "settle", "sediment" são parcelas do pigmento e aparecem mais à medida que o valor cai. look.py speck FONTE mask=… lê o que ESSE tecido mostra (um casaco liso 3–4 %, uma jaqueta acolchoada 6–10 %); toned(TIPO, tom, PAPEL, speck=…) dá a cada aguada isso (dark-cloth.md 1, winter-clothes.md 0).
  • Bordas. Bordas duras têm um rebordo. Um nó "w" suaviza uma faixa de cerca de 3 × "wet" de largura. "clip" / "out" cortam duro e não deixam rebordo: diga essa borda com uma sombra central ou o lápis. Formas que compartilham uma borda compartilham "wobble".
  • Tamanho e acaso. Caminhos, larguras e "wet" são unidades de grade; as marcas do pincel e o papel são dimensionados em relação à imagem ("fine", "weave"; starting-values.md). O acaso de uma camada é seu próprio: sua "seed" joga novamente.

Parte 2: o guia do pintor

Leia style.md primeiro (o visual, medido). Comece uma imagem a partir de um dos dois exemplos trabalhados, cada um um arquivo e um comando (configurado como em "Configuração do motor"): examples/cardigan/cardigan.py (uma NOVA imagem a partir de um esboço pálido: cabeça e rosto, cabelo grisalho, um cardigan de tranças sobre uma camisa clara, papel liso atrás) ou examples/winter/winter.py (uma imagem finalizada pintada NOVAMENTE: uma criança, cabelo escuro comprido, uma jaqueta escura acolchoada, um cachecol, um suéter de tranças, sua própria aguada atrás). worked-example.md percorre ambos; dark-cloth.md e winter-clothes.md contêm as regras das peças de roupa.

O que pode e não pode fazer

Ele repinta superfície, não maneira: papel, profundidade, bordas de aguada, lápis. Identidade, proporções e a maneira como um rosto é desenhado vêm da fonte; um desenho animado continua sendo um desenho animado. O guia é escrito para pessoas; coisas pequenas recebem as mesmas marcas (references/examples/persimmon/persimmon.md). Ele não pode inventar um rosto: comece a partir de um desenho desta mesma pessoa que já tenha o encanto; se não for "que pessoa adorável" à primeira vista, pare. Uma imagem feita por código é contada em 1:1 primeiro pelas suas GRANDES PEÇAS DE ROUPA, depois pelo fundo e cabelo: é aí que vão o olhar e o trabalho manual.

A ordem do trabalho

  1. Estudar, depois decidir. Coloque a fonte em 1:1 ao lado das imagens com as quais a sua deve se sentar (o conjunto ao qual se junta; sem conjunto, style.md) e escreva, antes de pintar: quais linhas este visual não desenharia (uma rede de rugas, um contorno fechado, tinta), o que está atrás da figura, o que deve ser lido como feito (molduras, botões, um zíper). Uma fonte que já é uma imagem finalizada neste visual, para ser pintada novamente: "approved": true em areas.json, a folha no papel da fonte, seu fundo mantido; look.py frame encontra o quadro de um retrato que foi cortado dela.
  2. Áreas. regions.py propose, leia regions.png, corrija areas.json, build, leia areas.png em 1:1. Corte pelo lugar primeiro ("within", polígonos), depois pela cor; algumas rodadas de segundos, peças de roupa desenhadas à mão como polígonos.
  3. Correções do subdesenho, feitas por build: valores mais completos por área conforme o que a fonte mede ali (starting-values.md); linhas finas escuras na pele fechadas, uma terceira misturada de volta; características como desenhadas.
  4. Grandes aguadas, pálidas, pintadas ao redor dos claros, em traços (a próxima seção). Roupas à mão, primeiro; cabeça, pescoço e mãos através do subdesenho. Antes da primeira pintura: look.py speck (a água de cada peça de roupa), tones (onde está escuro), paths (seus contornos sobre a fonte). Os tons são medidos e escalonados (need), não adivinhados.
  5. Sombras: cada uma é sua decisão. Dez a vinte por peça de roupa: onde começa, incha e termina, qual borda é dura, seus nós lidos a partir de look.py grid; depois colocadas como traços. Nunca um limiar da fonte traçado em caminhos (nodes_of, uma máscara): lama mosqueada, nuvens de aerógrafo, ilhas de mapa de contorno, e mais lento do que vinte decisões.
  6. Escuros: comprometidos tarde, e uma vez. Profundezas do cabelo, sob gola e queixo, núcleos de dobras, pupilas, a linha dos cílios superiores; nunca escurecendo a pele. Numa peça de roupa: após o meio-tom ter secado, poucos, grandes e UNIDOS, cada traço carregado direto ao seu tom ("Os escuros", abaixo); em etapas, um escuro se torna uma nuvem suave.
  7. Textura após a forma (um tricô, tranças): uma camada sobre os valores finalizados; uma forma que não se lê sem ela volta à etapa 4. 7. Características: uma passagem exata, depois à mão, fina e pálida. 8. Lápis por último, e pouco: onde uma forma se sobrepõe a outra. 9. Levantamentos para os poucos claros perdidos. Pare quando um traço explicaria o claro.

Grandes áreas são pintadas em traços

Uma peça de roupa construída de formas preenchidas é um mosaico de lentes planas, por mais corretos que sejam seus valores. A unidade do pintor ali é o traço: um pincel carregado arrastado ao longo da forma, largo depois estreitando, secando. Cada aguada de uma grande peça de roupa é uma sessão de traços ("brush"), grandes e pálidos primeiro, secos, depois menores e mais escuros (ambos os exemplos).

  • Campos. Por forma, duas linhas-guia desenhadas do jeito que o pincel vai: descendo uma manga, com a queda do pano, ao longo da crista de um ombro. strokes_along(a, espaçamento, to=b) coloca os traços; você dá intervalos (load, length, angle, ends; largura por espaçamento e lap) e uma seed, nunca um valor: traços iguais são um pente.
  • A cor local: uma sessão úmida de traços largos carregados (load 1.3–2, lap 0.8–1.3, "wet" 14–18), recortada à peça de roupa, nomeada. Olhe para ela sozinha (look.py layers … only=NOME, look.py holes): onde uma lasca de papel fica aberta, mais um traço à mão. O meio-tom: traços mais estreitos de força desigual ("wet" 7–12, "vary" 0.2), recortados ao primeiro. Uma curva lenta: os traços de seu campo within=FORMA, "soft" no úmido, com "grade".
  • Os escuros (winter.py, jacket() passo 5; dark-cloth.md 4). Primeiro look.py tones: onde está escuro, onde fica claro. Claros também são formas: reserve-os grandes ("lit"). Depois UMA sessão de um pincel carregado ("wet" 1.5, alfa need(ESCURO, MEIO, 44): uma cor, sem etapas), dez a quinze traços: uma largura por nó (um ponto, um inchaço de 60–90, um levantamento), extremidades "cut", UM lado mantido, o outro dado ("melt", "drag"), uma extremidade que dissolve; curvas mais claras por "press".
  • A barra é o fim dos traços. A área da peça de roupa é aberta ali: as linhas-guia dos campos TERMINAM na linha da barra, hem(linha, n, comprimentos, ângulos) adiciona traços largos. Uma extremidade molhada é um lóbulo, mais largo que comprido (estreito e molhado: uma GOTA; hem(reach=)); apenas traços que secam são arrastados, na própria cor mista do escuro (uma velatura sozinha é cinza frio).
  • Um tricô (cardigan.py passo 4): aguadas e formas como para qualquer pano, mas calmo ("bristle" 0.1, "wet" largo). Depois UMA camada "knit" sobre a peça de roupa, "out" de faixas e punhos: "pitch" e "stitch" medidos em 4x, cor look.py glaze FUNDO SULCO, "tones" seu claro e meio-tom; um sulco é dois terços de seu fundo em TODO valor ("faint" 0.5).
  • Formas preenchidas permanecem certas para o pequeno, o plano e o exato: a face de uma lapela, uma gola, uma sombra projetada com duas bordas duras, o bojo de um punho, botões, a aguada atrás. O que dá errado: fitas translúcidas (escuros nítidos sobre escuros nítidos); um pente na barra; gotas; listras finas (lap muito pequeno, cargas muito baixas); aerógrafo (tudo "soft"); nuvens mosqueadas ("pool" num escuro); valores escurecidos (traços cobrem mais do que formas faziam). Escuros: salsichas, cacos, um véu cinza, folhas soltas, uma cerca de piquete. Tricô: espinhos, sarja, arranhões, uma espinha de peixe impressa (winter-clothes.md).

Forma antes da superfície

Uma forma limpa com textura ainda é plana: contornos exatos, aguadas calmas e nervuras dão um balão para um braço. Decida o volume antes de qualquer pintura; look.py shapes mostra onde o…

… [truncado para tradução]

Habilidades Relacionadas