ChurchX

ChurchX is a Computer Graphics Course Project for rendering a real-life church scene based on progressive photon mapping with scatter participating medium. We focus on rendering the light beam in the church, which is one of the most impressive characteristic of a church. Here we utilize NVIDIA's OptiX ray tracing engine.

And God said, Let there be light: and there was light.

And God saw the light, and it was good; and God divided the light from the darkness.

Building Instructions

System Requirements (for running binaries referencing OptiX)

Graphics Hardware:

CUDA capable devices of Compute Capability 2.0 (“Fermi”) or higher are supported on GeForce, Quadro, or Tesla class NVIDIA products. Out-of-core ray tracing of large datasets exceeding GPU memory (AKA paging) is not supported on GeForce “GT” class GPUs.

Graphics Driver:

The CUDA R346 or later driver is required. For the Mac, the driver extension module supplied with CUDA 7.5 will need to be installed.

Operating System:

Windows 7/8/8.1/10 64-bit; Linux RHEL 4.8+ or Ubuntu 10.10+ - 64-bit; MacOS 10.9+

Development Environment Requirements (for compiling with OptiX)

CUDA Toolkit 4.0 – 7.5:

OptiX 3.9 has been built with CUDA 7.5, but any specified toolkit should work when compiling PTX for OptiX. If an application links against both the OptiX library and the CUDA runtime on Linux, it is recommended to use the same version of CUDA that was used to build OptiX.

C/C++ Compiler:

Visual Studio 2008, 2010, 2012, or 2013 is required on Windows systems. gcc 4.4-4.8 have been tested on Linux. Xcode 6 has been tested on Mac OSX 10.9. See the CUDA Toolkit documentation for more information on supported compilers.

GLUT:

Most OptiX samples use the GLUT toolkit. Freeglut ships with the Windows OptiX distribution. GLUT is installed by default on Mac OSX. A GLUT installation is required to build samples on Linux.

Building Tutorial for Windows

1. Move the ChurchX folder under the directory where you installed the OptiX. For example F:\NVIDIA Corporation\OptiX SDK 3.9.0\ChurchX
2. Start up cmake-gui from the Start Menu.
3. Select the ..\NVIDIA Corporation\OptiX SDK 3.9.0\ChurchX directory
4. Create a build directory that isn't the same as the source directory. For example, ..\NVIDIA Corporation\OptiX SDK 3.9.0\ChurchX\build
5. Press "Configure" button and select the version of Visual Studio you wish to use. Note that the 64-bit compiles are separate from the 32-bit compiles(e.g. look for "Visual Studio 12 2013 Win64"). Leave all other options on their default. Press "OK".
6. Press "Configure" again. Followed by "Generate".
7. Open the OptiX-Samples.sln solution file in the build directory you created.
8. Select "Build Solution" from the IDE.
9. Set progressivePhotonMap as the Startup Project
10. Run

Building Tutorial for Linux/MacOS

1. cd into the main folder and "makedir build"
2. cd ./build
3. cmake ../
4. make Note: configure the OptiX, OptiX_primary include directory and library directory in the cmake cache if necessary.

Running Instructions

How to Tweak the Scene

1. Add command line parameter --game-cam to move the camera with Up, Down, Left, Right, PageUp and PageDown.(recommended) The following codes can be found at ChurchX/pogressivePhotonMap/ppm.cpp line 53:

static const bool golden = true;
static const bool sideWall = false;
static const bool frontLightSkew = false;
static const bool loadAllWindows = true;

2. 2 default colors of light are available : set golden true to use golden light, false to use blue one.
3. 2 light position are available : set sideWall true to make the light beam coming from the side window, false to make the light beam coming from the front side of the church.
4. When sideWall is set to be false, use frontLightSkew to make the light skew.
5. If sideWall is set to be true, make sure loadAllWindows is set to be false.
6. If sideWall is set to be false, setting loadAllWindows to be true will make the beam more colorful visually.

Demo

Left Side Blue Light Left Side Golden Light Front side skew golden light without colorful glass Front side golden light with colorful glass(set loadAllWindows true)