CommunityImagemgithub.com

krita-flat-colouring

Segmenta lineart limpa do Krita em regiões de material semântico com cores planas uniformes, usando topologia de componentes conectados, atribuição Voronoi EDT, seleções de contorno poligonal, pincéis com deslocamento de +0,58 px do Krita 6.0.4 e hierarquias de camadas não destrutivas com bloqueio alfa. Termina estritamente em cores base planas uniformes, sem sombreamento, iluminação, gradientes ou renderização autônoma.

O que é krita-flat-colouring?

Esta skill transforma lineart limpa e finalizada do Krita em uma ilustração editável e pronta para produção, organizada em camadas de cores planas semânticas e uniformes (hex único) para entrega imediata a um artista humano. Ela é agnóstica de agente, separando a segmentação topológica, extração de polígonos de contorno e validação de uniformidade do transporte para o Krita através do adaptador em `scripts/krita_adapter.py`. O pipeline inclui rotulagem de componentes conectados, partição semântica com competição Voronoi EDT, trapping de tinta de 1 px para evitar halos brancos, e preenchimento com pinceladas serpentinas em lotes de até 60 edições para respeitar o limite de 64 edições do Krita 6.0.4. A skill garante 100% de uniformidade RGB por camada folha, sem derramamento externo, e documenta regiões ambíguas para revisão manual do artista, terminando estritamente em cores base planas sem sombreamento, iluminação ou gradientes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ashdawgthegoat/krita-illustration-skills/tree/HEAD/skills/krita-flat-colouring

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

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.json e KritaAdapter):
    • 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 transparencymask reversível em vez de apagar ou redesenhar pixels da lineart.

Fluxo de Trabalho do Pipeline Principal

  1. 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_labels declarativos em --spec).
  2. 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 erodindo 2 px para produzir uma máscara de transparência Fill_Window reversí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 px abaixo de contornos de tinta adjacentes para que bordas de traçado anti-aliasing não deixem halos brancos.
    • Fallback Genérico: Sem um --spec semântico, rotula automaticamente componentes internos fechados >= 16 px em camadas Flats/Region_NN isoladas e registra regiões menores/não mapeadas.
  3. 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 = false abaixo de Lineart/.
    • Converte máscaras em chamadas select_polygon do 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 <= 60 edições edit_batch (abaixo do limite de 64 edições do Krita).
    • Define alpha_locked = true nas camadas folha de cor plana após o preenchimento, para que artistas possam sombrear imediatamente dentro dos limites.
  4. 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

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas