Skip to content

Repository files navigation

DirectLStudio teaser

High-Performance 3DGS Studio for Light Field Displays

Based on DirectL: Efficient Radiance Fields Rendering for 3D Light Field Displays

ACM DOI arXiv Project page

SIGGRAPH Asia 2024 (ACM TOG)

Release workflow Latest release AGPL-3.0-only Windows 11 NVIDIA RTX

⚡ DirectLStudio brings most trained 3D Gaussian Splatting scenes to your light-field display in real time with visually lossless light-field rendering.

🔭 Its calibration-driven rendering model is theoretically compatible with any lenticular light-field display whose native resolution and optical parameters are known.

✨ Features

  • 🔄 Hot switching between Multiview Raster and Ray Tracing rendering backends.
  • ⚡ Quality-preserving Optical Reuse and Viewpoint Reuse at RGB-subpixel granularity through validated .dlmap artifacts.
  • 📦 Native loading of trained PLY, SOG, SPZ, and SPZ4 assets.
  • 🪟 Bridge-independent import of a local Looking Glass visual.json; no Looking Glass Bridge connection is required at runtime.
  • 🖥️ Native output profiles for 2K, 4K, and 8K light-field panels. See the benchmark document for measured and TBA combinations.
  • 🎯 Per-Monitor V2 DPI awareness and pixel-exact fullscreen output at the selected profile's native resolution.

🚀 Quick start

The fastest path is the portable Windows package:

  1. Download DirectLStudio-1.0.0-win-x64.zip from GitHub Releases.
  2. Extract the complete DirectLStudio/ directory.
  3. Run DirectLStudio.exe; the package includes the Lego demo and nominal 2K reuse maps.
  4. Press 1, 2, 3, or 4 to select Multiview Raster, Ray Tracing, Optical Reuse, or Viewpoint Reuse.

To build from source or download the other demo scenes, follow Getting Started.

📚 Documentation

  • Getting Started — portable use, prerequisites, source build, scene download, and asset import.
  • Architecture — repository structure, ownership boundaries, scene flow, and GPU-resident execution.
  • Parameters — searchable index of public UI, configuration, CLI, camera, and Python parameters.
  • Benchmarks — hardware, settings, FPS tables, and reproduction commands.
  • Subpixel Reuse — generate .dlmap files from three optical values or import Looking Glass calibration offline.

🛠️ Build summary

git clone https://github.com/CoronaEngine/DirectLStudio.git
cd DirectLStudio
pip install .
$BuildRoot = Join-Path $env:TEMP 'DirectLStudio-build'
.\tools\build.ps1 -Configuration Release -BuildDirectory $BuildRoot

The complete toolchain and OptiX 8 setup are documented in Getting Started. DirectLStudio targets Windows 11, Visual Studio 2022, CUDA 13.1, OptiX 8.x, and NVIDIA RTX GPUs.

🙏 Acknowledgements

The ray-tracing backend was developed with reference to GRay, and the raster backend was developed from DirectXSplat. License notices for these projects and other bundled components are listed in THIRD_PARTY_NOTICES.md.

⚖️ License

DirectLStudio is released under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). See LICENSE. Third-party components remain under their respective licenses.

📖 Citation

If DirectL or DirectLStudio helps your work, please cite:

@article{yang2024directl,
  title={DirectL: efficient radiance fields rendering for 3D light field displays},
  author={Yang, Zongyuan and Liu, Baolin and Song, Yingde and Yi, Lan and Xiong, Yongping and Zhang, Zhaohe and Yu, Xunbo},
  journal={ACM Transactions on Graphics (TOG)},
  volume={43},
  number={6},
  pages={1--19},
  year={2024},
  publisher={ACM New York, NY, USA}
}