easy_pbr

KO | EN

gitlite — search

#hacktoberfest #typescript #golang #go #machine-learning #rust #linux #nodejs #java #cli #kubernetes #vue #pytorch #open-source

(★ 99)

Lightweight Physically-Based Renderer designed for ease of use and fast prototyping

easy_pbr Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# EasyPBR

### [Project Page](https://www.ais.uni-bonn.de/videos/GRAPP_2021_Rosu/) | [Video](https://www.youtube.com/watch?v=N20l6dqFcHw) | [Paper](https://www.ais.uni-bonn.de/papers/GRAPP_2021_Rosu_EasyPBR.pdf) | [Poster](https://www.ais.uni-bonn.de/papers/GRAPP_2021_Rosu_EasyPBR_Poster.pdf)

[EasyPBR: A Lightweight Physically-Based Renderer](https://www.ais.uni-bonn.de/videos/GRAPP_2021_Rosu/)
 
 [Radu Alexandru Rosu](https://radualexandru.github.io/) 1,
 [Sven Behnke](https://www.ais.uni-bonn.de/behnke/) 1,
 
 1University of Bonn, Autonomous Intelligent Systems

<img src="imgs/goliath_1_crop.png" width="240"/>
 
 
 
 <img src="imgs/lantern_1_crop.png" width="250" />
 
 
 <img src="imgs/shader_ball_crop.png" width="250" />

EasyPBR is a lightweight Physically-Based Renderer designed for ease of use and fast prototyping. It abstracts away most of the complexity of rendering allowing the user to display high quality images in only a couple of lines of code. By default, EasyPBR tries to choose parameters in order to best render a particular scene but if more control is needed, the whole rendering process is controllable through either a Python script or C++ program. EasyPBR is written in C++ and OpenGL and provides Python bindings to most of it's functionality.

# Usage

An example of a python3 script which shows a single mesh using the default viewing parameters:

try:
        import torch
    except ImportError:
        pass
    from easypbr  import *

config_file="./config/default_params.cfg"

view=Viewer.create(config_file)
    lucy = Mesh("./data/lucy.obj")
    Scene.show(lucy, "lucy")

while True:
        view.update()

Alternatively, one can also start an empty viewer and dragging and dropping meshes on it:

./python/empty.py

One can also define their own mesh by filling up the vertices and faces vector:

view=Viewer.create()   #a viewer with no argument reads by default the parameters from "./config/default_params.cfg"

mesh=Mesh()     #create an empty mesh
    mesh.V=[        #fill up the vertices of the mesh as a matrix of Nx3
        [0,0,0],
        [0,1,0],
        [1,0,0],
        [1.5,1.5,-1]
    ]
    mesh.F=[        #fill up the faces as a Nx3 matrix of integers which point into mesh.V
        [0,2,1],
        [1,2,3]
    ]
    mesh.m_vis.m_show_wireframe=True

Scene.show(mesh,"mesh")
    while True:
        view.update()

An example of using EasyPBR from an external C++ application can be seen in [./examples/example_cpp](./examples/example_cpp)

# Features
- Deferred rendering
- Physically-based shading
- Screen Space Ambient Occlusion (SSAO)
- Shadow Mapping with Percentage Closer Filtering for soft shadows
- Image Based Lighting (IBL) using HDR maps
- Eye Dome Lighting for point cloud rendering
- Separable Subsurface Scattering for realistic skin shading
- Various tonemapping operators (Rheinhard, Unreal, ACES)
- Shader hotloading
- Various modes of visualization (mesh, wireframe, point cloud, surfel)
- Loading of multiple meshes formats (.obj, .ply, .pcd, .off)
- Drag and drop of meshes and HDR maps directly in the viewer
- Easy extension and usage from other packages

# Install
### Dependencies:
```sh
$ sudo apt-get install python3-pip python3-setuptools python3-numpy libglfw3-dev libboost-all-dev libeigen3-dev libpcl-dev libopencv-dev
```
### Optional dependencies: 
Allow for shader hotloading, so changes to .glsl files are automatically recompiled and used while the program is running:
```sh
$ sudo apt-get install libkqueue-dev
```

### Build and install:
```sh
$ git clone --recursive https://github.com/RaduAlexandru/easy_pbr.git
$ cd easy_pbr
$ make
```

### Troubleshoot:
If the GUI is too small or to big, enable the hidpi: true in the corresponding config file from easy_pbr/config.

The error libGL error: No matching fbConfigs or visuals found can be fixed with: export LIBGL_ALWAYS_INDIRECT=1

# Examples

Various examples can be found in the ./examples folder. A short description of each one is given here. The various effects are achived through a combination of different .cfg file configurations and different setting established in the python file.

| Name | Description |
| ------------- | ------------- |
| Deferred Physically based rendering | ![PBR demo preview](https://raw.githubusercontent.com/RaduAlexandru/easy_pbr/master/imgs/pbr_multiscatter.jpg) Real-time rendering of a scene with 'physically-based' materials (GGX BRDF introduced in *Microfacet Models for Refraction through Rough Surfaces*, Walter et al., 2007), using deferred rendering and an HDR pipeline with bloom and SSAO. Run with [./examples/pbr.py](./examples/pbr.py) |
| Subsurface Scattering | ![Subsurface Scattering](https://raw.githubusercontent.com/RaduAlexandru/easy_pbr/master/imgs/head_sss_full2_crop.png) Subsurface Scattering for skin rendering. Run with [./examples/subsurface_scattering.py](./examples/subsurface_scattering.py) Download head model from [here](https://www.3dscanstore.com/blog/Free-3D-Head-Model) |
| Shadows and Ambient Occlusion | ![Shadows and Ambient Occlusion](https://raw.githubusercontent.com/RaduAlexandru/easy_pbr/master/imgs/shadows2.jpg) Run with [./examples/shadows.py](./examples/shadows.py) |
| Bloom | ![Bloom](https://raw.githubusercontent.com/RaduAlexandru/easy_pbr/master/imgs/bloom_head.jpg) Run with [./examples/bloom.py](./examples/bloom.py) |
| Cloud render | ![Cloud render](https://raw.githubusercontent.com/RaduAlexandru/easy_pbr/master/imgs/cloud_medusa.jpeg) Eye-dome lighting and SSAO for shading |

## Citation

```
@inproceedings{rosu2021easypbr,
  title={EasyPBR: A Lightweight Physically-Based Renderer},
  author={Rosu, Radu Alexandru and Behnke, Sven},
  booktitle={Proc. of 16th International Conference on Computer Graphics Theory and Applications (GRAPP)},
  year={2021}
}
```

# License
EasyPBR is provided under the terms of the MIT license (see LICENSE). We bundle various other libraries (see ./deps) which may have different licenses.

easy_pbr

easy_pbr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

easy_pbr

easy_pbr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README