openFrameworks addon for using the Orbbec Astra SDK
C++ C Objective-C Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
example-multicam
example Add hacky ofVideoGrabber option for Astra Pro users Jun 20, 2016
libs/astra Update Win32/x64 libs for v0.5.0 of Astra SDK May 10, 2016
src
.gitignore Add gitignore Dec 30, 2015
README.md Add hacky ofVideoGrabber option for Astra Pro users Jun 20, 2016
addon_config.mk Updates for v0.5.0 of Astra SDK May 10, 2016

README.md

ofxOrbbecAstra

openFrameworks addon for using the Orbbec Astra SDK. Mostly barebones support at the moment – PRs are welcome to help build this out!

Setup

Clone this addon into your openFrameworks/addons folder.

cd path/to/openFrameworks/addons/
git clone https://github.com/mattfelsen/ofxOrbbecAstra.git

The Astra SDK is bundled in the libs folder and does not require a separate download or installation.

Running the example project

Hopefully this should compile and run without any hiccups. Please open an issue if you run into trouble here.

Using this addon in your project

If you're creating a new project, the easiest approach is to copy the example project, which is already set up with the correct header & linker paths.

If you're using the projectGenerator, either to create a new project or update an existing one, most things will be taken care of for you, but you will still need to set some things manually. Likewise, the Xcode OF plugin will probably do some, but not all, of the necessary things. Check that the following settings, which are also outlined addon_config.mk, are set up correctly, or do so manually if needed:

  • add to Header Search Paths:
    • ../../../addons/ofxOrbbecAstra/libs/astra/include/
  • add to Other Linker Flags:
    • ../../../addons/ofxOrbbecAstra/libs/astra/lib/osx/libastra_core_api.dylib
    • ../../../addons/ofxOrbbecAstra/libs/astra/lib/osx/libastra_core.dylib
    • ../../../addons/ofxOrbbecAstra/libs/astra/lib/osx/libastra.dylib
  • add to Runpath Search Paths:
    • @executable_path/../../../../../../../addons/ofxOrbbecAstra/libs/astra/lib/osx/

Note: this assumes your project folder is at the standard "three levels down" from your openFrameworks folder, e.g. openFrameworks/apps/myApps/projectFolder/. If not, you may need to adjust the runpath setting.

Support

This has been tested with the following setup:

  • Xcode 6
  • OS X 10.11
  • openFrameworks 0.9.0
  • Astra SDK 0.5.0 (which is included, no separate download/installation is required)
  • Orbbec Astra/Astra Pro camera

Windows support hopefully coming soon. The libs from the Win32 and x64 SDKs are included, but I haven't had a chance to test this.

Hardware Note – Astra Pro & color data

There is a known issue with the SDK and Astra Pro cameras which does not make the color data available. Trying to start the color stream (i.e. calling astra.initColorStream()) will also cause other streams to fail, so you must comment-out this line in the example and/or your projects.

The color data is separately available as a standard webcam. Rather than using initColorStream(), you can use initVideoGrabber() which uses an ofVideoGrabber under the hood for you.

You can keep an eye on the Orbbec forums to see the latest.