Krita Uniforme Flachfarben-Fertigung (Flat Colouring)
Wandelt saubere, fertige Krita-Linearts in eine editierbare, produktionsreife Krita-Illustration um, die in semantische, einheitliche Einzelfarb-Ebenen (Flachfarben) organisiert ist und für die sofortige Übergabe an einen menschlichen Künstler bereitsteht.
Diese Fähigkeit ist agentenunabhängig: Topologische Segmentierung, Konturpolygon-Extraktion und Uniformitätsvalidierung sind vom Krita-Transport innerhalb von scripts/krita_adapter.py entkoppelt.
Harte Produktionsgrenzen (Stop bei Flachfarben)
- Strenge Nur-Flachfarben-Garantie: Ausgabe genau einer Ziel-Hex-RGB-Farbe pro Blattebene (
alpha == 255,opacity = 1.0). - Streng verbotene Operationen (durchgesetzt von
configs/default_config.jsonundKritaAdapter):- KEINE Schattierungen, Schlagschatten, Ambient Occlusion, Glanzlichter, Randlicht oder Unterhaut-Rötung.
- KEINE Verläufe, weiches Airbrushen, malerisches Verblenden (Atsunuri) oder spekuläre Augenreflexe.
- KEINE globalen Beleuchtungs-Ebenenstapel (
multiply,lighten,overlay,add,screen,soft_light,color_dodge). - KEINE Neufärbung von Lineart-Farben (Colour Hold).
- Lineart-Erhaltung: Klont das ursprüngliche Lineart in eine gesperrte, ausgeblendete Sicherungsebene, bevor Farbgruppen hinzugefügt werden. Wenn einfarbig schwarze Kleidungs-/Accessoire-Silhouetten flache Innenfarben enthalten, wird eine reversible
transparencymaskanstelle des Löschens oder Neuzeichnens von Lineart-Pixeln verwendet.
Kern-Pipeline-Workflow
-
Lineart-Import und Connected-Component-Labeling (
scripts/region_segmentation.py):- Schwellwert für Tinte (
gray < 200), schließt 1-Px-Strichlöcher (3x3binäres Schließen) und labelt Innenregionen. - Identifiziert die äußere Silhouette automatisch anhand von randberührenden Hintergrundlabels (oder deklarativen
exterior_bg_labelsin--spec).
- Schwellwert für Tinte (
-
Semantische & topologische Partitionierung (
scripts/region_segmentation.py):- Tintenkorridor-Materialregionen: Isoliert dunkle Kleidungs-/Accessoire-Bänder/-Träger, die durch
ink & geometry & silhouettebegrenzt sind, und erodiert optional2 px, um eine reversibleFill_Window-Transparenzmaske über dunklen Innenbereichen zu erzeugen. - Vorher/Nachher-Überlagerungen: Isoliert begrenzte Lederhaut-, Iris- oder kleine Kappenregionen.
- Voronoi-EDT-Wettbewerb: Löst Randschattenpockets zwischen benachbarten Materialien auf (z. B. Haare vs. Haut, Haupt-Haare vs. Rücken-Zopf) mittels euklidischer Distanztransformation.
- 1-Px-Tintenfalle: Dehnt Füllungen um
1 pxunter angrenzende Tintenkonturen aus, sodass anti-aliasingbedingte Strichkanten keine weißen Höfe hinterlassen. - Generischer Fallback: Ohne semantische
--specwerden eingeschlossene Innenkomponenten>= 16 pxautomatisch in isolierteFlats/Region_NN-Ebenen labelt und kleinere/nicht zugeordnete Regionen protokolliert.
- Tintenkorridor-Materialregionen: Isoliert dunkle Kleidungs-/Accessoire-Bänder/-Träger, die durch
-
Nicht-destruktive Hierarchie & polygongesteuerte Pinselzüge (
scripts/layer_setup.py,scripts/polygon_selection.py,scripts/flat_fill_planner.py):- Baut unabhängige Ebenengruppen mit
blending_mode = "normal",inherit_alpha = falseunterhalb vonLineart/auf. - Wandelt Masken in Krita
select_polygon-Aufrufe um: äußere (replace/add) + Löcher (subtract) unter Verwendung der kalibrierten+0.58 px-Verschiebung (SUBPX = 0.58). - Malt solide, volldruckbetonte (
1.0), voll deckende (1.0) serpentinenförmige Pinselzüge mit"b) Basic-5 Size", verpackt in<= 60-Edit-Chunksedit_batch(unter Krita's64-Edit-Limit). - Setzt nach dem Füllen
alpha_locked = trueauf flachen Blattebenen, sodass Künstler sofort innerhalb der Grenzen schattieren können.
- Baut unabhängige Ebenengruppen mit
-
Validierung & Künstler-Übergabebericht (
scripts/validate_flat_color.py):- Bestätigt 100% einheitliche Einzel-Hex-RGB-Farbe über exportierte opake Pixel.
- Überprüft kein Überspritzer nach außen außerhalb der Figurensilhouette.
- Dokumentiert halboffene oder mehrdeutige anatomische Regionen (z. B. schwache nicht umschlossene Fingernägel, halboffene kleine Nagelränder) zur manuellen Überprüfung durch den Künstler, anstatt zu raten.
Schneller CLI-Aufruf
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart pfad/zu/sauberem_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir arbeit/flat_batches \
--diag-out arbeit/flat_diag.png \
--audit-out arbeit/flat_audit.json \
--setup-layers \
--mode dry_run
Direkte Ausführung gegen ein laufendes Krita 6.0.4-Dokument:
python3 skills/krita-flat-colouring/scripts/apply_flat_colors.py \
--lineart pfad/zu/sauberem_lineart.png \
--spec skills/krita-flat-colouring/examples/sample_region_spec.json \
--batch-dir arbeit/flat_batches \
--setup-layers \
--mode http_bridge
Referenzhandbücher & Konfigurationen
references/architecture.md— Grenzen des Umfangs, Modultrennung und Ebenenstruktur für die Künstlerübergabe.references/region-segmentation.md— Connected-Component-Isolation, Voronoi-EDT-Verbindungen, Tintenfalle und deklarativeregion_spec.json-DSL.references/flat-execution-and-layers.md— Polygon-Loch-Subtraktion,+0.58 px-Pinselzüge,edit_batch-Verpackung undtransparencymask-Fensterung.references/krita-interface.md— Krita 6.0.4 native Bridge-Grenzen, Schema-Validierung und Laufzeitsperren gegen Nicht-Flachfarben.references/validation.md— Einzel-Hex-Überprüfungen, Spill-Containment und Protokollierung ungelöster Pockets.references/troubleshooting.md— Behebung halboffener Lecks, Polygon-Scheitelpunktüberläufe und Bridge-Fehler.configs/default_config.json&configs/layer_hierarchy_template.jsonexamples/workflow_example.md