search

vimeo / vimeo-depth-viewer

OpenGL application for viewing depth and color video streams from Intel RealSense cameras
https://vimeo-volumetric-video-livestreaming.glitch.me/
MIT License
53 stars 11 forks source link
cplusplus livestream opengl realsense volumetric

readme

Vimeo Depth Viewer

A GIF of the depth viewer application

PRs Welcome

An OpenGL application for viewing depth and color video streams from Intel RealSense cameras (D415/D435).

This repository consists of tools and demos presented at the Volumetric Filmmaking meetup at NYC.
Watch the live-stream from the meetup or checkout the WebVR examples.

Looking for a simpler solution that doesn't require code? head over to Depthkit to learn more, our WebVR examples fully support it

1. [Quick-start](#quick-start) 1. [Features](#features) 1. [Build from source](#build-from-source) 1. [Dependencies](#dependencies) 1. [License](#license) # Quick-start Make you get either the Intel [RealSense D415/D435](https://click.intel.com/intelr-realsensetm-depth-camera-d415.html). We peronsally prefered working with the D415, as it proved more reliable, but both work with this software. To quickly get started, download a pre-built release of the depth-viewer [from here](https://github.com/vimeo/depth-viewer/releases) or [build it from source](#build-from-source). Once you have a binary launch it by double clicking it or calling `./VimeoDepthViewer` from the folder and you should be good to go. # Features - [x] An easy to use interface based on [nanogui](https://github.com/wjakob/nanogui). - [x] Depth clipping for easy background removal. - [x] Seprate stream view and monitor window for capturing and live streaming a full window using [OBS](http://obsproject.com) - [x] Depth filtering (decimation, spatial and temporal filters) - [x] Fully `git submodules` and `CMake` for easy set up # Build from source All 3rd party libraries used are included as `git submodules` to ease the setup and development process, it should be easy to clone using the `--recursive` flag and build everything from source. 1. Make sure you have `CMake` installed, for macOS, install [Homebrew](https://brew.sh) and run ```sh brew install cmake ``` 2. Clone the repository including all the submodules: ``` git clone https://github.com/vimeo/depth-viewer.git --recursive ``` 3. Go inside the folder and create a build folder by running `cd vimeo-depth-viewer && mkdir build` 4. Run `CMake` by calling `cmake ../` from the build folder 5. Run `make` to build an executable 6. Run the executable by running `./VimeoDepthViewer` > Tested on macOS v10.13.4 & CMake v3.11.4 # Dependencies 1. [GLFW](https://github.com/glfw/glfw) 1. [nanogui](https://github.com/wjakob/nanogui) 1. [Eigen](https://github.com/libigl/eigen) 1. [librealsense2](https://github.com/IntelRealSense/librealsense) # License License file could be [found here](https://github.com/vimeo/vimeo-depth-viewer/blob/master/LICENSE) # Questions, help, and support For questions and support, [ask on StackOverflow](https://stackoverflow.com/questions/ask/?tags=vimeo). If you found a bug, please file a [GitHub issue](https://github.com/vimeo/vimeo-depth-viewer/issues). Make pull requests, file bug reports, and make feature requests via a [GitHub issue](https://github.com/vimeo/vimeo-depth-viewer/issues).