ofxOSSIA

This project is outdated and not maintained anymore. Please look at ofxOscQuery if you're looking for a quick and convenient way to add OscQuery connectivity to your OpenFrameworks project.

Introduction

This openFrameworks addon is a wrapper for the OSSIA library , allowing you to share parameters with i-score: the class ossia::Parameter inheriting the openFrameworks' class ofParameter can be controlled both via the UI and i-score.

Dependencies

• Tested on Linux (Debian/stretch, Antergos), macOS, Windows

• The OSSIA library (libossia) require some boost libs not available in OpenFrameworks. They are installed by the build script.

Installation (OS X, Linux)

• Compile the OSSIA library: go to the folder libs/ and run the script build.sh
• Include the header file ofxOssia.h to use the addon
• compilation of your project must been made through Terminal / make and not through xcode.
• You could also use ofnode, a CMake build system for openFrameworks

Installation (Windows)

• The simplest way is to use one of the releases.
• Once your application is built, do not forget to copy the relevant DLL from the libs/ossia/bin folder, to your executable folder.
• For compiling the OSSIA API by hand, refer to the OSSIA API wiki.

Troubleshooting

• In case of the following error : execvp: /bin/sh: Argument list too long: check that you do not have a boost folder in your example folder.

• If you got : error: parse error in template argument list this is likely due to a GCC bug, try update to gcc 6 or use another compiler.

• It might be a clash with other addon that uses oscpack library like ofxOsc.

Main features

• Parameters of various types (int, float, bool, ofVec2f, ofVec3f, ofColor) can be shared with i-score
• Can be exposed in the openFrameworks GUI (modified via slider, button, etc.)
• Can be modified using i-score (automation ...)

Usage

• Define an attribute of class ofxOssia in your app source header (e.g. ofApp.h)
• If the constructor for the attribute is not called explicitly, the attribute ofxOssia will be initialized with the default values (e.g. "OSCQuery", "ofxOssiaDevice", 3456, 5678)
• The base node is obtained by calling the method get_root_node() on the ofxOssia instance
• The ossia::Parameter is initialized using the method setup similar to ofParameter::setup. The only difference is the first value which is the parent node of type ossia::Parameter
• The same goes for ossia::ParameterGroup (which is similar to ofParameterGroup)