Krita 均匀平涂上色技能
将干净的已完成 Krita 线稿转换为一个可编辑、面向生产的 Krita 插图,该插图组织成按语义划分的、统一的单十六进制纯色图层,可直接供人工艺术家接手。
此技能是代理无关的:拓扑分割、轮廓多边形提取和均匀性验证与 Krita 传输在 scripts/krita_adapter.py 中解耦。
硬性生产范围边界(止于平涂)
- 严格纯色保证:每个叶子图层输出恰好一种目标十六进制 RGB(
alpha == 255,opacity = 1.0)。 - 严格禁止的操作(由
configs/default_config.json和KritaAdapter强制执行):- 无阴影、投影、环境光遮蔽、高光、边缘光或次表面泛红。
- 无渐变、软喷枪涂抹、厚涂混合(Atsunuri)或眼睛高光。
- 无全局光照图层叠加(
multiply,lighten,overlay,add,screen,soft_light,color_dodge)。 - 无线稿颜色保留重新上色。
- 线稿保护:在添加颜色组之前,将原始线稿克隆到一个锁定、隐藏的备份图层。当实色黑色服装/配饰轮廓包含平涂内部颜色时,使用可逆的
transparencymask而不是擦除或重绘线稿像素。
核心流水线工作流程
-
线稿输入与连通组件标记(
scripts/region_segmentation.py):- 对墨线进行阈值处理(
gray < 200),闭合 1 像素描边小孔(3x3二值闭合),并标记内部区域。 - 根据接触边界的背景标签(或
--spec中声明的exterior_bg_labels)自动识别外部轮廓。
- 对墨线进行阈值处理(
-
语义与拓扑分区(
scripts/region_segmentation.py):- 墨水走廊材质区域:分离由
ink & geometry & silhouette界定的深色服装/配饰带/束带,可选择侵蚀2 px以在深色内部区域上生成可逆的Fill_Window透明度蒙版。 - 前/后覆盖层: 隔离有界的巩膜、虹膜或小帽区域。
- Voronoi EDT 竞争:通过欧几里得距离变换解决相邻材质之间的边界阴影口袋(例如,头发 vs. 皮肤,主头发 vs. 后辫)。
- 1 像素墨水陷印:将填充物向相邻墨线轮廓下方扩张
1 px,使抗锯齿描边边缘不留白色光晕。 - 通用回退:无语义
--spec时,自动将大小>= 16 px的包围内部组件标记为独立的Flats/Region_NN图层,并记录较小的/未映射区域。
- 墨水走廊材质区域:分离由
-
非破坏性层次与多边形内含画笔扫掠(
scripts/layer_setup.py,scripts/polygon_selection.py,scripts/flat_fill_planner.py):- 在
Lineart/下方构建独立的blending_mode = "normal",inherit_alpha = false图层组。 - 使用校准的
+0.58 px偏移(SUBPX = 0.58),将蒙版转换为 Kritaselect_polygon外轮廓(replace/add)加孔洞(subtract)调用。 - 使用
"b) Basic-5 Size"画笔,以全压力(1.0)、全不透明度(1.0)绘制实色蛇形扫掠,并打包成<= 60次编辑的edit_batch块(在 Krita 的64次编辑上限内)。 - 填充后,在叶子平涂图层上设置
alpha_locked = true,以便艺术家可以立即在边界内进行着色。
- 在
-
验证与艺术家交接报告(
scripts/validate_flat_color.py):- 确认导出的不透明像素100% 为单十六进制 RGB 均匀性。
- 验证角色轮廓外部无外溢。
- 记录任何半开放或模糊的解剖区域(例如,模糊的未封闭指甲、半开口的小指甲边缘),而不是猜测,以供人工审查。
快速 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
直接针对活动的 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
参考指南与配置
references/architecture.md— 范围边界、模块分离和艺术家交接图层结构。references/region-segmentation.md— 连通组件隔离、Voronoi EDT 连接、墨水陷印和声明式region_spec.jsonDSL。references/flat-execution-and-layers.md— 多边形孔洞减法、+0.58 px扫掠、edit_batch打包和transparencymask窗口化。references/krita-interface.md— Krita 6.0.4 原生桥接限制、模式验证和非平涂运行时保护。references/validation.md— 单十六进制均匀性检查、外溢限制和未解析口袋记录。references/troubleshooting.md— 修复半开放泄漏、多边形顶点溢出和桥接错误。configs/default_config.json&configs/layer_hierarchy_template.jsonexamples/workflow_example.md