# [*Record3D – Point Cloud Animation and Streaming*](https://record3d.app/): the accompanying library
**2022/08/16 Update**: Added camera position streaming (introduced breaking changes). **To be used with Record3D 1.7.2 and newer.**
**2021/07/28 Update**: Introduced support for higher-quality RGB LiDAR streaming. **To be used with Record3D 1.6 and newer.**
**2020/09/17 Update**: Introduced LiDAR support. To be used with Record3D 1.4 and newer.
This project provides C++ and Python libraries for the [iOS Record3D app](https://record3d.app/) which allows you (among other features) to
live-stream RGB**D** video from iOS devices with TrueDepth camera to a computer via USB cable.
## Prerequisites
- Install [CMake](https://cmake.org/download/) >= **3.13.0** and make sure it is in `PATH`.
- When on macOS and Windows, install [iTunes](https://www.apple.com/itunes/).
- When on Linux, install [`libusbmuxd`](https://launchpad.net/ubuntu/+source/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".
### 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
Raw data
{
"_id": null,
"home_page": "https://github.com/marek-simonik/record3d",
"name": "record3d",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "record3d,iOS,TrueDepth,streaming,pointcloud,point,cloud",
"author": "Marek Simonik",
"author_email": "admin@record3d.app",
"download_url": "https://files.pythonhosted.org/packages/5d/13/a728f163e7639d14615d6d09f3f24181ef7a59bd690f7af28356b26cfe3a/record3d-1.3.1-2.tar.gz",
"platform": null,
"description": "# [*Record3D \u2013 Point Cloud Animation and Streaming*](https://record3d.app/): the accompanying library \n\n**2022/08/16 Update**: Added camera position streaming (introduced breaking changes). **To be used with Record3D 1.7.2 and newer.**\n\n**2021/07/28 Update**: Introduced support for higher-quality RGB LiDAR streaming. **To be used with Record3D 1.6 and newer.**\n\n**2020/09/17 Update**: Introduced LiDAR support. To be used with Record3D 1.4 and newer.\n\nThis project provides C++ and Python libraries for the [iOS Record3D app](https://record3d.app/) which allows you (among other features) to \nlive-stream RGB**D** video from iOS devices with TrueDepth camera to a computer via USB cable.\n\n## Prerequisites\n - Install [CMake](https://cmake.org/download/) >= **3.13.0** and make sure it is in `PATH`.\n - When on macOS and Windows, install [iTunes](https://www.apple.com/itunes/).\n - When on Linux, install [`libusbmuxd`](https://launchpad.net/ubuntu/+source/libusbmuxd) (`sudo apt install libusbmuxd-dev`). It should be installed by default on Ubuntu.\n \n## Installing\nThe libraries are multiplatform \u2014 macOS, Linux and Windows are supported.\n\n### Python\nYou can install either via `pip`:\n \n python -m pip install record3d\n\nor build from source (run as admin/root):\n \n git clone https://github.com/marek-simonik/record3d\n cd record3d\n python setup.py install\n \n### C++\nAfter running the following, you will find compiled static library in the `build` folder and header files in the `include` folder.\n\n**macOS and Linux**\n\n git clone https://github.com/marek-simonik/record3d\n cd record3d\n mkdir build && cd build\n cmake -DCMAKE_BUILD_TYPE=Release ..\n make -j8 record3d_cpp\n make install\n # now you can link against the `record3d_cpp` library in your project\n\n**Windows**\n\n git clone https://github.com/marek-simonik/record3d\n cd record3d\n md build\n cd build\n cmake -DCMAKE_BUILD_TYPE=Release -G \"Visual Studio 15 2017 Win64\" ..\n # Open the generated Visual Studio Solution (.sln) fil and build the \"`record3d_cpp`\" Project\n\n## Sample applications\nThere 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.\n\nBefore 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\".\n\n### Python\nAfter installing the `record3d` library, run `python demo-main.py` and press the record button to start streaming RGBD data.\n\n### C++\nYou can build the C++ demo app by running the following (press the record button in the iOS app to start streaming RGBD data):\n\n**macOS and Linux**\n\n git clone https://github.com/marek-simonik/record3d\n cd record3d\n mkdir build && cd build\n cmake -DCMAKE_BUILD_TYPE=Release ..\n make -j8 demo\n ./demo\n \n**Windows**\n\n git clone https://github.com/marek-simonik/record3d\n cd record3d\n md build\n cd build\n cmake -DCMAKE_BUILD_TYPE=Release -G \"Visual Studio 15 2017 Win64\" ..\n # Open the generated Visual Studio Solution (.sln) file and run the \"`demo`\" Project\n\n\n",
"bugtrack_url": null,
"license": "lgpl-2.1",
"summary": "Accompanying library for the Record3D iOS app (https://record3d.app/). Allows you to receive RGBD stream from iOS devices with TrueDepth and/or LiDAR camera(s).",
"version": "1.3.1.post2",
"split_keywords": [
"record3d",
"ios",
"truedepth",
"streaming",
"pointcloud",
"point",
"cloud"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "020af2e5df28cc2b7bec376e4c9ef179",
"sha256": "bbe4bc87028a84f51505fa515bd8582e9096c2bf97e13e1e733d7044eae48ae6"
},
"downloads": -1,
"filename": "record3d-1.3.1-2.tar.gz",
"has_sig": false,
"md5_digest": "020af2e5df28cc2b7bec376e4c9ef179",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 548980,
"upload_time": "2022-12-15T08:22:21",
"upload_time_iso_8601": "2022-12-15T08:22:21.148688Z",
"url": "https://files.pythonhosted.org/packages/5d/13/a728f163e7639d14615d6d09f3f24181ef7a59bd690f7af28356b26cfe3a/record3d-1.3.1-2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-15 08:22:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "marek-simonik",
"github_project": "record3d",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "record3d"
}
JSON
