Habilidad de Color Plano Uniforme para Krita
Transforma lineart limpia y terminada de Krita en una ilustración de Krita editable y lista para producción, organizada en capas de color plano uniforme (un solo hex) semánticas, listas para la entrega inmediata a un artista humano.
Esta habilidad es agnóstica al agente: la segmentación topológica, la extracción de polígonos de contorno y la validación de uniformidad están desacopladas del transporte de Krita dentro de scripts/krita_adapter.py.
Límites Estrictos del Ámbito de Producción (Detenerse en Planos)
- Garantía Estricta de Solo Planos: Produce exactamente un único hex RGB objetivo por capa hoja (
alpha == 255,opacity = 1.0). - Operaciones Estrictamente Prohibidas (aplicadas mediante
configs/default_config.jsonyKritaAdapter):- NO sombreado, sombras, oclusión ambiental, luces, luz de borde o rubor subcutáneo.
- NO degradados, aerógrafo suave, mezcla pictórica (Atsunuri) o destellos especulares en los ojos.
- NO pilas de capas de iluminación global (
multiply,lighten,overlay,add,screen,soft_light,color_dodge). - NO recolorización de lineart por retención de color.
- Preservación de Lineart: Clona la lineart original a una capa de respaldo bloqueada y oculta antes de agregar grupos de color. Cuando los silueteados sólidos de prendas/accesorios contienen colores planos interiores, utiliza una
transparencymaskreversible en lugar de borrar o redibujar píxeles de lineart.
Flujo de Trabajo del Procesamiento Principal
-
Ingesta de Lineart y Etiquetado de Componentes Conectados (
scripts/region_segmentation.py):- Umbraliza la tinta (
gray < 200), cierra poros de trazo de 1 px (cierre binario 3x3) y etiqueta las regiones interiores. - Identifica automáticamente el silueteado exterior a partir de las etiquetas de fondo que tocan el borde (o
exterior_bg_labelsdeclarativos en--spec).
- Umbraliza la tinta (
-
Partición Semántica y Topológica (
scripts/region_segmentation.py):- Regiones de Material en Corredores de Tinta: Aísla bandas/correas oscuras de vestimenta/accesorios delimitadas por
tinta y geometría y silueta, erosionando opcionalmente2 pxpara producir una máscara de transparenciaFill_Windowreversible sobre interiores oscuros. - Superposiciones Pre/Post: Aísla regiones de esclerótica, iris o tapas pequeñas delimitadas.
- Competencia Voronoi EDT: Resuelve bolsas de sombra en los bordes entre materiales adyacentes (por ejemplo, cabello vs. piel, cabello principal vs. trenza trasera) mediante la transformada de distancia euclidiana.
- Incrustación de Tinta de 1 px: Diluye los rellenos
1 pxdebajo de los contornos de tinta colindantes para que los bordes de trazo con anti-aliasing no dejen halos blancos. - Alternativa Genérica: Sin un
--specsemántico, etiqueta automáticamente los componentes interiores cerrados>= 16 pxen capas aisladasFlats/Region_NNy registra las regiones más pequeñas/sin mapear.
- Regiones de Material en Corredores de Tinta: Aísla bandas/correas oscuras de vestimenta/accesorios delimitadas por
-
Jerarquía No Destructiva y Barridos de Pincel Contenidos en Polígonos (
scripts/layer_setup.py,scripts/polygon_selection.py,scripts/flat_fill_planner.py):- Construye grupos de capas independientes con
blending_mode = "normal",inherit_alpha = falsedebajo deLineart/. - Convierte las máscaras en llamadas
select_polygonde Krita para el contorno exterior (replace/add) y los agujeros (subtract) utilizando el desplazamiento calibrado de+0.58 px(SUBPX = 0.58). - Pinta barridos de pincel en espiral sólidos a presión completa (
1.0), opacidad completa (1.0) usando"b) Basic-5 Size"empaquetados en fragmentosedit_batchde<= 60ediciones (por debajo del límite de64ediciones de Krita). - Establece
alpha_locked = trueen las capas hoja después del relleno para que los artistas puedan sombrear inmediatamente dentro de los límites.
- Construye grupos de capas independientes con
-
Validación e Informe de Entrega al Artista (
scripts/validate_flat_color.py):- Confirma la uniformidad 100% de un solo hex RGB en todos los píxeles opacos exportados.
- Verifica derrame exterior cero fuera del silueteado del personaje.
- Documenta cualquier región anatómica semiabierta o ambigua (por ejemplo, uñas débiles no encerradas, bordes de uñas semiabiertos pequeños) para revisión manual del artista en lugar de hacer suposiciones.
Invocación Rápida desde 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
Ejecutar directamente contra un documento activo de 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
Guías de Referencia y Configuraciones
references/architecture.md— Límites del ámbito, separación de módulos y estructura de capas para entrega al artista.references/region-segmentation.md— Aislamiento de componentes conectados, empates Voronoi EDT, incrustación de tinta y DSL declarativoregion_spec.json.references/flat-execution-and-layers.md— Sustracción de agujeros en polígonos, barridos de+0.58 px, empaquetadoedit_batchy enventanadotransparencymask.references/krita-interface.md— Límites del puente nativo de Krita 6.0.4, validación de esquemas y protecciones en tiempo de ejecución contra operaciones no planas.references/validation.md— Verificaciones de uniformidad de un solo hex, contención de derrames y registro de bolsas no resueltas.references/troubleshooting.md— Corrección de fugas semiabiertas, desbordamiento de vértices de polígonos y errores de puente.configs/default_config.jsonyconfigs/layer_hierarchy_template.jsonexamples/workflow_example.md