Community图像github.com

网格绘画

仅用代码绘制逼真或富有绘画感的风景、海景和建筑,使用三维三角网格、程序化材质、光照、阴影和数百万笔触。当用户要求使用网格绘画、通过网格和笔触渲染场景、或制作不使用照片或图像生成模型的真实场景时使用。排除标志、图标、图表、示意图、文本占位符、照片编辑、视频以及图像生成服务请求。

网格绘画 是什么?

Mesh Painting 技能允许开发者或 AI 代理仅通过代码和数学程序化生成逼真的风景、海景和建筑图像。它通过定义三维三角网格、程序化材质、光照和阴影来构建场景,并应用数百万笔触以创建最终图像。该技能基于一个可编辑的 Python 渲染器,支持 Linux 环境(Python 3.10+、NumPy、SciPy、Pillow)。工作流程包括构图、建模、预览、渲染、绘画和交付六个阶段。它能处理日落、黄金时刻等光照条件,并提供场景 API 和示例场景(如 lighthouse.py 和 moor.py)作为起点。此技能在需要完全代码驱动、不使用任何照片或图像生成模型的图像生成场景中尤为有用。

兼容平台✓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%,颗粒增加纹理,下采样创建交付图像。描述可见输出和测量行为,而不是承诺照片级真实感或声称检查了未见过的瓦片。

相关技能