Skill de Colorização Plana Uniforme no Krita
Transforme lineart limpa e finalizada do Krita em uma ilustração editável e pronta para produção do Krita, organizada em camadas de cor plana uniforme de hex único semânticas, prontas para entrega imediata a um artista humano.
Esta skill é agnóstica de agente: a segmentação topológica, extração de polígonos de contorno e validação de uniformidade são desacopladas do transporte para o Krita dentro de scripts/krita_adapter.py.
Limites Rígidos do Escopo de Produção (Parar nas Cores Planas)
- Garantia Estrita de Apenas Cores Planas: Gera exatamente um único hex RGB alvo por camada folha (
alpha == 255,opacity = 1.0). - Operações Estritamente Proibidas (impostas por
configs/default_config.jsoneKritaAdapter):- NÃO sombreamento, sombras, oclusão ambiente, realces, luz de borda ou rubor subsuperficial.
- NÃO gradientes, aerografia suave, mesclagem pictórica (Atsunuri) ou brilhos especulares nos olhos.
- NÃO pilhas de camadas de iluminação global (
multiply,lighten,overlay,add,screen,soft_light,color_dodge). - NÃO recoloração de retenção de cor da lineart.
- Preservação da Lineart: Clona a lineart original para uma camada de backup bloqueada e oculta antes de adicionar grupos de cores. Quando silhuetas sólidas pretas de peças de vestuário/acessórios contêm cores internas planas, usa uma
transparencymaskreversível em vez de apagar ou redesenhar pixels da lineart.
Fluxo de Trabalho do Pipeline Principal
-
Ingestão da Lineart e Rotulagem de Componentes Conectados (
scripts/region_segmentation.py):- Limiariza a tinta (
gray < 200), fecha buracos de pino de 1 px (fechamento binário 3x3) e rotula regiões internas. - Identifica automaticamente a silhueta externa a partir de rótulos de fundo que tocam a borda (ou
exterior_bg_labelsdeclarativos em--spec).
- Limiariza a tinta (
-
Particionamento Semântico e Topológico (
scripts/region_segmentation.py):- Regiões de Material de Corredor de Tinta: Isola faixas/tiras escuras de vestuário/acessórios delimitadas por
ink & geometry & silhouette, opcionalmente erodindo2 pxpara produzir uma máscara de transparênciaFill_Windowreversível sobre interiores escuros. - Sobreposições Pré/Pós: Isola esclera, íris ou pequenas regiões de cap bounded.
- Competição Voronoi EDT: Resolve bolsões de sombra limítrofes entre materiais adjacentes (ex.: cabelo vs. pele, cabelo principal vs. trança traseira) via transformada de distância euclidiana.
- Trapping de Tinta de 1 px: Dilata preenchimentos
1 pxabaixo de contornos de tinta adjacentes para que bordas de traçado anti-aliasing não deixem halos brancos. - Fallback Genérico: Sem um
--specsemântico, rotula automaticamente componentes internos fechados>= 16 pxem camadasFlats/Region_NNisoladas e registra regiões menores/não mapeadas.
- Regiões de Material de Corredor de Tinta: Isola faixas/tiras escuras de vestuário/acessórios delimitadas por
-
Hierarquia Não Destrutiva e Varreduras de Pincel Contidas por Polígono (
scripts/layer_setup.py,scripts/polygon_selection.py,scripts/flat_fill_planner.py):- Constrói grupos de camadas independentes
blending_mode = "normal",inherit_alpha = falseabaixo deLineart/. - Converte máscaras em chamadas
select_polygondo Krita externas (replace/add) + furos (subtract) usando o deslocamento calibrado de+0,58 px(SUBPX = 0,58). - Pinta varreduras serpentinas sólidas de pressão total (
1.0), opacidade total (1.0) usando"b) Basic-5 Size"empacotadas em blocos de<= 60ediçõesedit_batch(abaixo do limite de64edições do Krita). - Define
alpha_locked = truenas camadas folha de cor plana após o preenchimento, para que artistas possam sombrear imediatamente dentro dos limites.
- Constrói grupos de camadas independentes
-
Validação e Relatório de Entrega ao Artista (
scripts/validate_flat_color.py):- Confirma uniformidade RGB de 100% de hex único em todos os pixels opacos exportados.
- Verifica derramamento externo zero fora da silhueta do personagem.
- Documenta quaisquer regiões anatômicas semiabertas ou ambíguas (ex.: unhas fracas não fechadas, bordas de unhas semiabertas) para revisão manual do artista, em vez de adivinhar.
Invocação Rápida via CLI
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart path/to/clean_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir work/flat_batches \
--diag-out work/flat_diag.png \
--audit-out work/flat_audit.json \
--setup-layers \
--mode dry_run
Execute diretamente contra um documento ativo do Krita 6.0.4:
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart path/to/clean_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir work/flat_batches \
--setup-layers \
--mode http_bridge
Guias de Referência e Configurações
references/architecture.md— Limites de escopo, separação de módulos e estrutura de camadas para entrega ao artista.references/region-segmentation.md— Isolamento de componentes conectados, empates Voronoi EDT, trapping de tinta e DSL declarativaregion_spec.json.references/flat-execution-and-layers.md— Subtração de furos de polígono, varreduras de+0,58 px, empacotamentoedit_batche janelamentotransparencymask.references/krita-interface.md— Limites da ponte nativa do Krita 6.0.4, validação de esquema e proteções de tempo de execução para não planos.references/validation.md— Verificações de uniformidade de hex único, contenção de derramamento e registro de bolsões não resolvidos.references/troubleshooting.md— Correção de vazamentos semiabertos, estouro de vértices de polígono e erros de ponte.configs/default_config.json&configs/layer_hierarchy_template.jsonexamples/workflow_example.md