https://github.com/hugotini/deepbump
Normal & height maps generation from single pictures
https://github.com/hugotini/deepbump
blender blender-addon generator heightmap machine-learning ml normalmap
Last synced: 12 days ago
JSON representation
Normal & height maps generation from single pictures
- Host: GitHub
- URL: https://github.com/hugotini/deepbump
- Owner: HugoTini
- License: gpl-3.0
- Created: 2020-05-17T00:11:57.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-03-17T14:37:47.000Z (about 1 month ago)
- Last Synced: 2025-04-03T22:05:42.685Z (19 days ago)
- Topics: blender, blender-addon, generator, heightmap, machine-learning, ml, normalmap
- Language: Python
- Homepage: https://hugotini.github.io/deepbump
- Size: 38.7 MB
- Stars: 1,179
- Watchers: 31
- Forks: 45
- Open Issues: 18
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# DeepBump
DeepBump is a machine-learning driven tool to generate normal & height maps from single pictures. See this [blog post](https://hugotini.github.io/deepbump) for an introduction.
# Installation
1) [Download DeepBump as a ZIP](https://github.com/HugoTini/DeepBump/releases).
2) In Blender, go to **_Edit -> Preferences -> Add-ons -> Top right arrow -> Install from disk_** and select the downloaded ZIP file. Then enable the add-on.
3) In the add-on preference, click the **'_Install dependencies_'** button (this requires an internet connection and might take a while). In case of error, try running Blender as administrator for this step.
By installing those dependencies, be aware of [Microsoft conditions](https://github.com/microsoft/onnxruntime/blob/master/docs/Privacy.md). This add-on uses available APIs to disable telemetry.
# Usage
Check the [blog post](https://hugotini.github.io/deepbump) first video.
In the **_Shader Editor_**, in the side bar under the **_DeepBump tab_**:
# Tools
## Color (albedo) → Normals
Select a color image node in the shader editor, then click _Generate Normal Map_.
## Normals → Height (displacement)
Select the generated normal map image node in the shader editor, then click _Generate Height Map_.
## Normals → Curvature
Select the generated normal map image node in the shader editor, then click _Generate Curvature Map_.
## Low res -> High res (upscale)
Select a color image node in the shader editor, then click _Upscale_.
# Command line
For command-line usage, see [cli.md](cli.md).
# License
This repo is under the [GPL license](LICENSE). The training code is currently not available.