https://github.com/moebiussurfing/ofxsurfingrandomizer
Randomizer explorer between minimum and maximum ranges for ofParameters and int index with probabilities.
https://github.com/moebiussurfing/ofxsurfingrandomizer
openframeworks openframeworks-addon
Last synced: about 1 year ago
JSON representation
Randomizer explorer between minimum and maximum ranges for ofParameters and int index with probabilities.
- Host: GitHub
- URL: https://github.com/moebiussurfing/ofxsurfingrandomizer
- Owner: moebiussurfing
- License: mit
- Created: 2021-05-23T00:53:22.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-05-04T05:01:09.000Z (about 3 years ago)
- Last Synced: 2025-02-07T16:19:37.562Z (over 1 year ago)
- Topics: openframeworks, openframeworks-addon
- Language: C++
- Homepage:
- Size: 28.3 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ofxSurfingRandomizer
## Overview
An **openFrameworks** add-on to perform **Two** types of useful **Randomizers** for your scenes.
The Randomizers will target over:
A. The desired **ofParameters** (int/float/bool) of an **ofParameterGroup**.
B. An **Index** selector. (_int/preset/state..._)
## Why ?
- Useful to **Explore not expected Combinations** of the **ofParameters Randomizer** (A) that "modulate" your scene.
- Using the **Index Randomizer** (B) you can add some "_organic behavior_" to your scene, switching your scene between different _modes/presets/states_.
- A global **BPM timer** can be used to set the speed of the switching, with two different categories for stay duration (**long/short**).
- Each allowed index (ie: from 0 to 8) has a settable probability to make some states more or less frequently switched to.
## A. ofParameters RANDOMIZER
### USAGE
1. Just pass your ```ofParameterGroup``` parameters container.
2. Enable the desired parameters from the group.
3. Set the range limits for each parameter to fit the random inside them.
4. Notice that limits will be also inside the Min/Max of the parameters but independent of them.
5. Trig the randomization.
6. Use the Tester player to repeat randomizations during tweaking.
## B. Iindex RANDOMIZER
### USAGE
1. Initialize the Min-Max of your index/int parameter. (ie: how many presets/states are available)
2. Set the probability for each index.
3. Set if the index should stay long or short staying duration when her random happens.
4. Set the global BPM clock speed.
5. Pass your *ofParameter* target index to receive the index randoms (in ofApp).
6. Use the Tester player to repeat randomizations during tweaking.
Other Features
- **ImGui** based.
- Only ```float```, ```int``` and ```bool``` types yet.
- Reset all parameters to the parameter or the range min/max.
- Reset Min/Max ranges to a parameter limits.
- Store/Recall a temp memory state. To improve exploring Undo/Redo.
- Auto Store/Recall all the settings.
- **ImGui** based GUI ready to integrate.
- Added **Undo Engine** to improve exploration.
Example Code
**ofApp.h**
```.cpp
#include "ofxSurfingRandomizer.h"
ofxSurfingRandomizer randomizer;
// A. Params
ofParameterGroup params; // group container
ofParameter lineWidth;
ofParameter separation;
ofParameter speed;
ofParameter amount;
ofParameter shapeType;
// B. Index
ofParameter index{ "index", 0, 0, 8 };
ofEventListener listenerIndex;
```
**ofApp.cpp**
```.cpp
void ofApp::setup()
{
// A. Params
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(speed.set("shapeType", 0, 0, 3));
// Setup
randomizer.setIndexPtr(index); // B -> Must be setted before call setup.
randomizer.setup(params); // A
// B. Index
// Lambda callback to receive the randomized index target.
//--------------------------------------------------------------
listenerIndex = index.newListener([this](int &i) {
ofLogNotice("ofApp") << "Index: " << index;
});
}
```
Dependencies
Clone these add-ons and include into the **OF PROJECT GENERATOR**:
* [ofxSurfingHelpers](https://github.com/moebiussurfing/ofxSurfingHelpers)
* [ofxImGui](https://github.com/Daandelange/ofxImGui/). / _FORK_ from @**Daandelange**
* [ofxImGuiSurfing](https://github.com/moebiussurfing/ofxImGuiSurfing/)
* [ofxSurfingUndoHelper](https://github.com/moebiussurfing/ofxSurfingUndoHelper/) / _Optional. Disabled by default._
* [ofxWindowApp](https://github.com/moebiussurfing/ofxWindowApp). / _Not required. Only for some examples._
Already included into `/libs`. No need to add manually into PG.
* [ofxScaleDragRect](https://github.com/moebiussurfing/ofxScaleDragRect) / _Fork_
* [ofxMSAInteractiveObject](https://github.com/moebiussurfing/ofxMSAInteractiveObject) / _Fork_
* [ofxUndo](https://github.com/moebiussurfing/ofxUndo) / _Optional. Disabled by default._
Tested Systems
- **Windows 10** / **VS 2017** **VS 2022** / **OF ~0.11**
TODO
* Add more types: 2D/3D vectors and colors. Using templates [?]
## Author
An add-on by **@moebiusSurfing**
*( ManuMolina ) 2021*