https://github.com/vimeo/vimeo-depth-viewer
OpenGL application for viewing depth and color video streams from Intel RealSense cameras
https://github.com/vimeo/vimeo-depth-viewer
cplusplus livestream opengl realsense volumetric
Last synced: 6 months ago
JSON representation
OpenGL application for viewing depth and color video streams from Intel RealSense cameras
- Host: GitHub
- URL: https://github.com/vimeo/vimeo-depth-viewer
- Owner: vimeo
- License: mit
- Created: 2018-07-05T22:13:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-06-22T16:54:37.000Z (over 6 years ago)
- Last Synced: 2025-04-03T22:41:39.452Z (6 months ago)
- Topics: cplusplus, livestream, opengl, realsense, volumetric
- Language: C++
- Homepage: https://vimeo-volumetric-video-livestreaming.glitch.me/
- Size: 1.15 MB
- Stars: 54
- Watchers: 17
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Vimeo Depth Viewer
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).