Skip to main content

Accompanying library for the Record3D iOS app (https://record3d.app/). Allows you to receive RGBD stream from iOS devices with TrueDepth camera(s).

Project description

Record3D – Point Cloud Animation and Streaming: the accompanying library

This project provides C++ and Python libraries for the iOS Record3D app which allows you (among other features) to live-stream RGBD video from iOS devices with TrueDepth camera to a computer via USB cable.

Prerequisites

  • Install CMake >= 3.13.0 and make sure it is in PATH.
  • When on macOS and Windows, install iTunes.
  • When on Linux, install libusbmuxd (sudo apt install libusbmuxd-dev). It should be installed by default on Ubuntu.

Installing

The libraries are multiplatform — macOS, Linux and Windows are supported.

Python

You can install either via pip:

python -m pip install record3d

or build from source (run as admin/root):

git clone https://github.com/marek-simonik/record3d
cd record3d
python setup.py install

C++

After running the following, you will find compiled static library in the build folder and header files in the include folder.

macOS and Linux

git clone https://github.com/marek-simonik/record3d
cd record3d
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j8 record3d_cpp
make install
# now you can link against the `record3d_cpp` library in your project

Windows

git clone https://github.com/marek-simonik/record3d
cd record3d
md build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -G "Visual Studio 15 2017 Win64" ..
# Open the generated Visual Studio Solution (.sln) fil and build the "`record3d_cpp`" Project

Sample applications

There is a Python (demo-main.py) and C++ (src/DemoMain.cpp) sample project that demonstrates how to use the library to receive and display RGBD stream.

Before running the sample applications, connect your iOS device to your computer and open the Record3D iOS app. Go to the Settings tab and enable "USB Streaming mode". Note that the fr

Python

After installing the record3d library, run python demo-main.py and press the record button to start streaming RGBD data.

C++

You can build the C++ demo app by running the following (press the record button in the iOS app to start streaming RGBD data):

macOS and Linux

git clone https://github.com/marek-simonik/record3d
cd record3d
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j8 demo
./demo

Windows

git clone https://github.com/marek-simonik/record3d
cd record3d
md build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -G "Visual Studio 15 2017 Win64" ..
# Open the generated Visual Studio Solution (.sln) file and run the "`demo`" Project

Project details


Release history Release notifications

This version

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for record3d, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size record3d-1.0.0-cp27-cp27m-macosx_10_13_x86_64.whl (174.9 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size record3d-1.0.0-cp27-cp27m-manylinux2010_x86_64.whl (207.0 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size record3d-1.0.0-cp27-cp27mu-manylinux2010_x86_64.whl (207.0 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size record3d-1.0.0-cp27-cp27m-win32.whl (134.3 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size record3d-1.0.0-cp27-cp27m-win_amd64.whl (157.8 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size record3d-1.0.0-cp34-cp34m-manylinux2010_x86_64.whl (207.2 kB) File type Wheel Python version cp34 Upload date Hashes View
Filename, size record3d-1.0.0-cp35-cp35m-manylinux2010_x86_64.whl (207.4 kB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size record3d-1.0.0-cp36-cp36m-macosx_10_9_x86_64.whl (184.1 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size record3d-1.0.0-cp36-cp36m-manylinux2010_x86_64.whl (207.4 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size record3d-1.0.0-cp36-cp36m-win32.whl (141.4 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size record3d-1.0.0-cp36-cp36m-win_amd64.whl (164.7 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size record3d-1.0.0-cp37-cp37m-macosx_10_13_x86_64.whl (184.1 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size record3d-1.0.0-cp37-cp37m-manylinux2010_x86_64.whl (207.2 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size record3d-1.0.0-cp37-cp37m-win32.whl (141.4 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size record3d-1.0.0-cp37-cp37m-win_amd64.whl (164.7 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size record3d-1.0.0.tar.gz (498.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page