ArmorPaint 教程：给 3D 模型"刷"上真实材质

📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：4.7k+

📋 项目简介

ArmorPaint（4.7k 星，单日 +354，armorpaint.org）是一款专注 3D 纹理绘画的开源软件：拖入 3D 模型，用笔刷直接在模型表面绘制 PBR 材质——颜色、粗糙度、金属度、法线、高度等通道所见即所得，软件实时烘焙贴图。相比在 2D 贴图上"盲画"，它让材质制作回到模型本身。想给 Blender 工作流自动配材质，可以先读 Camera-to-Blender教程：拍张照片就能把实物搬进Blender。

✨ 核心特性

特性	说明
3D 表面直绘	笔刷落在模型上而非贴图上，绕开 UV 展开的心理负担
PBR 通道绘画	基色/粗糙度/金属度/法线/高度/自发光等通道独立绘制
实时烘焙	绘制即时烘焙到贴图，配合智能材质、遮罩、粒子笔刷
格式兼容	输出贴图直接用于 Blender、Unity、Unreal Engine 等
全平台	Windows/macOS/Linux 桌面版，还能编译 Android、iOS、WASM 网页版
开源可编译	源码开放，本教程重点讲自编译路线

🏗️ 工作原理

3D 模型（.obj/.fbx/.gltf…）
   │  拖入 ArmorPaint
   ▼
模型表面 ──笔刷──→ 各 PBR 通道（基色/粗糙度/金属度/法线/高度）
   │                 （智能材质 · 遮罩 · 粒子笔刷）
   ▼
GPU 实时烘焙（2D/3D 视口同步预览）
   │
   ▼
贴图输出（导出到 Blender / Unity / Unreal…）

🚀 安装与编译

ArmorPaint 走的是"资助式"分发：官方预编译二进制收费，源码开放自编译免费。两条路线：

• 路线A 官网购买：armorpaint.org 下载现成二进制，省心且有更新支持。
• 路线B 源码编译（本教程重点）：

# 0. 前置依赖（按平台）
#   Windows: Visual Studio（含 clang 组件）
#   macOS / iOS: Xcode
#   Linux: clang + 相关系统依赖
#   Android: Android Studio

# 1. 克隆仓库
git clone https://github.com/armory3d/armorpaint.git
cd armorpaint/paint

# 2. 编译并直接运行
../base/make --run

# 3. 其他目标
../base/make --target android --compile   # Android
../base/make --target ios --compile       # iOS
../base/make --target wasm --compile --embed   # 网页版 WASM

# 提示：C23 #embed 特性需 clang 19+

官方手册见 armorpaint.org/manual，覆盖笔刷、节点材质、烘焙参数等完整用法。

💡 使用建议

• 先官网手册再上手：官方 manual 系统性极强，从笔刷参数到烘焙设置一站式查。
• 模型先摆好 UV：虽然直绘省心，但烘焙质量取决于 UV 展开质量，重叠 UV 会花脸。
• 通道分着画：先基色定大调，再粗糙度做质感变化，金属度只在真金属区域提亮，材质会更耐看。
• 配套素材工作流：照片建模进 Blender 可以看 Camera-to-Blender教程：拍张照片就能把实物搬进Blender，出模型后正好用 ArmorPaint 上材质；设计卡片类内容则见 Holo Card Studio教程：一句话生成可编辑的精美卡片设计。
• 编译遇到问题看平台依赖：Windows 报 clang 缺失通常是 VS 安装时未勾选 C++ clang 工具集。