/texturefusion

[CVPR2020] TextureFusion: High-Quality Texture Acquisition for Real-Time RGB-D Scanning

Primary LanguageC++OtherNOASSERTION

TextureFusion: High-Quality Texture Acquisition for Real-Time RGB-D Scanning

Writers: Joo Ho Lee (jhlee@vclab.kaist.ac.kr), Hyunho Ha (hhha@vclab.kaist.ac.kr), Min H. Kim (minhkim@kaist.ac.kr)

Institute: KAIST Visual Computing Laboratory

If you use our code for your academic work, please cite our paper:

@InProceedings{Lee_2020_CVPR, author = {Joo Ho Lee and Hyunho Ha and Yue Dong and Xin Tong and Min H. Kim}, title = {TextureFusion: High-Quality Texture Acquisition for Real-Time RGB-D Scanning}, booktitle = {The IEEE Conference on Computer Vision and Pattern Recognition (CVPR)}, month = {June}, year = {2020} }

Installation

Our implementation is based on the voxel hashing repository (https://github.com/niessner/VoxelHashing). Please follow the instruction to compile the voxel hashing repository. After compiling the voxel hashing repository, replace the 'Source' folder with the 'Source' folder of our implementation. Then, add all codes in the project and run our code. The main function is in 'texture_main.cpp'.

Data

We provide the "fountain" dataset (originally created by Zhou and Koltun) compatible with our implementation (link: http://vclab.kaist.ac.kr/cvpr2020p1/fountain_all.zip).

Usage

Our program reads parameters from three files and you can change the program setting by changing them.

  • zParametersDefault.txt

  • zParametersTrackingDefault.txt

  • zParametersWarpingDefault.txt

You can run our program with the provided fountain dataset.

Please set s_sensorIdx as 9 and s_binaryDumpSensorFile[0] as the fountain folder in zParametersDefault.txt.

License

Joo Ho Lee, Hyunho Ha and Min H. Kim have developed this software and related documentation (the "Software"); confidential use in source form of the Software, without modification, is permitted provided that the following conditions are met:

Neither the name of the copyright holder nor the names of any contributors may be used to endorse or promote products derived from the Software without specific prior written permission.

The use of the software is for Non-Commercial Purposes only. As used in this Agreement, "Non-Commercial Purpose" means for the purpose of education or research in a non-commercial organisation only. "Non-Commercial Purpose" excludes, without limitation, any use of the Software for, as part of, or in any way in connection with a product (including software) or service which is sold, offered for sale, licensed, leased, published, loaned or rented. If you require a license for a use excluded by this agreement, please email [minhkim@kaist.ac.kr].

Warranty: KAIST-VCLAB MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. KAIST-VCLAB SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.

NB Our implementation is covered under the license of "Voxel Hashing" codes (CC BY-NC-SA 3.0).

Please refer to license.txt for more details.

Contact

If you have any questions, please feel free to contact us.

Joo Ho Lee (jhlee@vclab.kaist.ac.kr)

Hyun Ho Ha (hhha@vclab.kaist.ac.kr)

Min H. Kim (minhkim@vclab.kaist.ac.kr)