Community图像github.com

水彩笔

用确定性的代码画铅笔淡彩:肖像、人物、衣服和小插图,不调用图像模型。

水彩笔 是什么?

一套用代码作画的铅笔淡彩方法。晕染、运笔和干边都是几何,所以一整组插图能出自同一只手。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/watercolour-brush/tree/HEAD/skills/watercolour-brush

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

水彩画笔

两件事,分开处理:一个画笔系统(纸、颜料、水和笔触作为代码;确定性的)和一份画家指南(如何用它作画)。系统完全按指令执行;一幅好画来自指南中通过观察做出的决策。没有“仅默认”模式:每一个自动化步骤都是一个你可以覆盖的建议。引擎位于 references/engine/ 中的四个代码块内,指南文件在 references/ 中;所有命令都从引擎文件夹运行。

引擎设置,每个项目一次: 引擎以四个 Markdown 文件的形式提供,放在 references/engine/ 中(wash.md、regions.md、look.md、selftest.md),每个文件包含一个代码块。使用命令将这四个代码块复制出来,切勿手动重新输入(约 190 KB 代码),例如对于每个 NAME: awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine/NAME.md > DIR/NAME.py,从而在项目的一个文件夹中生成 wash.py、regions.py、look.py 和 selftest.py(例如 art/watercolour/;如果已经存在,则直接复用)。它们是纯 Python 3(3.12 或更新版本),需要 numpy 和 opencv-python-headless:按照这些包自己的页面说明进行安装(numpy、opencv-python-headless;引擎已在 numpy 2.5.5 和 opencv-python-headless 5.1.0.95 下测试)。然后运行 python3 selftest.py 检查设置。 从示例开始,将其文件夹从 references/examples/NAME/(source.png、areas.json 等)复制到引擎文件夹下的 examples/NAME/,并将其代码块(references/examples/NAME/NAME.md)保存为 NAME.py 放在该副本中:示例会在自身旁边查找数据(persimmon 没有数据:只有它的代码块,作为 examples/persimmon/persimmon.py)。以下所有命令都在引擎文件夹中运行,例如 python3 wash.py examples/cardigan/cardigan.py examples/cardigan/out。

第 1 部分:画笔系统(references/engine/;每个文件的文档字符串就是其手册,无参数运行时打印)

  • wash.py — 引擎。一张画是一张冷压纸和一个图层列表。 python3 wash.py DRAWINGS.py OUT_DIR [name …];以 2 倍大小绘制并缩小;任何尺寸至 2K。
    • 绘画:透明水彩洗色,会相乘(浅色部分是通过 "out" 保持干燥的纸,或通过 "lift" 擦除的);硬边带边缘线,湿画延伸("w" 节点)、"soft"、"bleed";"grade",一个形状内的湿渐变;干笔触、"feather" 笔画;石墨。"brush":一支蘸满颜料的画笔的一系列湿笔触,是所有大面积区域的基本单位:每个笔触根据其按压程度("w")决定宽度,在其 "load" 耗尽时断裂;在笔触序列内部它们会相互融合("wet"),其外部边界是一条硬边;末端 "cut" 成斜角,有一侧会 "melt" 或 "drag"。"knit" 和 "cable":缝线和编织图案,在形体之后添加,其强度根据它们下方的数值读取。具有 "name" 的图层是其他图层的剪辑区域("clip")或排除区域("out");"eyes" 和 "head" 提供头部单位。
    • 水(除非特别要求,否则关闭;"水彩特性" 指明位置和程度):"miss"、"ragged"、"dry"、"settle"、"sediment"、"broken"、图层 "bloom" 和 "sparkle"、图层自身的 "seed"。从底层线稿("under"、"masks"):study(水彩洗色,从大而浅到小而深)、hatch、trace。
    • 辅助函数(from wash import …;python3 wash.py helpers 打印所有参数)。衣物的色调值:ladder(从源图颜色得到的色釉系列)、need(从一个测量色调到下一个的 alpha 值)、toned(一个水彩洗色在其最终色调处的水量,由在源图上测得的斑点决定)、step_to(两者)。笔画:strokes_along(两条引导线之间的区域,或您绘制的形状,填充了跟随形体的笔画)、hem(衣物停止处的不均匀笔画末端:叶瓣状,而非滴状)。标记:runs、ribs、ring、arc、beside、scallop。nodes_of 粗略勾勒出一个轮廓;它从不用于阴影形状。
  • regions.py — 第 1 和第 2 步,每步只需几秒。propose SOURCE DIR 将源图切割成编号区域,并猜测 areas.json;您需要修正它(ID、点、多边形;"approved": true);build 生成蒙版、底层线稿、起始值。
  • look.py — 画家的眼睛和工具;它不绘制任何东西;所有操作都在源图的像素坐标中。 读取源图:grid(放大,带坐标:每个节点都通过它读取,长边每 40–50 像素一个节点;肉眼仍有 10–15 像素的误差)、tones(色调行)、shapes(一个区域用四个色调值表示;用于观察,而非描摹)、values(最深色 1 / 5 / 25 / 50 %、颜色)、speck(衣物的水彩洗色显示了多少纸张纹理:其水量)、ladder、glaze、over、frame。自我检查:paths(您在源图上的标记)、layers(单独的某一图层或笔触序列,或到第 N 层的整个画面)、holes(笔触序列内部留白的纸张区域)、diff(渲染图减去源图,逐像素对比,以及每个区域内误差在 15 / 25 个灰阶内的点的比例:这指导衣物的几轮调整)、texture、setin。
  • selftest.py — 每行对应引擎的一个承诺;修改 wash.py 或 regions.py 后运行。

颜料的行为方式

  • 水彩洗色相乘。 浅色 = 纸张 × (颜色 / 纸张) ^ alpha,按通道:一个洗色的颜色是它在白纸上的颜色;覆盖在颜料上时它充当乘数,并且同一个洗色涂两次得到 颜色²。因此,一件衣物有一个固有色和一系列色釉,这些色釉是该衣物所特有的:SAGE, TURN, SHADE, DEEP, DARK, RIB = ladder(亮部, 阴影, 深色, on=source_paper),从源图上读取的三个颜色得到(复制的色釉系列会带有其他衣物的色调)。色釉的强度是算术计算,而非凭感觉:need(SHADE, 114, 66) 是将色调 114 变为 66 的 alpha 值。
  • 没有浅色覆盖在深色之上。 按钮、按扣、深色水彩洗色上的高光,除非被预留或提亮(worked-example.md、winter-clothes.md 3),否则会变黑。因此,两件衣物中较深的那件后画,无论其在现实中的上下位置如何,都位于一个共享的节点列表上。较浅的衣物只有在靠近纸张或上层的衣物是深色时,才能在其下方运行;绝不在中间色调上用暖色覆盖冷色(奶油色在蓝灰色下:会产生脏色):look.py over UNDER UPPER。
  • 深色是密度,水量是测量的。 "grain"、"pool"、"settle"、"sediment" 是颜料的份额,色调值越低显示得越多。look.py speck SRC mask=… 读取此织物的显示效果(光滑外套 3–4 %,棉袄 6–10 %);toned(KIND, tone, PAPER, speck=…) 给出每个洗色的相应效果(dark-cloth.md 1、winter-clothes.md 0)。
  • 边缘。 硬边带有边缘线。"w" 节点会使大约 3 倍于 "wet" 宽度的一段区域柔化。"clip" / "out" 产生硬切且不留边缘线:用核心阴影或铅笔线条说出那条边缘。共享一条边的形状共享 "wobble"。
  • 尺寸和随机性。 路径、宽度和 "wet" 是网格单位;画笔的标记和纸张的尺寸相对于画面大小进行调整("fine"、"weave";starting-values.md)。图层的随机性是它自己的:其 "seed" 会重新抛出。

第 2 部分:画家指南

首先阅读 style.md(外观,经过测量)。从两个演练示例之一开始作画,每个示例包含一个文件和一个命令(按照“引擎设置”进行设置):examples/cardigan/cardigan.py(一幅来自浅色素描的新画:头部和面部、灰色头发、一件开襟毛衣内搭浅色衬衫,背后是纯色纸张)或 examples/winter/winter.py(一幅重绘的完成画作:一个孩子、长长的深色头发、一件深色棉袄、一条围巾、一件编织毛衣、其自身的洗色作为背景)。worked-example.md 会引导您完成这两个示例;dark-cloth.md 和 winter-clothes.md 包含了衣物的规则。

它能做什么和不能做什么

它重新绘制表面,而非风格:纸张、深度、水彩边缘、铅笔。身份、比例和面部绘制方式来自源图;卡通风格仍然保持卡通。指南是为人类编写的;小物件也使用相同的标记(references/examples/persimmon/persimmon.md)。它不能凭空创造一张脸:从这幅特定人物的、已经具有魅力的素描开始;如果它一眼看上去不是“多么可爱的人”,就停下来。代码生成的画面按顺序讲述:首先是大面积的衣物,然后是地面和头发:这就是观察和手工工作的重点所在。

工作顺序

  1. 研究,然后决定。 将源图以 1:1 比例放在您的画作必须与之并列的画作旁(它所加入的画作系列;如果没有系列,则使用 style.md),并在开始绘制前写下:这种风格不会绘制哪些线条(例如细密的皱纹网络、封闭的轮廓、墨水),人物背后是什么,哪些东西必须看起来是人工制作的(例如相框、纽扣、拉链)。一个已经是这种风格下完成画的源图,需要重绘:在 areas.json 中设置 "approved": true,画布采用源图的纸张,保留其地面;look.py frame 找到从中裁剪出的肖像的相框。
  2. 区域。 regions.py propose,读取 regions.png,修正 areas.json,build,以 1:1 比例读取 areas.png。首先按位置划分("within"、多边形),然后按颜色划分;几轮几秒的操作,手工绘制的衣物作为多边形。
  3. 底层线稿修正,由 build 生成:根据源图在该区域测量的数值,为每个区域提供更完整的色调值(starting-values.md);在皮肤上闭合的细暗线,混合三分之一回来;如同绘制出的特征。
  4. 大面积水彩洗色,颜色浅淡,围绕亮部进行绘制,使用笔触(下一节)。首先手工绘制衣物;头部、颈部和手通过底层线稿绘制。在第一次上色之前:look.py speck(每件衣物的水量)、tones(它在哪里是深色的)、paths(您在源图上的轮廓线)。色调通过测量和阶梯化计算(need),而非猜测。
  5. 阴影:每一个都由您决定。 每件衣物十到二十个:它们在哪里开始、膨胀和结束,哪条边是硬的,其节点通过 look.py grid 读取;然后作为笔触铺设。绝不要将源图的阈值追踪为路径(nodes_of,一个蒙版):会产生斑驳的脏色、喷枪般的云朵、等高线地图般的岛屿,并且比二十个决策更慢。
  6. 深色:晚些确定,且只做一次。 头发的深色区域、衣领和下巴下方、褶皱的核心、瞳孔、上睫毛线;绝不要通过加深皮肤来实现。在衣物上:在半色调干燥后,少量、大块且连接,每个充满颜料的笔触直接达到其色调("深色",以下);分步骤进行,深色会变成柔和的云朵。
  7. 在形体之后添加纹理(如针织物、缆绳花样):在完成后的色调值之上叠加一个图层;没有纹理就无法读懂的形体,需要返回第 4 步。
  8. 特征:一次精确的描绘,然后手工处理,细而淡。
  9. 铅笔最后添加,且少量使用:用于一个形体重叠另一个形体的地方。
  10. 提亮用于少数丢失的高光部位。当一个笔触会解释清楚时,停止。

大面积区域使用笔触绘制

由填充形状构成的衣物,其色调值即使正确,也只是一个平面透镜的组合。画家的单位是笔触:一支蘸满颜料的画笔沿着形体拖拽,先宽后窄,直至变干。大面积衣物的每一次水彩洗色都是一系列笔触序列("brush"),先大而淡,变干,然后小而深(两个示例中都是如此)。

  • 区域。 对于每个形体,画出两条引导线,方向与画笔走向一致:沿着袖子向下,顺着衣物的垂落方向,沿着肩膀的隆起。strokes_along(a, spacing, to=b) 铺设笔触;您指定范围(load、length、angle、ends;宽度由 spacing 和 lap 决定)和一个 seed,绝不要使用单一值:相等的笔触看起来像梳子。
  • 固有色:一系列宽幅饱含颜料的湿笔触(load 1.3–2、lap 0.8–1.3、"wet" 14–18),剪辑到衣物区域,并命名。单独查看它(look.py layers … only=NAME、look.py holes):哪里有一小片纸张仍空着,就再手工绘制一个笔触。半色调:强度不等的较窄笔触("wet" 7–12、"vary" 0.2),剪辑到第一次洗色之上。缓慢的转折:其区域的笔触 within=SHAPE,在潮湿状态下 "soft",并带有 "grade" 渐变。
  • 深色(winter.py 中 jacket() 的第 5 步;dark-cloth.md 4)。首先 look.py tones:哪里是深色,哪里保持浅色。亮部也是形状:预先保留大片区域("lit")。然后进行一次充满颜料的画笔的笔触序列("wet" 1.5,alpha need(DARK, HALF, 44):一种颜色,没有步骤),十到十五个笔触:每个节点的宽度(一个点、一个 60–90 的膨胀、一个提笔)、"cut" 末端、保留一侧,放弃另一侧("melt"、"drag")、一个溶解的末端;较浅的转折通过 "press" 实现。
  • 下摆就是笔触的末端。 衣物区域在此处是开放的:区域的引导线在下摆线上结束,hem(line, n, lengths, angles) 添加宽幅笔触。湿的末端是叶瓣状,宽大于长(窄而湿:则成为水滴;hem(reach=));只有变干的笔触才会被拖拽,使用深色自身混合的颜色(单独使用色釉会得到冷灰色)。
  • 针织物(cardigan.py 第 4 步):水彩洗色和形体与任何布料相同,但更平静("bristle" 0.1、宽 "wet")。然后在衣物之上添加一个 "knit" 图层,从带子和袖口区域 "out" 排除:"pitch" 和 "stitch" 在 4 倍放大下测量,颜色使用 look.py glaze GROUND GROOVE,"tones" 为其亮部和半色调;一条凹槽在所有色调值下都是其地面的三分之二("faint" 0.5)。
  • 填充形状保持正确,适用于小物体、平面和精确形状:翻领的正面、衣领、具有两条硬边的投影、袖口的凸起、纽扣、背景洗色。可能出现的问题:半透明带状(清晰的深色覆盖在清晰的深色上);下摆处的梳齿状;水滴;细条纹(lap 太小,load 太低);喷枪效果(全部使用 "soft");斑驳云朵(深色上的 "pool");色调值变暗(笔触比形状覆盖得更多)。深色:香肠状、碎片状、灰色面纱、松散片状、栅栏状。针织物:荆棘状、灯芯绒状、划痕状、印刷的人字形(winter-clothes.md)。

形体先于表面

一个带有纹理的干净形状仍然是平坦的:精确的轮廓、平静的洗色和凸纹只会给手臂一个气球般的形状。在任何颜料之前决定体积;look.py shapes 显示形体的位置。

相关技能