Compétence de reconstruction de lineart Krita
Package et exécute un pipeline validé et prêt pour la production de reconstruction de lineart Krita en résolution 1x native à partir d'une illustration de référence tramée.
Cette compétence est agnostique vis-à-vis de l'agent : la synthèse mathématique des trajectoires, le tracé du squelette topologique, l'étalonnage et la validation sont strictement isolés de l'exécution Krita RPC/MCP/CLI via scripts/krita_adapter.py.
Limites strictes de la portée de production
- Résolution native
1xuniquement : N'activez pas le suréchantillonnage2xou la mise à l'échelle combinée2x + adaptative.adaptive_subdivision.pyetstroke_planner.pyrejettent toutresolution_scale != 1/supersample_factor != 1. - Lineart uniquement : Produit de l'encre noire nette
#000000sur un calque de peinture dédiéLineart(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc). N'effectue pas de mise en couleur plate, d'ombrage, de dégradés, d'occlusion ambiante, d'empilement d'éclairage ou de rendu. - Pinceaux Krita natifs uniquement : Synthétise les traits exclusivement via des préréglages de pinceaux calibrés (
d) Ink-3 Gpenetb) Basic-5 Sizepour les remplissages graphiques larges) plutôt que d'importer des calques tramés.
Flux de travail principal du pipeline
-
Analyse de la référence et extraction de l'encre (
scripts/ink_analysis.py) :- Un seuillage à deux niveaux capture l'encre noire solide (
inv > 42.0) et les crêtes délicates à faible contraste (local_dark > 14.0 & inv > 18.0par rapport à un gaussiensigma = 4.0), plus des surcharges fines optionnelles par boîte englobante (region_overrides) pour les espaces serrés denses comme les anneaux concentriques de l'iris. - Détecte les cœurs noirs graphiques épais via une transformée de distance euclidienne (
edt >= 2.8 px, surface>= 20 px) et extrait les contours d'iso-distance (1.35 .. 16.20 px). - Squelettise l'encre restante, élague les épines de quantification courtes (
<= 4itérations), épisse les trajectoires colinéaires aux jonctions de degré>= 3(cos <= -0.68), affine les lignes centrales en précision sub-pixellique (refine_ridge_subpixel), et scinde aux angles vifs (> 72 deg) ou à la portée maximale de540 px.
- Un seuillage à deux niveaux capture l'encre noire solide (
-
Ajustement de spline et densité adaptative de sommets validée (
scripts/bezier_core.py,scripts/adaptive_subdivision.py) :- Ajuste des segments de Bézier cubiques G1-continus par morceaux avec des poignées tangentes optimales par moindres carrés.
- Affine l'échantillonnage des cordes avec la subdivision récursive par file de priorité des courbes de Bézier cubiques (validée dans l'expérience 2 à
1x), en plafonnant les sommets par trait à la limite stricte de Krita de 128 points tout en maintenant des tolérances serrées sur la flèche de corde, la déflexion de l'angle tangent, le produit courbure-arc, la fidélité de la pression, et la longueur de corde droite.
-
Étalonnage des pinceaux et des coordonnées Krita 6.0.4 (
scripts/pressure_calibration.py,scripts/stroke_planner.py) :- Intègre la largeur de ligne optique le long des normales locales avec arrêt dans les vallées (
max_half = 4.8 px) pour éviter le gonflement des brins voisins. - Sélectionne les courbes de pression empiriques à double régime du
d) Ink-3 Gpen(GPEN_THINquandbrush_size <= 4.5 px;GPEN_STDquandbrush_size > 4.5 px) ou les tablesb) Basic-5 Sizedéfinies dansconfigs/pressure_tables_krita604.json. - Décale les échantillons de sommets et les points de contrôle de Bézier de
+0,58 px(PIXEL_CENTER_SHIFT) pour aligner les dabs de traits sur les centres de pixels de Krita, et ordonne les traits en étapes 1 à 6 (cœurs graphiques -> silhouettes extérieures -> zones focales -> structure intérieure -> mèches fines).
- Intègre la largeur de ligne optique le long des normales locales avec arrêt dans les vallées (
-
Exécution et retour visuel en boucle fermée (
scripts/reconstruct_lineart.py,scripts/refinement.py) :- Exécute via
KritaAdapterendry_run(export batch JSON portable),http_bridge(POST /rpc), oukrita_mcp_cli(krita-mcp --call) en utilisant des lots de<= 32traits (strictement<= 64par appeldraw_brush). - Exporte le canevas rendu en niveaux de gris et exécute optionnellement
--feedback-canvas <png>(étape 7) pour synthétiser des micro-traits ciblés là où les traits de référence ont été manqués (dist >= 1.35 px) ou sous-foncés.
- Exécute via
-
Validation et transfert (
scripts/validate_lineart.py) :- Vérifie les limites de schéma du manifeste, calcule les
SSIM,PSNR_dB,Contour_F1(1,5 px),Exact_Pixel_F1(0,5 px),Fine_Detail_Recall,Narrow_Gap_Preservationsur tout le canevas et par région, et génère des PNG de différence d'alignement rouge/bleu/gris foncé. - Une fois le lineart validé, passe le relais à
krita-flat-colouring.
- Vérifie les limites de schéma du manifeste, calcule les
Invocation CLI rapide
Planifiez les traits hors ligne, validez les limites du manifeste et émettez un JSON batch portable pour MCP 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
Exécutez en direct contre une session Krita 6.0.4 active :
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
Guides de référence et configurations
references/architecture.md— Disposition des modules et limites d'isolation agnostiques vis-à-vis de l'agent.references/bezier-and-sampling.md— Ajustement des courbes de Bézier cubiques G1, subdivision récursive par file de priorité comparée à l'échantillonneur hérité, et pourquoi le suréchantillonnage est exclu.references/calibration.md— Étalonnage des coordonnées à+0,58 pxet tables à double régimeInk-3 Gpen/Basic-5 Size.references/krita-interface.md— Protocole de pont natif Krita 6.0.4, limites strictes du schéma et gestion des erreurs.references/validation.md— Métriques de fidélité, retour résiduel en boucle fermée et critères de réussite.references/troubleshooting.md— Diagnostic des détails manquants, écrêtage des sommets et erreurs de pont.configs/default_config.jsonetconfigs/pressure_tables_krita604.jsonexamples/workflow_example.md