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: about 11 hours 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 (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-04-07T14:28:40.000Z (almost 2 years ago)
• Last Synced: 2025-01-08T04:17:18.980Z (15 days ago)
• Topics: blender, blender-addon, generator, heightmap, machine-learning, ml, normalmap
• Language: Python
• Homepage: https://hugotini.github.io/deepbump
• Size: 23.3 MB
• Stars: 1,109
• Watchers: 29
• Forks: 41
• Open Issues: 24
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![DeepBump](banner.jpg)

# 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 -> Install_ 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 use available APIs to disable telemetry.

# Usage

Check the [blog post](https://hugotini.github.io/deepbump) first video.

In the Shader Editor, in the right panel under the _DeepBump_ tab:

**Color (albedo) → Normals** : Select a color image node and click _Generate Normal Map_.

**Normals → Height (displacement)** : Select the generated normal map image node and click _Generate Height Map_.

**Normals → Curvature** : Select the generated normal map image node and click _Generate Curvature Map_.

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.