CommunityImagemgithub.com

krita-lineart-reconstruction

Reconstruir lineart limpo e nativo do Krita em resolução nativa 1x usando ajuste de Bézier cúbico G1, subdivisão recursiva de Bézier cúbico baseada em fila de prioridade, calibração de pressão de pincel de regime duplo do Krita 6.0.4, calibração de coordenadas de +0,58 px e feedback visual em malha fechada. Escopo restrito apenas a lineart (sem supersampling, sem coloração plana, sem sombreamento ou renderização autônoma).

O que é krita-lineart-reconstruction?

Esta skill reconstroi lineart limpo e nativo do Krita a partir de uma ilustração raster de referência, operando exclusivamente em resolução nativa 1x. Ela usa uma pipeline robusta que inclui extração de tinta, ajuste de curvas Bézier cúbicas G1 com validação de densidade de vértices adaptativa, e calibração de pincel e coordenadas específicas para o Krita 6.0.4. A skill é agnóstica a agentes, isolando a síntese matemática e o rastreamento topológico da execução via Krita RPC/MCP/CLI. O resultado é uma camada de pintura 'Lineart' com tinta preta nítida, pronta para coloração plana, sem qualquer supersampling ou sombreamento. A validação incluída verifica a fidelidade visual usando métricas como SSIM, PSNR e F1 de contorno, garantindo que o lineart reconstruído corresponda ao original.

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

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

Habilidade de Reconstrução de Lineart no Krita

Empacotar e executar uma pipeline validada e pronta para produção de reconstrução de lineart nativo 1x do Krita a partir de uma ilustração raster de referência.

Esta habilidade é agnóstica a agentes: a síntese matemática de trajetória, o rastreamento do esqueleto topológico, a calibração e a validação são estritamente isolados da execução do Krita RPC/MCP/CLI por meio do scripts/krita_adapter.py.

Limites Rigorosos do Escopo de Produção

  • Resolução nativa 1x apenas: Não habilite supersampling 2x ou escalonamento combinado 2x + adaptive. Tanto adaptive_subdivision.py quanto stroke_planner.py rejeitam resolution_scale != 1 / supersample_factor != 1.
  • Apenas lineart: Gera tinta #000000 nítida em uma camada de pintura dedicada Lineart (RGBA U8, 300 dpi, sRGB-elle-V2-srgbtrc.icc). Não realiza coloração plana, sombreamento, gradientes, oclusão ambiente, pilhas de iluminação ou renderização.
  • Apenas pincéis nativos do Krita: Sintetiza traços exclusivamente por meio de predefinições de pincel calibradas (d) Ink-3 Gpen e b) Basic-5 Size para preenchimentos gráficos amplos) em vez de importar sobreposições rasterizadas.

Fluxo de Trabalho Principal da Pipeline

  1. Análise da Referência e Extração de Tinta (scripts/ink_analysis.py):

    • A limiarização em dois níveis captura tinta escura sólida (inv > 42.0) e cristas delicadas de baixo contraste (local_dark > 14.0 & inv > 18.0 relativo a Gaussiana sigma = 4.0), além de substituições opcionais de bounding box fina (region_overrides) para lacunas densas e apertadas, como anéis concêntricos da íris.
    • Detecta núcleos gráficos pretos ousados via Transformada de Distância Euclidiana (edt >= 2.8 px, área >= 20 px) e extrai contornos de varredura de isodistância (1.35 .. 16.20 px).
    • Esqueletiza a tinta restante, poda curvas de quantização curtas (<= 4 iterações), emenda trajetórias colineares em junções de grau >= 3 (cos <= -0.68), refina linhas centrais para precisão subpixel (refine_ridge_subpixel) e divide em cantos agudos (> 72 deg) ou extensão máxima de 540 px.
  2. Ajuste de Spline e Densidade de Vértices Adaptativa Validada (scripts/bezier_core.py, scripts/adaptive_subdivision.py):

    • Ajusta segmentos Bézier cúbicos contínuos G1 com alças tangentes de mínimos quadrados ótimos.
    • Refina a amostragem de cordas com Subdivisão Recursiva de Bézier Cúbico Baseada em Fila de Prioridade (validada no Experimento 2 em 1x), limitando vértices por traço ao limite rígido de 128 pontos do Krita, mantendo tolerâncias restritas na flecha de corda, deflexão do ângulo tangente, produto curvatura-arco, fidelidade de taper de pressão e comprimento de corda reta.
  3. Calibração de Pincel e Coordenadas do Krita 6.0.4 (scripts/pressure_calibration.py, scripts/stroke_planner.py):

    • Integra a largura da linha óptica ao longo das normais locais com parada em vale (max_half = 4.8 px) para evitar inchaço de fios vizinhos.
    • Seleciona curvas de pressão empíricas de regime duplo d) Ink-3 Gpen (GPEN_THIN quando brush_size <= 4.5 px; GPEN_STD quando brush_size > 4.5 px) ou tabelas b) Basic-5 Size definidas em configs/pressure_tables_krita604.json.
    • Desloca amostras de vértices e pontos de controle Bézier em +0.58 px (PIXEL_CENTER_SHIFT) para alinhar dabbs de traço com centros de pixel do Krita e ordena traços nos Estágios 1–6 (núcleos gráficos -> silhuetas externas -> zonas focais -> estrutura interna -> fios finos).
  4. Execução e Feedback Visual em Malha Fechada (scripts/reconstruct_lineart.py, scripts/refinement.py):

    • Execute via KritaAdapter em dry_run (exportação de lote JSON portátil), http_bridge (POST /rpc) ou krita_mcp_cli (krita-mcp --call) usando lotes de <= 32 traços (rigorosamente <= 64 por chamada draw_brush).
    • Exporte a tela renderizada em escala de cinza e, opcionalmente, execute --feedback-canvas <png> (Estágio 7) para sintetizar microtraços direcionados onde os traços de referência foram perdidos (dist >= 1.35 px) ou subescurecidos.
  5. Validação e Entrega (scripts/validate_lineart.py):

    • Verifique os limites do esquema do manifesto, calcule SSIM, PSNR_dB, Contour_F1 (1.5 px), Exact_Pixel_F1 (0.5 px), Fine_Detail_Recall, Narrow_Gap_Preservation em toda a tela e regionalmente, e gere PNGs de diferença de alinhamento em vermelho/azul/cinza escuro.
    • Uma vez que o lineart passe na validação, entregue para krita-flat-colouring.

Invocação Rápida via CLI

Planeje traços offline, valide os limites do manifesto e emita JSON de lote MCP portátil do Krita:

python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
  --input path/to/reference.png \
  --preset skills/krita-lineart-reconstruction/examples/sample_region_preset.json \
  --output-manifest out/lineart_manifest.json \
  --batch-dir out/batches \
  --mode dry_run

Execute ao vivo contra uma sessão ativa do Krita 6.0.4:

python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
  --input path/to/reference.png \
  --output-manifest out/lineart_manifest.json \
  --mode http_bridge \
  --doc-name Character_Lineart

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