Fumeng (浮梦)

Fumeng is a hobby project which implements a monte-carlo path tracer from scratch. Fumeng means illusory dream in English.

Features

Camera

Pin-hole camera
Thin-lens camera (with depth of field)

Shape

Sphere
Rectangle
Triangle
OBJ mesh

Material

Light

Directional light
Area light
Image-based light (HDR)

Accelerator

Built-in BVH
Embree BVH (opitional, but highly recommended)

Ray Tracer

Basic monte-carlo path tracer
Bidirectional path tracer

Sampling

Multiple importance sampling

Denoise

OIDN denoise (opitional, but highly recommended)

Post process

Tonemapping

Texture

Image texture
Constant texture
Checkerboard

Scene format

Custom description using json

Build and Run

1. Download source code

git clone --recursive https://github.com/hietwll/Fumeng.git

2. Install third-party libraries

Both Embree and OIDN are optional for Fumeng, but it's strongly recommended to use them. You can just download the pre-built packages from their websites, and extract the packages.

Embree: windows and linux

OIDN: windows and linux

3. Config

cd /path/to/fumeng
cmake -B build -DCMAKE_BUILD_TYPE=Release -DUSE_FLOAT=TRUE -DUSE_EMBREE=TRUE -DUSE_OIDN=TRUE -Dembree_DIR=/path/to/embree/lib/cmake/embree-x.x.x -DOpenImageDenoise_DIR=/path/to/oidn/lib/cmake/OpenImageDenoise-x.x.x

-DUSE_FLOAT: use single precision if TRUE, use double precision if FALSE
-Dembree_DIR: directory of embree cmake config file
-DOpenImageDenoise_DIR: directory of embree cmake config file

4. Build

cmake --build build --parallel 4 --target CMD_EXE

Supported complier:

VS 2017/2019 for windows
gcc and clang for linux

5. Run

cd /path/to/fumeng/scenes
../build/src/cmd/CMD_EXE DamagedHelmet/DamagedHelmet.json

result can be found in the same directory of the scene file.

Scenes

Damaged Helmet:

DoF Camera:

Substance Boy:

Hyperion:

Storm Trooper:

Dining Room:

Classroom: