ofxAddons
Tween grouped ofParameters (Float/Int) to target values using easing animators. GUI and plotting panel.
README
ofxSurfingTween
Overview
An openFrameworks add-on to tween grouped ``ofParameters` to Target values using powerful Easing Animators.
ofxSurfingTween is a helper with the ofxSurfingAnimators engine plus an `ofParameters` bridge, live plottings, easy integration workflow, GUI, and settings management.
Powered with the _awesome_ ofxAnimatable from @armadillu.
Screenshots
<img src="docs/readme_images/Capture.PNG" width="100%" height="100%">
Features
- Simple use: Just pass your
`ofParameterGroup` parameters container.Another usable `ofParameterGroup` will be created with the same parameters cloned: but for the accesible tweened values.Only `Float` and `Int` types yet.Scalable and draggable plots panel. Monitor SOLO of one picked parameter with full size graph. Auto Store/Recall all the settings. ImGui based GUI, docking, ready to integrate. Presets engine to alternate different animation configurations. Some testing tools like timed randomizers. Animator Engine
Tween Engine with all the ofxAnimatable power: 50+ ease curves. Play modes: once, loop, back and forth, and play n times. Duration Time (ms) scaled or BPM MODE divisions. Plot preview and progress bars.
<img src="docs/readme_images/Capture2.PNG" width="30%" height="30%">
Workflow Usage
1. Set the Source params that will be used as Target values (destination). 2. Set and Tweak the Easing Animator: duration, time or BPM scaled, pre delay pause, curve types...etc. 3. Trig the Easing Animator for all the parameters. 4. Get the Tweened values to use in your scene.
Usage
ofApp.h `.cpp include "ofxSurfingTween.h"
ofxSurfingTween dataTween;
ofParameterGroup params; // group container ofParameter<float> lineWidth; ofParameter<float> separation; ofParameter<float> speed; ofParameter<int> amount; ofParameter<int> shapeType;
ofApp.cpp
.cpp void ofApp::setup() { params.setName("paramsGroup"); params.add(lineWidth.set("lineWidth", 0.5, 0.0, 1.0)); params.add(separation.set("separation", 50.0, 1.0, 100.0)); params.add(speed.set("speed", 0.5, 0.0, 1.0)); params.add(amount.set("amount", 1, 1, 10)); params.add(shapeType.set("shapeType", 0, 0, 3));
dataTween.setup(params); }
void ofApp::update() { // Get the tweened parameters: float _lineWidth = dataTween.get(lineWidth); float _separation = dataTween.get(separation); float _speed = dataTween.get(speed); int _amount = dataTween.get(amount); int _shapeType = dataTween.get(shapeType); } ``<details> <summary>Dependencies</summary> <p>
Clone these add-ons and include into the OF PROJECT GENERATOR to allow compile your projects or the examples: ofxSurfingAnimators ofxAnimatable [ FORK ] ofxHistoryPlot [ FORK ] ofxScaleDragRect [ FORK ] ofxImGui [ FORK ] ofxSurfingImGui ofxSurfingPresets ofxSurfingHelpers ofxWindowApp [ Only for example ]
_Thanks a lot to all these ofxAddons coders. Specially to @armadillu_ </p> </details>
<details> <summary>Tested Systems</summary> <p>
- Windows 10 / VS 2017 / OF ~0.11
TODO
+ Add more types: 2D/3D vectors and colors. Using templates... ? [ _ANY HELP/PULL ON THIS IS APPRECIATED!_ ] + Add "real" nested sub-groups with indented tree levels. Now the params are recreated on one depth level only. This could help when duplicated names or indent sub-groups on a GUI too.Author
An add-on by @moebiusSurfing ( ManuMolina ) 2021*Twitter | YouTube | Instagram