Skip to content

cmu-ci-lab/MitsubaToFRenderer

Repository files navigation

MitsubaToFRenderer

Mitsuba renderer with support for time-of-flight rendering.

We recommend using docker: adithyapedireda/mitsubatofrenderer that has preinstalled MitsubaToFRenderer and exr2mat.py and is tested on windows, mac and ubuntu20.04

For native installation, see INSTALL.txt for installation in ubuntu16.04 and INSTALL_20.04.txt for ubuntu20.04. Please check USAGE.txt for running the MitsubaToFRenderer with various settings. See INSTALLEXR2AVI.txt to install exr2avi scripts and view/save the exr output of the MitsubaToFRenderer as an image or video or process in MATLAB.

project page:

http://imaging.cs.cmu.edu/ellipsoidal_connections/

credits:

The project is derived from https://www.mitsuba-renderer.org/ and https://github.com/cmu-ci-lab/mitsuba_clt.git (for coded projector and coded camera extension). On top of these, the ToF renderer and ellipsoidal connections for time-gated rendering are added.

license:

As the project is derived from mitsuba-renderer, the same license is applicable here. Quoting verbatim from original mitsuba:

It is free software and can be redistributed and modified under the terms of the GNU General Public License (Version 3) (https://www.gnu.org/licenses/gpl-3.0.html) as provided by the Free Software Foundation.

Remark: Being a "viral" license, the GPL automatically applies to all derivative work. Amongst other things, this means that without express permission, Mitsuba's source code is off-limits to those who develop rendering software not distributed under a compatible license.

more info:

The scene file can be created by using the mitsuba documentation (https://www.mitsuba-renderer.org/releases/current/documentation.pdf) Please refer to https://github.com/cmu-ci-lab/mitsuba_clt/blob/master/README.md for creating scenes with coded projector and coded camera.

If you have used the renderer, please cite

@article{pediredla2019ellipsoidal,
title={Ellipsoidal path connections for time-gated rendering},
author={Pediredla, Adithya and Veeraraghavan, Ashok and Gkioulekas, Ioannis},
journal={ACM Transactions on Graphics (TOG)},
volume={38},
number={4},
pages={1--12},
year={2019},
publisher={ACM New York, NY, USA}
}