ofxAddons
openFrameworks addon for receiving data from the Bare Conductive's Touch Board
Forks
Forks pushed to more recently than elaye/ofxTouchBoard itself, plus any admin-confirmed fork with commits of its own — worth checking if you're hitting issues with the original.
README
ofxTouchBoard
Introduction
This addon helps you receive data from the Bare Conductive's Touch Board in a simple and convenient way.License
MIT License, see license.md.Installation
Just drop the folder into theopenFrameworks/addons/ folder. To receive data from your Touch Board you need to upload the DataStream program on it.Usage
See the examples for how to use this addon in your app. The following methods are available:
setup() setup(int deviceId) Setup the Touch Board corrresponding to deviceId (use this when using multiple Touch Boards).
update() Update the data received from the Touch Board, call this every frame.
getTouchStatus() Get a vector of boolean containing the touch status of each electrode of the Touch Board.
draw(float x, float y) Draw a bar graph with filtered data and baseline value.
ofEvent<int> touched Touch event you can register to.
ofEvent<int> released Release event you can register to.
getData() Get a vector of ofxTB::Electrode containing normalized data.
Other available methods:
logData() Log data to the console.
printData(float x, float y) Print an array of data from the Touch Board (normalized between 0.0 and 1.0).
printRawData(float x, float y) Print an array of raw data from the Touch Board.
useBoardThresholds(bool b) Use thresholds from the Touch Board or from the addon to detect touch and release.
getRawData() Get a vector of ofxTB::Electrode containing raw data.
getTouchThresholds() Get a vector of ofParameter<float> corresponding to the touch thresholds of the addon.
getReleaseThresholds() Get a vector of ofParameter<float> corresponding to the release thresholds of the addon.
getTouchThresholdsParams() Get an ofParameterGroup containing the touch thresholds of the addon (easy to use with ofxGui).
getReleaseThresholdsParams() Get an ofParameterGroup containing the release thresholds of the addon (easy to use with ofxGui).
The ofxTB::Electrode structure is like this:
struct Electrode { // Touch bool touch; // Touch threshold float tths; // Release threshold float rths; // Filtered data float fdat; // Baseline val float bval; // Difference between 'bval' and 'fdat' float diff; }; `
Dependencies
None for the addon. ofxGui for the examples.
Compatibility
This addon works with oF 0.8.4 on Linux, Mac OS X and Raspberry Pi (v1 and v2).
Contributing
You found a bug or want to improve this addon? Please, open an issue!
Known issues
Don't setup your boards with when using multiple boards, use setup(int deviceId)` instead.