OpenGL application for viewing depth and color video streams from Intel RealSense cameras
Switch branches/tags
Nothing to show
Clone or download
Latest commit 55b3cc5 Nov 12, 2018

README.md

Vimeo Depth Viewer

A GIF of the depth viewer application

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.

PRs Welcome

  1. Quick-start
  2. Features
  3. Build from source
  4. Dependencies
  5. License

Quick-start

Make you get either the Intel RealSense D415/D435. 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 or build it 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

  • An easy to use interface based on nanogui.
  • Depth clipping for easy background removal.
  • Seprate stream view and monitor window for capturing and live streaming a full window using OBS
  • Depth filtering (decimation, spatial and temporal filters)
  • 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 and run
brew install cmake
  1. Clone the repository including all the submodules:
git clone https://github.com/vimeo/depth-viewer.git --recursive
  1. Go inside the folder and create a build folder by running cd vimeo-depth-viewer && mkdir build
  2. Run CMake by calling cmake ../ from the build folder
  3. Run make to build an executable
  4. Run the executable by running ./VimeoDepthViewer

Tested on macOS v10.13.4 & CMake v3.11.4

Dependencies

  1. GLFW
  2. nanogui
  3. Eigen
  4. librealsense2

License

License file could be found here

Questions, help, and support

For questions and support, ask on StackOverflow. If you found a bug, please file a GitHub issue.

Make pull requests, file bug reports, and make feature requests via a GitHub issue.

Let's collaborate

Working on a cool video project? Let's talk - labs at vimeo dot com