Ray Histogram Fusion
======================================================================
Version 1.3 - November 20, 2015
by Mauricio Delbracio <mdelbra@gmail.com>
Pablo Muse
Antoni Buades
Jean-Michel Morel
Introduction
-----------
RHF is a multi-scale filter that accelerates Monte Carlo renderers.
Each pixel in the image is characterized by the colors of the rays
that reach its surface. The RHF algorithm uses a statistical
distance to compare with each other the ray color distributions
associated with different pixels, at each scale. Based on this
distance, it decides whether two pixels can share their rays or not.
Files
-----
COPYING
Makefile
README.txt
VERSION
exrcrop.cpp
exrdiff.cpp
exrtopng.cpp
io_exr.cpp
io_exr.h
io_png.c
io_png.h
libauxiliar.cpp
libauxiliar.h
libdenoising.cpp
libdenoising.h
rhf.cpp
extras/pbrt-v2-rhf (A modified version of PBRT-v2)
Requirements
------------
- OpenEXR for reading EXR images
Compilation
-----------
Simply use the provided makefile, with the command `make`. You need to set
the directory where the libraries: openEXR have the respective
header and libraries files.
In case OpenMP is available, you can compile with OpenMP
support with the command `make OMP=1`.
Running
-------
Usage: ./rhf [options] <input file> <output file>
Only EXR images are supported.
Options:
-h <hist> The filename with the histogram
-d <float> Max-distance between patchs
-k <int> Minimum number of similar patchs (default: 2)
-b <int> Half the block size (default: 6)
-w <int> Half the windows size (default: 1)
-s <int> Number of Scales - Multi-Scale (default: 2)
A running Example
./rhf toasters_00256.exr -h toasters_00256_hist.exr -d 0.8 toasters_filt.exr
Please report bugs in RHF to <mdelbra@gmail.com>.
Copyright and License
---------------------
RHF - Ray Histogram Fusion
Copyright (c) 2014, A. Buades <toni.buades@uib.es>,
M. Delbracio <mdelbra@gmail.com>,
J-M. Morel <morel@cmla.ens-cachan.fr>,
P. Muse <muse@fing.edu.uy>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.