A high performance voxel engine.
First, clone the repo and its submodules:
git clone https://github.com/RArbore/illinois-voxel-sandbox.git --recursive
Then, build the project:
mkdir build
cd build
cmake ..
make -j
Then, download the models:
cd ../experiments
./experiment.sh download
Then, convert a model:
cd ../build
drivers/convert_model ../experiments/obj/buddha/buddha.obj 1 "SVDAG(9)"
Then, view the converted model:
drivers/model_viewer ../experiments/obj/buddha/buddha.svdag_9 "SVDAG(9)"
Run the following commands, in order if starting from scratch. The beginning of each line is the directory to run each command from.
build/: make -jexperiments/: ./experiment.sh downloadexperiments/: ./experiment.sh compilebuild/: make -jexperiments/: ./experiment.sh convertexperiments/: ./experiment.sh run
- Build the entire project (
make -j) - Run
drivers/compiler "[format]".[format], in between the quotes, should be a space-separated list of formats, listed below:
Raw(W, H, D):W,H, andDare the width, height, and depth of the raw gridDF(W, H, D, M):W,H, andDare the width, height, and depth of the distance field,Mis the maximum distance stored (construction time scales cubically withM)SVO(L):Lis the maximum number of levels in the SVO - the dimensions of the subvolume are 2^Lx 2^Lx 2^LSVDAG(L):Lis the maximum number of levels in the SVDAG - the dimensions of the subvolume are 2^Lx 2^Lx 2^L
- Step 2 will produce two files:
[format]_construct.cppand[format]_intersect.glsl, where[format]is the lower-case and underscored version of the format described in step 2 - add these files tovoxels/CMakeLists.txtandshaders/CMakeLists.txt, respectively - copy these files into thevoxels/andshaders/folders, respectively - Build the entire project again (
make -j) - Edit
drivers/convert_model.cpp- add a prototype for the constructing function at the top of the file, with the lower-case and underscored format name from step 3 - add that function as a value in theformat_to_conversion_functionunordered_map, with the format name from step 2 as the key - Run
drivers/convert_model [path to obj] 0.0 "[format]", where[path to obj]is a path to the obj model to voxelize, and[format]is the same format used in step 2 - Run
drivers/model_viewer [path to voxelized model] "[format]", where[path to voxelized model]is the path to the voxelized model produced in step 6, and[format]is the same format used in step 2