https://github.com/moebiussurfing/ofxsurfingtween
Tween grouped ofParameters (Float/Int) to target values using easing animators. GUI and plotting panel.
https://github.com/moebiussurfing/ofxsurfingtween
openframeworks openframeworks-addon
Last synced: 8 months ago
JSON representation
Tween grouped ofParameters (Float/Int) to target values using easing animators. GUI and plotting panel.
- Host: GitHub
- URL: https://github.com/moebiussurfing/ofxsurfingtween
- Owner: moebiussurfing
- License: mit
- Created: 2021-05-31T07:17:04.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-09-17T08:29:13.000Z (over 4 years ago)
- Last Synced: 2025-04-02T00:44:08.994Z (about 1 year ago)
- Topics: openframeworks, openframeworks-addon
- Language: C++
- Homepage:
- Size: 375 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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](https://github.com/armadillu/ofxAnimatable) from @**armadillu**.
## Screenshots
## 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.
## 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 lineWidth;
ofParameter separation;
ofParameter speed;
ofParameter amount;
ofParameter 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);
}
```
Dependencies
Clone these add-ons and include into the **OF PROJECT GENERATOR** to allow compile your projects or the examples:
* [ofxSurfingAnimators](https://github.com/moebiussurfing/ofxSurfingAnimators)
* [ofxAnimatable](https://github.com/moebiussurfing/ofxAnimatable) [ FORK ]
* [ofxHistoryPlot](https://github.com/moebiussurfing/ofxHistoryPlot) [ FORK ]
* [ofxScaleDragRect](https://github.com/moebiussurfing/ofxScaleDragRect) [ FORK ]
* [ofxImGui](https://github.com/Daandelange/ofxImGui/) [ FORK ]
* [ofxSurfingImGui](https://github.com/moebiussurfing/ofxSurfingImGui)
* [ofxSurfingPresets](https://github.com/moebiussurfing/ofxSurfingPresets)
* [ofxSurfingHelpers](https://github.com/moebiussurfing/ofxSurfingHelpers)
* [ofxWindowApp](https://github.com/moebiussurfing/ofxWindowApp) [ Only for **example** ]
_Thanks a lot to all these ofxAddons coders. Specially to @**armadillu**_
Tested Systems
- **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](https://twitter.com/moebiussurfing/) | [YouTube](https://www.youtube.com/channel/UCzUw96_wjmNxyIoFXf84hQg) | [Instagram](https://www.instagram.com/moebiussurfing/)