LFO Modulation Framework
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
example-basic
example-headless
example-midi
example-osc
example-persistentNodes
example-seedRandom
example_bpm_detection
scripts/ci
src
.appveyor.yml
.gitignore
.travis.yml
README.md
addon_config.mk
license.md
ofxOceanode_diagram.xml
ofxaddons_thumbnail.png

README.md

ofxOceanode

Oceanode is an openframeworks addon used to quickly create projects using "dataflow like" programming. The main idea of oceanode became a logic step as we wanted to export our LFO based control to everithing we could imagine.

Introduction

The main idea is to be able to easily create modules and to be able to control it's parameters (with ofParameter) via other modules (modulators). For it's interconnection we use a node based system, that allows us flexibiliy and also easy of view of what is afecting what in realtime.

Another main characteristic is that the connections and nodes layout can be stored as scenes (we call them presets).

License

MIT_Licence

Installation

Just drop the folder into the openFrameworks/addons/ folder.

Dependencies

ofxDatGui_PM/of_master_brach

Use

  • Copy ofxBraitsch folder into data folder.
  • Add #include "ofxOceanode.h" into ofApp.h
  • Decalre a canvas, container and a controls in ofApp.h as:
ofxOceanodeCanvas canvas;
shared_ptr<ofxOceanodeContainer> container;
unique_ptr<ofxOceanodeControls> controls;
  • Create them in ofApp.cpp and assign container to canvas in the following way:
container = make_shared<ofxOceanodeContainer>(reg, treg);
canvas.setContainer(container);
canvas.setup();
    
controls = new ofxOceanodeControls(container);
  • For creating custom nodes, check out example-basic

Compatibility

Only compatible with openFrameworks latest release (0.10) or github master branch.

  • macOs
  • Win
  • Linux
  • Rpi (only headless mode tested)

We mainly work on macOs, and we are not testing every change into win/linux. So it's probable that something is broken for those platforms. Also control keystrokes are not optimized for those platforms.

Known issues

  • Threading done bad, all is done in the draw/update loop, so drawing the gui at 120fps if you want higer data rates it's not optimal.
  • Order of execution depends on order of connection created, no way to control them.
  • Loading presets is slow.

Version history

Version 0.1 (03/03/2018):

  • First working prototipe
  • Basic modulators (phasor, oscillator, oscillator bank, mapper)
  • Basic connections for parameters of same type (no min max matching by the moment).
  • Connection interaction (create, destroy, move connection when modules moved).
  • Module creation and destruction

Version 0.2 (22/03/2018):

  • Infinite Canvas
  • More Connections (vector to float, float to vector, void to bool)
  • Controls window
  • Load save presets (modules, connections, modules params)
  • Master BPM control over modules

Version 0.3 (05/04/2018)

  • Upate Phasors and oscillators
  • Added methods for saving/loading custom data from nodeModel
  • You can define the category of a module, now dropdown for creating new nodes has folders with this categories
  • Add custom color to a module (all sliders same color)
  • Added external Window node model. Helper class to use nodes that can create a secondary window (for preview or custom guis)
  • Parameters can be choosen to be saved on preset or not.
  • Added smoother module.

Version 0.4 (12/04/2018)

  • Updated Mapper and Ranger
  • Improved connections templates to be able to create more connections (float to vector or vector to vector for example)
  • Fix loading connections on preset.
  • Be able to update parameters from a nodeModel.
  • Json fixes
  • Multislider updates.

Version 0.5 (26/04/2018)

  • Added headless mode
  • Added BPM detection
  • Now we have a types registry to create connections from a custom type. No more need to declare "createConnectionFromCustomType"
  • Changed vector to ofEventListeners.

Version 0.6 (19/07/2018)

  • Updated remove of Nodes
  • Added dulplicate of modules via alt+click on top of a Node
  • revised includes to decrease compilation time.
  • Implemented Osc communication of parameters.
  • Move connections when gui collapse
  • Tested in windows
  • Implemented setup() method in nodemodel, called when node is created.
  • Added functions before loading a preset and after all things have been done when loading a preset.

Version 0.7 (15/07/2018)

  • Oscillator Banks can be modulated with vectors, crazy modulations ahead!
  • Dropdown fixes
  • Updated OSC.
  • Implemeted Persistent Nodes and connections (buggy)
  • Implemented Global Phase (Not working)
  • Midi Control
  • Added randomseed to oscillators/oscillator banks
  • string parameters are also saved in preset
  • Connection replace instead of new one disapearing
  • Fixed phantom connections

Build Status

Linux, macOS Build Status Windows Build status