DeepBump

DeepBump 是一款基于机器学习的工具，可以从单张图片生成法线贴图和高度贴图。有关介绍，请参阅这篇 博客文章。

安装

1. 下载 DeepBump 的 ZIP 文件。

2. 在 Blender 中，前往 编辑 -> 首选项 -> 插件 -> 右上角箭头 -> 从磁盘安装，然后选择下载的 ZIP 文件并启用插件。

3. 在插件的首选项中，点击 '安装依赖项' 按钮（此操作需要互联网连接，可能需要一些时间）。如果出现错误，请尝试以管理员身份运行 Blender 来完成此步骤。

请注意，在安装这些依赖项时，需遵守 Microsoft 的相关条款。该插件使用现有 API 来禁用遥测功能。

使用方法

请先观看 博客文章 中的第一段视频。

在 着色器编辑器 中，在侧边栏的 DeepBump 选项卡 下：

工具

颜色（反照率）→ 法线

在着色器编辑器中选择一个颜色图像节点，然后点击 生成法线贴图。

法线 → 高度（位移）

在着色器编辑器中选择已生成的法线贴图图像节点，然后点击 生成高度贴图。

法线 → 曲率

在着色器编辑器中选择已生成的法线贴图图像节点，然后点击 生成曲率贴图。

低分辨率 → 高分辨率（超采样）

在着色器编辑器中选择一个颜色图像节点，然后点击 超采样。

命令行

有关命令行用法，请参阅 cli.md。

许可证

本仓库采用 GPL 许可证。目前训练代码尚未公开。

DeepBump 快速上手指南

DeepBump 是一款基于机器学习的 Blender 插件，能够从单张图片生成法线贴图（Normal Map）、高度贴图（Height Map）、曲率贴图以及进行图像超分辨率放大。

环境准备

• 操作系统：Windows / macOS / Linux
• 核心软件：Blender（建议使用最新稳定版）
• 网络要求：安装依赖时需要联网（用于下载 ONNX Runtime 等模型库）
  • 注意：国内用户若在安装依赖时遇到连接超时，请确保网络通畅或配置合适的代理环境。
• 权限要求：首次安装依赖时，如遇权限错误，请以管理员身份运行 Blender。

安装步骤

1. 下载插件 访问 DeepBump Releases 页面，下载最新的 .zip 格式安装包。

2. 导入 Blender 打开 Blender，依次点击菜单栏： Edit -> Preferences -> Add-ons -> 点击右上角的箭头图标 (Install from disk) -> 选择刚才下载的 ZIP 文件。

3. 启用插件 在插件列表中找到 DeepBump 并勾选以启用它。

4. 安装依赖（关键步骤）

   • 在插件偏好设置面板中，点击 Install dependencies 按钮。
   • 此过程会自动下载必要的机器学习库，耗时取决于网络速度。
   • 提示：若点击后无反应或报错，请关闭 Blender，右键选择“以管理员身份运行”Blender，重复上述步骤。
   • 隐私说明：该插件已禁用遥测功能，符合微软相关许可条件。

基本使用

安装完成后，无需编写代码，直接在 Blender 界面中操作：

1. 打开面板 进入 Shader Editor（着色器编辑器），在右侧边栏找到 DeepBump 标签页。

2. 生成法线贴图 (Color → Normals)

   • 在节点编辑器中选中一张颜色贴图节点（Image Texture）。
   • 在 DeepBump 面板点击 Generate Normal Map。
   • 插件将自动生成并连接对应的法线贴图节点。

3. 生成高度贴图 (Normals → Height)

   • 选中已生成的法线贴图节点。
   • 点击 Generate Height Map。

4. 其他功能

   • 生成曲率贴图：选中法线贴图节点，点击 Generate Curvature Map。
   • 图像超分放大：选中低分辨率颜色贴图节点，点击 Upscale 即可提升分辨率。

提示：更多详细演示视频和原理介绍，可参考作者的 官方博客。