vt-vl-lab/3d-photo-inpainting
[CVPR 2020] 3D Photography using Context-aware Layered Depth Inpainting
repo name | vt-vl-lab/3d-photo-inpainting |
repo link | https://github.com/vt-vl-lab/3d-photo-inpainting |
homepage | https://shihmengli.github.io/3D-Photo-Inpainting/ |
language | Python |
size (curr.) | 105624 kB |
stars (curr.) | 1874 |
created | 2020-04-08 |
license | Other |
[CVPR 2020] 3D Photography using Context-aware Layered Depth Inpainting
[Paper] [Project Website] [Google Colab]
We propose a method for converting a single RGB-D input image into a 3D photo, i.e., a multi-layer representation for novel view synthesis that contains hallucinated color and depth structures in regions occluded in the original view. We use a Layered Depth Image with explicit pixel connectivity as underlying representation, and present a learning-based inpainting model that iteratively synthesizes new local color-and-depth content into the occluded region in a spatial context-aware manner. The resulting 3D photos can be efficiently rendered with motion parallax using standard graphics engines. We validate the effectiveness of our method on a wide range of challenging everyday scenes and show fewer artifacts when compared with the state-of-the-arts.
3D Photography using Context-aware Layered Depth Inpainting Meng-Li Shih, Shih-Yang Su, Johannes Kopf, and Jia-Bin Huang In IEEE Conference on Computer Vision and Pattern Recognition (CVPR), 2020.
Prerequisites
- Linux (tested on Ubuntu 18.04.4 LTS)
- Anaconda
- Python 3.7 (tested on 3.7.4)
- PyTorch 1.4.0 (tested on 1.4.0 for execution)
and the Python dependencies listed in requirements.txt
- To get started, please run the following commands:
conda create -n 3DP python=3.7 anaconda conda activate 3DP pip install -r requirements.txt conda install pytorch==1.4.0 torchvision==0.5.0 cudatoolkit==10.1.243 -c pytorch
- Next, please download the model weight using the following command:
chmod +x download.sh ./download.sh
Quick start
Please follow the instructions in this section.
This should allow to execute our results.
For more detailed instructions, please refer to DOCUMENTATION.md
.
Execute
- Put
.jpg
files (e.g., test.jpg) into theimage
folder.- E.g.,
image/moon.jpg
- E.g.,
- Run the following command
python main.py --config argument.yml
- Note: The 3D photo generation process usually takes about 2-3 minutes depending on the available computing resources.
- The results are stored in the following directories:
- Corresponding depth map estimated by MiDaS
- E.g.
depth/moon.npy
- E.g.
- Inpainted 3D mesh
- E.g.
mesh/moon.ply
- E.g.
- Rendered videos with zoom-in motion
- E.g.
video/moon_zoom-in.mp4
- E.g.
- Rendered videos with swing motion
- E.g.
video/moon_swing.mp4
- E.g.
- Rendered videos with circle motion
- E.g.
video/moon_circle.mp4
- E.g.
- Corresponding depth map estimated by MiDaS
- (Optional) If you want to change the default configuration. Please read
DOCUMENTATION.md
and modifiedargument.yml
.
License
This work is licensed under MIT License. See LICENSE for details.
If you find our code/models useful, please consider citing our paper:
@inproceedings{Shih3DP20,
author = {Shih, Meng-Li and Su, Shih-Yang and Kopf, Johannes and Huang, Jia-Bin},
title = {3D Photography using Context-aware Layered Depth Inpainting},
booktitle = {IEEE Conference on Computer Vision and Pattern Recognition (CVPR)},
year = {2020}
}
Acknowledgments
- We thank Pratul Srinivasan for providing clarification of the method Srinivasan et al. CVPR 2019.
- We thank the author of Zhou et al. 2018, Choi et al. 2019, Mildenhall et al. 2019, Srinivasan et al. 2019, Wiles et al. 2020, Niklaus et al. 2019 for providing their implementations online.
- Part of our codes are based on EdgeConnect, MiDaS and pytorch-inpainting-with-partial-conv