DepthLight

Raphaël Manus^{1, 2} · Marc Christie¹ · Samuel Boivin¹ · Pascal Guehl²

¹Inria, IRISA, CNRS, Univ. Rennes  ²LIX, Ecole Polytechnique, IP Paris

Installation

Update depthlight.yml with correct CUDA version for PyTorch if needed.

git clone --recurse-submodules https://github.com/RaphaelManus/DepthLight
cd DepthLight

conda env create -f depthlight.yml
conda env create -f LANet.yml

conda activate LANet
pip install numpy --upgrade

conda activate depthlight

Usage

We encourage users to structure their data directories in the following way:

- data
    '- input
    |   - img1.jpg
    |   - img2.png
    |   - ...
    '- ldr_pano
    |   - ...
    '- hdr_pano
    |   - ...
    '- usd
    |   - ...

Running the script

python run.py \
  --input <path>
  --type <ldr_lfov | ldr_pano | hdr_pano> \
  --output <path> \
  --fov <fov> \
  --prompt <"optional prompt">

Options:

• --input or -i: Point it to an image directory storing all interested images
• --type or -t (optional): By default, expected input type is LDR LFOV images.
• --output or -o (optional): You can point it to a different directory than the input if needed.
• --fov or -f (optional): Specify the fov of the inputs, default is 90.0°.
• --prompt or -p (optional): Specify a prompt to guide the generation, default is "indoor".

For example:

python run.py -i ./data/input -t ldr_lfov -f 90 -p "indoor"

Unreal Engine integration

See the unreal engine folder.

Citation

If you find this project useful, please consider citing:

@article{manus2025depthlight,
  title={DepthLight: a Single Image Lighting Pipeline for Seamless Integration of Virtual Objects into Real Scenes},
  author={Manus, Raphael and Christie, Marc and Boivin, Samuel and Guehl, Pascal},
  year={2025},
  publisher={The Eurographics Association}
}