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 helpersimprime 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_ofaproxima uma silhueta; nunca é para uma forma de sombra.
- Pintar: aguadas transparentes que multiplicam (claros são papel mantido seco com
regions.py— etapas 1 e 2, segundos cada.propose FONTE DIRcorta a fonte em regiões numeradas e adivinhaareas.json; você a corrige (ids, pontos, polígonos;"approved": true);buildcria 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 alterarwash.pyouregions.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.md3). 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.md1,winter-clothes.md0). - 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
- 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": trueemareas.json, a folha no papel da fonte, seu fundo mantido;look.py frameencontra o quadro de um retrato que foi cortado dela. - Áreas.
regions.py propose, leiaregions.png, corrijaareas.json,build, leiaareas.pngem 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. - 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. - 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. - 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. - 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.
- 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 porespaçamentoelap) e umaseed, nunca um valor: traços iguais são um pente. - A cor local: uma sessão úmida de traços largos carregados (
load1.3–2,lap0.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 campowithin=FORMA,"soft"no úmido, com"grade". - Os escuros (
winter.py,jacket()passo 5;dark-cloth.md4). Primeirolook.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, alfaneed(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.pypasso 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, corlook.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 (
lapmuito 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]