Community影像github.com

paper-brush

以確定性程式碼繪製扁平剪紙插圖(肖像、頭像、角色、場景、圖示),無需影像模型。可用於生成風格統一的系列作品,或為現有作品添加風格一致的圖片。

paper-brush 是什麼?

paper-brush 是一個扁平剪紙插畫的確定性渲染器,所有圖片均由一疊彩色紙形構成,每個形狀沿著畫筆路徑切割。由於渲染完全確定(相同輸入產生相同輸出),因此系列作品風格一致,且任何形狀均可透過編輯參數調整。此技能支援在任何專案中作為獨立渲染引擎使用,依賴 `numpy` 和 `opencv-python`,並提供了完整的繪圖元件庫(如 `scallop`、`ribs`、`oval`)以支援髮型、織物和細節繪製。關鍵優勢在於其風格一致性與可重複性:透過定義頭部軸線與可重用零件系統,開發者可以輕鬆建立臉部組件庫,確保系列頭像風格統一。此外,它提供了從參考圖片中「提取」形狀的功能(`lift` 命令),以及自動尋找節點的工具(`nodes` 命令),大幅縮短從參考到實作的路徑。適用於需要統一插畫風格的遊戲、App 頭像或品牌視覺素材製作。

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

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Paper brush(紙藝畫筆)

一個用於扁平剪紙插圖的確定性渲染器:每張圖片都是由一疊彩色紙形構成,每個形狀沿著筆工具路徑切割。相同的繪圖檔案輸入,產生相同的像素輸出,因此系列作品保持一致,且任何形狀都可以透過編輯少數幾個數字來微調。支援任何長寬比、紙張顏色和尺寸。

**引擎設置,每個專案一次:**渲染器以程式碼區塊的形式存放在 references/engine.md 中。使用命令複製出來,切勿重新輸入:awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py,其中 DIR 是專案的藝術資料夾(或暫存資料夾);同樣的命令將 references/example_drawings.md 轉換為起始的繪圖檔案。使用 python3 paper.py ... 執行(需要 numpy 和 opencv-python)。以下命令假設該檔案存在。如果 paper.py 已存在於該位置,則重複使用它。

外觀風格(請遵循)

在繪製之前請閱讀 references/style.md。簡而言之:少量的大形狀;節點少且弧線長;真正的角落標記為角落;每個材質有 2–3 種色調(基底、陰影、有時加亮部);陰影是乾淨的形狀,裁剪在其父形狀內部,通常有一條硬邊和一條漸淡邊緣;形狀周圍無輪廓線;僅在需要畫筆線條的地方才有線條(眉毛、睫毛、嘴巴、折痕),且總是漸細的;腮紅是唯一的模糊效果;溫暖的米白紙張和細微均勻的紋理覆蓋一切。

工作流程

  1. 在專案中設置繪圖檔案(例如 Tools/art/drawings.py),其中包含 DRAWINGS = {"name": {...}}。格式在 paper.py 的 docstring 中(不帶參數執行 python3 paper.py 會輸出該格式)。從 references/example_drawings.md 中的繪圖檔案開始。
  2. 選擇一個創作網格,如果有的話,再選擇一張參考圖片(草圖、繪畫、已核准的圖像)疊加在該網格上。根據已知比例讀取節點座標;像 h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p] 這樣的小 lambda 函數可以將參考圖片的像素轉換為所需座標。
  3. 如果需要,從遮罩粗略推導形狀:製作一個區域的黑白遮罩(顏色閾值、手繪遮罩),然後執行 python3 paper.py nodes MASK.png [scale] — 它會輸出已找到角落的節點。然後手動精簡和整理它們;手工處理是讓它看起來像剪紙而不是描摹的關鍵。
  4. 渲染:python3 paper.py path/to/drawings.py OUT_DIR [name …] → OUT_DIR/<name>.png。
  5. 查看、比較、調整。 將結果放在參考圖片(或已核准的系列)旁邊,以最終觀看尺寸顯示,例如 ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png,然後打開它。一次只修正一個問題:一個節點、一個色調、一個裁剪區域。預期需要數輪調整;在業主核准後提交。
  6. 交付時使用專案的尺寸和格式(使用 Lanczos 降採樣;JPEG q≈88 或 PNG)。圖片不超過 2K。如果專案為其藝術作品添加浮水印,請在核准後、發佈前添加。

匹配現有系列

當新圖片必須加入一個已有風格的系列(例如在已核准的頭像旁邊添加更多頭像)時,順序是先研究規則,再繪製,然後迭代:

  1. 研究參考資料並寫下規則。 放大觀察並測量:邊緣如何建立、每個材質的色調、陰影形狀的位置及其粗細、特徵在頭部軸線上的大小和位置、頭部佔據畫面的比例、紙張顏色和紋理。
  2. 校準:使用畫筆重新繪製一個參考圖片,將其放在原始圖片旁邊,進行調整直到匹配。
  3. 從參考圖片中提取具有風格的部件(眼睛、眉毛、耳內側): python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2 會輸出像素 X,Y 下方的扁平形狀,以該頭部軸線上的節點表示。疊加檢查;如果種子點落在皮膚上則移動它。
  4. 在原始圖片上繪製:python3 paper.py grid SOURCE.jpg grid.png 會生成一個帶有網格的副本(每 20 像素一條線,每 100 像素有標籤),以便讀取座標。每個形狀節點要少:臉部約 16 個,頭髮約 20–40 個。
  5. 在展示給任何人之前進行混合測試:將新圖片與參考圖片交錯排列在一個縮略圖大小的網格中(約 480 px)。如果能夠分辨出哪張是新的,則表示尚未完成。然後將每張圖片以其全尺寸與最接近的參考圖片並排檢查。

什麼方法行不通:憑想像繪製形狀(每張臉都長得一樣);按顏色描摹寫實繪畫(複製其塊狀結構);自動向量化參考圖片(斑駁);直接複製寫實臉部的特徵位置(嘴巴位置過低,臉看起來又長又老);從繪畫的暗部提取陰影形狀(產生污漬)。

頭部軸線上的典型臉部位置(請測量你自己的系列):眉毛約在 y -0.8,與眼線平行;鼻子是遠端的一個短鉤,x -0.3 至 -0.65,y 0.45 至 1.15;嘴巴約 1.1 單位寬,位於 y 1.6 至 1.8,幾乎與眼睛平行,兩端高度大致相同(一端抬高會看起來像在笑);下巴 y 2.8 至 3.1。給每個角色獨特的頭髮輪廓、眼睛和眉毛形狀以及調色板,否則系列會趨向於同一張臉。對於緊密的捲髮、辮子和羊毛,請使用 scallop();對於針織領口,使用 ribs();對於鏡片和按鈕,使用 oval()(from paper import scallop, ribs, oval)。

臉部:可重複使用的部件

對於一系列風格統一的臉部,為每個繪圖提供 "eyes": ((x, y), (x, y))。這定義了頭部自身的軸線(x 沿眼線方向,y 沿臉部向下,單位 = 眼距的一半),因此特徵可以編寫一次並應用於任何頭部:

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} — 節點使用頭部單位(寬度也是)。
  • {"part": ("setname", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} — 來自 parts.py 的部件放置在繪圖檔案旁邊:PARTS = {"setname": {"eye_l": {"nodes": [...]}, ...}},節點使用頭部單位。從已核准的圖片中提取部件一次(使用 nodes 跟蹤部件的遮罩,轉換為頭部單位),然後每個新臉部都重複使用它們,這使得整個系列看起來像出自同一雙手。
  • "mirror": True 將臉部轉向另一側,無需重新繪製。

常見陷阱

  • 形狀按順序繪製;"clip" 只能看到該 "name" 下已繪製的形狀。
  • 多個具有相同 "name" 的圖層疊加(聯集),適合由兩部分組成的身體。
  • "fade" 點使用網格座標:第一個點處強烈,第二個點處消失。
  • "soft" 使用網格單位;僅用於腮紅和發光效果。
  • 繪圖可以導入 from paper import flow, scallop, ribs, oval:引擎資料夾已在路徑中。
  • 不要讓繪圖 drift 成許多微小的形狀或輪廓線;如果一個細節需要線條,請問問自己是否可以用第二種色調的形狀來更好地表現它。

相關技能