chenxizhou0619/mitsuba

Personal Compilable Version of the Mitsuba Renderer

About

Fork from https://github.com/MC-K1nG/mitsuba

Note

Only Linux system is currently supported. On Windows or Mac OS, you may use the WSL subsystem or Docker container. In general, running within a Docker container is much more recommended. WSL can have some compatability issues.

We have tested on Ubuntu 20.04 and 22.04. Other distributions equivalently new may also work well (e.g. Kali Linux 2022). However, older versions of Linux (e.g. Ubuntu 18.04) will take you lots of time to modify the dependencies and even CMake scripts.

How to Compile

# Install utilities
sudo apt install git cmake ninja-build clang gdb

# Install dependencies
sudo apt install libxerces-c-dev libboost-all-dev libeigen3-dev libomp-dev libopengl-dev libglewmx-dev libxxf86vm-dev libpng-dev libjpeg-dev libopenexr-dev libcollada-dom-dev libfftw3-dev qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools libqt5xmlpatterns5-dev python3 libpython3-all-dev

# Clone the repository
git clone https://github.com/yysun997/mitsuba.git

# Configure and compile (Configure warning should not happen, but compile warning is fine.)
mkdir ./mitsuba/build/release
cd ./mitsuba/build/release
cmake -G Ninja -DCMAKE_CXX_COMPILER=clang -DCMAKE_C_COMPILER=clang -DCMAKE_BUILD_TYPE=Release ../..
ninja

# Take your python version
ls

# The command-line
# ./mitsuba -h

# The GUI
# ./mtsgui

# The python bindings
# python3
# >>> import sys
# >>> sys.path.insert(0, "./python${Python_VERSION}")
# >>> import mitsuba
# >>> from mitsuba.core import *
# >>> vec = Vector(1, 2, 3)
# >>> normalize(vec)

# See official documentation for more details
# https://www.mitsuba-renderer.org/releases/current/documentation.pdf