Community影像github.com

網格繪畫

僅用程式碼繪製寫實或油畫風格的風景、海景和建築,利用 3D 三角形網格、程序化材質、光影以及數百萬筆觸。

網格繪畫 是什麼?

這項技能可讓使用者僅透過 Python 程式碼,就能建立高度寫實或油畫風格的 3D 場景,無需照片或影像生成模型。它會使用一個整合的渲染器,利用程序化幾何、材質、光線追蹤陰影以及大量筆觸來合成影像。支援 Linux(Python 3.10+),工作流程分為作曲、建模、預覽、渲染、繪畫和交付六個階段,每個階段都會產生可檢查的中間產出。這項技能對於需要客製化場景、精確光源控制以及完全程式化管線的開發者或 AI 代理特別有用,且能避免依賴外部影像服務或模型。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dansasser/skills/tree/HEAD/skills/mesh-painting

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

在你喜歡的 AI 中提問

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

說明文件

網格繪畫 是做什麼的?

使用捆綁的渲染器建立要求的場景,並保持其 Python 原始碼可供編輯。檢查預覽、每個渲染圖塊和每個繪畫圖塊。全程使用程序化幾何與顏色。如果無法使用 PNG 檢視或所需的 Linux 執行環境,請在開始前先說明。

執行環境與路徑

使用 Linux、Python 3.10+、NumPy、SciPy、Pillow 以及 util-linux 中的 findmnt。Procfs 必須描述目前的 PID 命名空間;fork、訊號、檔案鎖定和強制地址空間限制必須正常運作。C 編譯器可啟用較快的核心。在建立專案環境之前,請先檢閱設定、安裝與命令。使用一個選定的直譯器來執行 pip、檢查和每個階段。

從已載入的 SKILL.md 中找出此技能目錄,然後解析 scripts/run.py、requirements.txt 以及與該目錄相關的資產。不要假設呼叫端的工作目錄就是已安裝的技能目錄。將環境、可編輯場景和輸出保留在使用者的專案中。在編輯之前,先將適當的捆綁場景複製到該工作區。引用包含空白的路徑。

對於終端機檢視,README 提供了可執行的相對命令。對於已安裝的技能,請使用選定的專案直譯器呼叫已解析的啟動器,並傳遞相對於工作區的場景和輸出路徑。請勿將特定於機器的路徑複製到場景程式碼或共享指示中。

場景模組會以目前使用者的權限執行受信任的 Python。資源監督員並非檔案/網路或惡意程式碼沙箱。請檢閱提供的場景程式碼;在創作的場景中,僅使用宣告的引擎介面、NumPy 和標準函式庫。在使用者現有的授權和環境政策範圍內安裝相依套件。

工作流程

  1. 作曲。 根據簡報的主題、視角和時間。選擇 sunset 可在畫面中產生太陽和背光,或選擇 golden_hour 可產生側光和投射陰影。--sun OFFSET ELEV 指定自訂方向。
  2. 建模。 閱讀場景 API。複製 lighthouse.py 用於海岸、結構和燈塔,或複製 moor.py 用於地被植物和石頭。使用公尺為單位,Z 軸向上。使用 scene_rng(name) 並保持密集區域 ID 在 2 到 127 之間。從可用的網格中為不支援的功能建模,並揭露可見的限制。
  3. 預覽。 執行 --stage preview,開啟 _preview.png,並檢查構圖、比例、光線和曝光。修改並預覽直到場景符合簡報。預覽使用比例 1 且仍然建立所有幾何。
  4. 渲染。 執行 --stage render。開啟 _render.png 和每個原始解析度的圖塊,涵蓋前景和背景。預設的 3 × 2 網格從 _render_tile_r1c1.png 到 _render_tile_r2c3.png。檢查接縫、拉伸的三角形、漂浮/埋藏的物體、斑點、模糊和材質細節。如果切割線會分割主體,請變更圖塊網格,然後檢查新的完整網格。
  5. 繪畫。 在批准最終渲染後,使用完全相同的場景、種子、外觀、太陽、層級和比例執行 --stage paint。此階段會在內部重新渲染。開啟交付的 PNG、_full.png 和每個繪畫圖塊。如果缺陷來自底層渲染,請修正場景並在再次繪畫前重複渲染檢查。
  6. 交付。 提供可編輯的場景、交付的 PNG 和完整畫布。指出完成的階段、實際筆觸數量、經過時間、設定、直譯器/執行環境以及任何可見的弱點。引用使用報告以取得結果和資源數據。說明該影像是由程式碼生成的,沒有使用照片或影像模型。

對於修訂,請使用帶有版本號的名稱保留先前的原始碼和輸出。保持相機、種子和其他設定不變,除非要求的編輯需要它們變更。比較相符的階段並檢閱原始碼差異以找出非預期的變更。在出處很重要時,請單獨記錄場景雜湊和命令:使用報告不會捕捉每個渲染設定。

建模提示

  • 在添加細節肌理前先塑造形體輪廓。為懸崖添加海灣、扶壁和凹口;使用 terrace 和 ridged 創造岩架和裂縫。
  • 分層鋪設寬幅的顏色變化、顆粒、污漬和濕潤帶。將網格步長與可見浮雕相匹配,並使用 g.fade 淡出次像素材質細節。
  • 來自視角約 60–110 度的側光能捕捉山脊。背光能突顯輪廓。
  • 使用常見的門、窗和欄杆來建立比例。門大約 2 公尺高,視線高度的相機大約 1.7 公尺。
  • 使用地形高度函數來放置物體。將粗糙的圖塊放置在精細圖塊下方,以防止相交。

限制與中斷

除非工作需要使用明確選擇的資源設定檔,否則請保持 standard。不要自動增加限制或重試已停止的工作。對於退出碼 3,請回報階段、限制資源、請求/觀察到的使用情況和上限;提出具體的縮減方案,或詢問是否要使用更高的層級。即使影像比例很低,荒原場景也需要標準的幾何容量。限制、報告與復原

在工具逾時允許的情況下在前景執行。使用相同的啟動器、直譯器和 --out 前綴加上 --stop 來停止背景工作;Ctrl+C 也會請求取消。拒絕相同前綴的並行執行。將持久的 .lock 檔案保留在適當位置。

在每個階段之後讀取 _usage.json。將新的輸出與保留的先前影像區分開來;將未完成的標記為 _partial.png。報告可能在啟動後或輸出權限錯誤後不存在。誠實回報失敗或中斷的執行,並保留其證據。Python 核心較慢;使用 README 中有限制的低比例備用方案來驗證它,並揭露其細節減少的情況。

報告

在有用時解釋筆觸運作方式:七遍建構畫布,浮雕將亮度改變最多 7%,顆粒增加紋理,降採樣產生交付影像。描述可見的輸出和測量到的行為,而不是承諾照片級寫實主義或聲稱檢查了未見的圖塊。

場景動機

這項技能旨在讓開發者和 AI 代理能夠僅使用程式碼,透過幾何和程序化材質來創作精細且具風格的景觀影像。它對於需要精確控制影像管線、避免基於神經網路的模型,或希望將場景創作整合到較大軟體專案中的場景特別有用。其工作流程結構鼓勵疊代式開發(預覽 → 渲染 → 繪畫),確保在投入大量運算資源進行最終畫筆繪製之前,能妥善處理構圖和光照。

相關技能