Spaces:
Running
on
Zero
Running
on
Zero
File size: 5,672 Bytes
5f9d349 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 |
# SIBR Core
**SIBR** is a System for Image-Based Rendering.
It is built around the *sibr-core* in this repo and several *Projects* implementing published research papers.
For more complete documentation, see here: [SIBR Documentation](https://sibr.gitlabpages.inria.fr)
This **SIBR core** repository provides :
- a basic Image-Based Renderer
- a per-pixel implementation of Unstructured Lumigraph (ULR)
- several dataset tools & pipelines do process input images
Details on how to run in the documentation and in the section below.
If you use this code in a publication, please cite the system as follows:
```
@misc{sibr2020,
author = "Bonopera, Sebastien and Esnault, Jerome and Prakash, Siddhant and Rodriguez, Simon and Thonat, Theo and Benadel, Mehdi and Chaurasia, Gaurav and Philip, Julien and Drettakis, George",
title = "sibr: A System for Image Based Rendering",
year = "2020",
url = "https://gitlab.inria.fr/sibr/sibr_core"
}
```
## Setup
**Note**: The current release is for *Windows 10* only. We are planning a Linux release soon.
#### Binary distribution
The easiest way to use SIBR is to download the binary distribution. All steps described below, including all preprocessing for your datasets will work using this code.
Download the distribution from the page: https://sibr.gitlabpages.inria.fr/download.html (Core, 57Mb); unzip the file and rename the directory "install".
#### Install requirements
- [**Visual Studio 2019**](https://visualstudio.microsoft.com/fr/downloads/)
- [**Cmake 3.16+**](https://cmake.org/download)
- [**7zip**](https://www.7-zip.org)
- [**Python 3.8+**](https://www.python.org/downloads/) for shaders installation scripts and dataset preprocess scripts
- [**Doxygen 1.8.17+**](https://www.doxygen.nl/download.html#srcbin) for documentation
- [**CUDA 10.1+**](https://developer.nvidia.com/cuda-downloads) and [**CUDnn**](https://developer.nvidia.com/cudnn) if projects requires it
Make sure Python, CUDA and Doxygen are in the PATH
If you have Chocolatey, you can grab most of these with this command:
```sh
choco install cmake 7zip python3 doxygen.install cuda
## Visual Studio is available on Chocolatey,
## though we do advise to set it from Visual Studio Installer and to choose your licensing accordingly
choco install visualstudio2019community
```
#### Generation of the solution
- Checkout this repository's master branch:
```sh
## through HTTPS
git clone https://gitlab.inria.fr/sibr/sibr_core.git -b master
## through SSH
git clone [email protected]:sibr/sibr_core.git -b master
```
- Run Cmake-gui once, select the repo root as a source directory, `build/` as the build directory. Configure, select the Visual Studio C++ Win64 compiler
- Select the projects you want to generate among the BUILD elements in the list (you can group Cmake flags by categories to access those faster)
- Generate
#### Compilation
- Open the generated Visual Studio solution (`build/sibr_projects.sln`)
- Build the `ALL_BUILD` target, and then the `INSTALL` target
- The compiled executables will be put in `install/bin`
- TODO: are the DLLs properly installed?
#### Compilation of the documentation
- Open the generated Visual Studio solution (`build/sibr_projects.sln`)
- Build the `DOCUMENTATION` target
- Run `install/docs/index.html` in a browser
## Scripts
Some scripts will require you to install `PIL`, and `convert` from `ImageMagick`.
```sh
## To install pillow
python -m pip install pillow
## If you have Chocolatey, you can install imagemagick from this command
choco install imagemagick
```
## Troubleshooting
#### Bugs and Issues
We will track bugs and issues through the Issues interface on gitlab. Inria gitlab does not allow creation of external accounts, so if you have an issue/bug please email <code>[email protected]</code> and we will either create a guest account or create the issue on our side.
#### Cmake complaining about the version
if you are the first to use a very recent Cmake version, you will have to update `CHECKED_VERSION` in the root `CmakeLists.txt`.
#### Weird OpenCV error
you probably selected the 32-bits compiler in Cmake-gui.
#### `Cmd.exe failed with error 009` or similar
make sure Python is installed and in the path.
#### `BUILD_ALL` or `INSTALL` fail because of a project you don't really need
build and install each project separately by selecting the proper targets.
#### Error in CUDA headers under Visual Studio 2019
make sure CUDA >= 10.1 (first version to support VS2019) is installed.
## To run an example
For more details, please see the documentation: http://sibr.gitlabpages.inria.fr
Download a dataset from: https://repo-sam.inria.fr/fungraph/sibr-datasets/
e.g., the *sibr-museum-front* dataset in the *DATASETS_PATH* directory.
```
wget https://repo-sam.inria.fr/fungraph/sibr-datasets/museum_front27_ulr.zip
```
Once you have built the system or downloaded the binaries (see above), go to *install/bin* and you can run:
```
sibr_ulrv2_app.exe --path DATASETS_PATH/sibr-museum-front
```
You will have an interactive viewer and you can navigate freely in the captured scene.
Our default interactive viewer has a main view running the algorithm and a top view to visualize the position of the calibrated cameras. By default you are in WASD mode, and can toggle to trackball using the "y" key. Please see the page [Interface](https://sibr.gitlabpages.inria.fr/docs/nightly/howto_sibr_useful_objects.html) for more details on the interface.
Please see the documentation on how to create a dataset from your own scene, and the various other IBR algorithms available.
|