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。

第一部分:筆刷系統(references/engine/;每個檔案的 docstring 就是其手冊,在無參數執行時會列印出來)

  • 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 後執行它。

顏料的表現方式

  • 水洗會疊加。 light = paper × (colour / paper) ^ alpha,每個通道:一個水洗的顏色是它在 白紙上顯示的顏色;在顏料之上它是一個乘數,相同的水洗疊加兩次會得到 colour²。所以一件服飾是一 個局部顏色和一系列釉層,這件服飾專屬:SAGE, TURN, SHADE, DEEP, DARK, RIB = ladder(lit, shadow, dark, 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" 會重新產生。

第二部分:畫家指南

首先閱讀 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. 研究,然後決定。 將來源以 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。 7. 特徵:一次精確的處理,然後用手工,細且淺。 8. 鉛筆最後,而且少量: 在一個形體重疊另一個形體的地方。 9. 提起用於少數失去的亮部。當一個筆觸會解釋清楚時停止。

大面積區域以筆觸繪製

一件由填充形狀構成的服飾就像是平面透鏡的馬賽克,無論其數值多麼正確。畫家在該處的單位是 筆觸:一個沾滿顏料的筆刷沿著形體拖動,先寬後窄,逐漸乾燥。一件大面積服飾的每個水洗都是一 個筆觸會話("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 顯示哪裡

…

[為了翻譯而截斷]

相關技能