Compétence de Coloriage Plat Uniforme Krita
Transformez un lineart Krita propre et fini en une illustration Krita modifiable et prête pour la production, organisée en calques de couleur plate sémantique uniforme à un seul hexadécimal, prêts pour une remise immédiate à un artiste humain.
Cette compétence est agnostique en termes d'agent : la segmentation topologique, l'extraction de polygones de contour et la validation d'uniformité sont découplées du transport Krita dans scripts/krita_adapter.py.
Limites Strictes du Périmètre de Production (Arrêt aux Plats)
- Garantie Plat Strict : Produit exactement une seule couleur RVB hexadécimale cible par calque feuille (
alpha == 255,opacité = 1.0). - Opérations Strictement Interdites (appliquées par
configs/default_config.jsonetKritaAdapter) :- AUCUN ombrage, ombres, occlusion ambiante, rehauts, lumière rasante ou rougeur sous-cutanée.
- AUCUN dégradé, aérographe doux, fusion picturale (Atsunuri) ou reflets spéculaires dans les yeux.
- AUCUNE pile de calques d'éclairage global (
multiply,lighten,overlay,add,screen,soft_light,color_dodge). - AUCUN recolorisation de la retenue de couleur du lineart.
- Préservation du Lineart : Clone le lineart original vers un calque de sauvegarde verrouillé et caché avant d'ajouter des groupes de couleurs. Lorsque des silhouettes de vêtements/accessoires noirs unis contiennent des couleurs intérieures plates, utilise un
transparencymaskréversible plutôt que d'effacer ou de redessiner les pixels du lineart.
Flux de Travail du Pipeline Principal
-
Ingestion du Lineart et Étiquetage des Composantes Connexes (
scripts/region_segmentation.py) :- Seuille l'encre (
gris < 200), ferme les trous d'épingle de trait de 1 px (fermeture binaire3x3) et étiquette les régions intérieures. - Identifie automatiquement la silhouette extérieure à partir des étiquettes d'arrière-plan touchant les bords (ou
exterior_bg_labelsdéclaratif dans--spec).
- Seuille l'encre (
-
Partitionnement Sémantique et Topologique (
scripts/region_segmentation.py) :- Régions de Matériaux de Couloir d'Encre : Isole les bandes/bracelets de vêtements/accessoires sombres délimités par
encre & géométrie & silhouette, en érodant éventuellement2 pxpour produire un masque de transparenceFill_Windowréversible sur les intérieurs sombres. - Superpositions Avant/Après : Isole les régions délimitées de la sclérotique, de l'iris ou des petits capuchons.
- Compétition Voronoi EDT : Résout les poches d'ombre limites entre matériaux adjacents (par exemple, cheveux vs. peau, cheveux principaux vs. tresse arrière) via la transformée de distance euclidienne.
- Piégeage d'Encre 1 px : Dilate les remplissages de
1 pxsous les contours d'encre voisins afin que les bords de traits anti-aliasés ne laissent aucun halo blanc. - Solution Générique de Rechange : Sans
--specsémantique, étiquette automatiquement les composants intérieurs fermés>= 16 pxdans des calquesPlats/Region_NNisolés et enregistre les régions plus petites/non mappées.
- Régions de Matériaux de Couloir d'Encre : Isole les bandes/bracelets de vêtements/accessoires sombres délimités par
-
Hiérarchie Non Destructive et Balayages de Pinceau Contenus par Polygones (
scripts/layer_setup.py,scripts/polygon_selection.py,scripts/flat_fill_planner.py) :- Construit des groupes de calques indépendants
mode_fusion = "normal",alpha_hérité = falsesousLineart/. - Convertit les masques en appels
select_polygonde Krita extérieurs (remplacer/ajouter) + trous (soustraire) en utilisant le décalage calibré+0,58 px(SUBPX = 0.58). - Peint des balayages de pinceau serpentins pleine pression (
1.0), pleine opacité (1.0) en utilisant"b) Basic-5 Size"regroupés en morceauxedit_batchde<= 60modifications (sous la limite de64modifications de Krita). - Définit
alpha_verrouillé = truesur les calques plats feuilles après le remplissage afin que les artistes puissent immédiatement ombrer dans les limites.
- Construit des groupes de calques indépendants
-
Validation et Rapport de Remise à l'Artiste (
scripts/validate_flat_color.py) :- Confirme une uniformité RVB 100% monocouleur sur les pixels opaques exportés.
- Vérifie zéro débordement extérieur en dehors de la silhouette du personnage.
- Documente les zones anatomiques semi-ouvertes ou ambiguës (par exemple, ongles faibles non fermés, petits rebords d'ongles semi-ouverts) pour un examen manuel par l'artiste plutôt que de deviner.
Invocation CLI Rapide
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart chemin/vers/lineart_propre.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir travail/lots_plats \
--diag-out travail/diag_plat.png \
--audit-out travail/audit_plat.json \
--setup-layers \
--mode dry_run
Exécution directe sur un document Krita 6.0.4 actif :
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart chemin/vers/lineart_propre.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir travail/lots_plats \
--setup-layers \
--mode http_bridge
Guides de Référence et Configurations
references/architecture.md— Limites du périmètre, séparation des modules et structure des calques pour la remise à l'artiste.references/region-segmentation.md— Isolation des composantes connexes, liaisons Voronoi EDT, piégeage d'encre et DSL déclaratifregion_spec.json.references/flat-execution-and-layers.md— Soustraction de trous de polygones, balayages+0.58 px, regroupementedit_batchet fenêtragetransparencymask.references/krita-interface.md— Limites du pont natif Krita 6.0.4, validation de schéma et gardes d'exécution non plates.references/validation.md— Vérifications d'uniformité monocouleur, confinement des débordements et enregistrement des poches non résolues.references/troubleshooting.md— Correction des fuites semi-ouvertes, des dépassements de sommets de polygones et des erreurs de pont.configs/default_config.json&configs/layer_hierarchy_template.jsonexamples/workflow_example.md