PolyHaven Material Swap 是一个面向 Blender 的材质变体渲染工具，来源于 kevinbadi/blender-skills 技能集。它的核心用途是：将多个 PolyHaven PBR 纹理依次应用到同一个 Blender 物体上，并对每个材质变体分别渲染输出图像，从而直观地展示同一产品在不同颜色或表面处理下的外观，例如哑光黑、亮白、拉丝金属、大理石等。
主要能力
- 遍历多个 PolyHaven 材质：通过 --textures 参数传入逗号分隔的 PolyHaven 纹理 ID，脚本会逐个应用并渲染。
- 预设材质集：通过 --preset 参数可一次使用一组预定义纹理，内置 metals、woods、stones、fabrics 四个预设。
- 输出多张渲染图：通过 --output 指定输出目录，每个材质变体对应一张渲染图。
- 渲染参数可调：支持设置纹理分辨率（1k、2k，默认 2k）、渲染图像宽度（默认 1920）、高度（默认 1080）、采样数（默认 64），以及 Blender MCP 端口（默认 9876）。
使用方式
以命令行的方式运行脚本，需要指定目标 Blender 物体、材质来源（纹理 ID 或预设）以及输出目录。示例命令：
node polyhaven-material-swap/scripts/polyhaven-material-swap.js --object Mesh_0 --textures "marble_01,brushed_metal,carbon_fiber" --output ~/Desktop/variants node polyhaven-material-swap/scripts/polyhaven-material-swap.js --object Mesh_0 --preset metals --output ~/Desktop/metals
参数说明
- --object：Blender 物体名称，必填。
- --textures：逗号分隔的 PolyHaven 纹理 ID，与 --preset 二选一必填。
- --output：渲染图像的输出目录，必填。
- --preset：纹理集，可选 metals、woods、stones、fabrics，默认无。
- --resolution：纹理分辨率，可选 1k、2k，默认 2k。
- --render-width：渲染图像宽度，默认 1920。
- --render-height：渲染图像高度，默认 1080。
- --samples：渲染采样数，默认 64。
- --port：Blender MCP 端口，默认 9876。
预设内容
- metals：brushed_metal, rusty_metal, painted_metal_02, corrugated_iron
- woods：wood_cabinet_worn_long, plywood, bark_brown_02, wood_floor
- stones：marble_01, concrete_wall_003, rock_face, gravel_floor_02
- fabrics：fabric_pattern_07, leather_red_02, denim_fabric, burlap_01
适用场景
适合产品渲染中快速对比不同材质与表面处理效果，例如为同一件产品生成多种颜色或工艺选项的预览图，或在进行材质选型时批量输出对比图。
限制
脚本依赖 Blender MCP 连接，需保证 Blender 环境与端口可用；具体支持版本、系统要求、安装步骤等资料暂未提供。