https://github.com/unclearness/vacancy
Vacancy: A Voxel Carving implementation in C++
https://github.com/unclearness/vacancy
3d-reconstruction c-plus-plus computer-vision marching-cubes shape-from-silhouette
Last synced: about 1 month ago
JSON representation
Vacancy: A Voxel Carving implementation in C++
- Host: GitHub
- URL: https://github.com/unclearness/vacancy
- Owner: unclearness
- License: bsd-3-clause
- Created: 2019-04-07T13:20:01.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-12-01T13:28:27.000Z (over 3 years ago)
- Last Synced: 2024-11-14T22:35:36.720Z (7 months ago)
- Topics: 3d-reconstruction, c-plus-plus, computer-vision, marching-cubes, shape-from-silhouette
- Language: C++
- Size: 413 KB
- Stars: 65
- Watchers: 2
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeCppGameDev - vacancy
README
# Vacancy: A Voxel Carving implementation in C++
**Vacancy** is a *Voxel Carving* (a.k.a. *Visual Hull* or *Shape from Silhouette*) implementaion in C++. Inputs are 2D silhouettes (binary mask) of target objects, corresponding camera parameters (both intrinsic and extrinsic) and 3D bounding box to roughly specify the position of the objects. Output is the reconstructed 3D model. In addition to naive one, supports KinectFusion like robust TSDF (Truncated Signed Distance Function) fusion.
# Algorithm Overview
- Initialize 3D voxels according to the input bounding box
- Compute SDF (Signed Distance Function/Field) from silhouette in 2D
- Volmetrically fuse 2D SDF values into the 3D voxels by using camera parameters
- Extract explicit 3D mesh from implicit surface representation in the 3D voxels
# Output mesh
Two mesh extraction methods are implemented: voxel and marching cubes. Marching cubes are much better in practice while voxel representation is suitable to understand how the algorithm works.
|voxel|marching cubes|
|---|---|
|
|
|
# Build
To build sample bunny executable, use cmake with `CMakeLists.txt` in the top directory.
You can integrate **Vacancy** to your own projects as static library by cmake `add_subdirectory()` command.
# Dependencies
## Mandatory
- Eigen
https://github.com/eigenteam/eigen-git-mirror
- Math
## Optional (can be disabled by cmake)
- stb
https://github.com/nothings/stb
- Image I/O
- OpenMP (if supported by your compiler)
- Multi-thread accelaration