https://github.com/moebiussurfing/ofxsurfingwaveplots
Easily plot an audio signal waveform. Customized presets with shapes and styles.
https://github.com/moebiussurfing/ofxsurfingwaveplots
openframeworks openframeworks-addon
Last synced: 3 months ago
JSON representation
Easily plot an audio signal waveform. Customized presets with shapes and styles.
- Host: GitHub
- URL: https://github.com/moebiussurfing/ofxsurfingwaveplots
- Owner: moebiussurfing
- License: other
- Created: 2022-11-26T05:33:40.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-02-16T06:14:27.000Z (over 3 years ago)
- Last Synced: 2026-01-28T05:04:36.741Z (4 months ago)
- Topics: openframeworks, openframeworks-addon
- Language: Makefile
- Homepage:
- Size: 752 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OVERVIEW
**openFrameworks** add-on to easily plot an audio signal waveform using different customized presets with many combined shapes and different styles.
## SCREENSHOTS
#### exampleSimple
#### An example from ofxSoundDevicesManager. (Using ofxBloom)
## FEATURES
* Scalable and draggable box container.
* Extra gain control for scaling.
* Combine different reactive to the audio elements:
* Scope lines.
* Thin lines.
* Transparent circles.
* Rounded fat bars.
* Circled shaped elements.
* Filled or outlined contour mesh.
* A 3d rective object as an alternative example.
* Spreaded or padding more closer between elements.
* All the styles are handled by a Presets Manager.
* Smoother to customize animation speed and release behavior.
* **OPTIONAL**: WIP **Bloom Shader** for shader post-FX styling.
* **OPTIONAL**: Easily integrable with my add-on: [ofxSoundDevicesManager](https://github.com/moebiussurfing/ofxSoundDevicesManager).
USAGE
#### ofApp.h
```.cpp
#include "ofxSurfingImGui.h"
#include "ofxSurfingAudioPlots.h"
ofxSurfingGui ui;
void setupGui();
void drawGui();
void audioIn(ofSoundBuffer & input);
WaveformPlot waveformPlot;
```
#### ofApp.cpp
```.cpp
void ofApp::setup()
{
setupGui();
// Look the examples.
waveformPlot.setup();
waveformPlot.setUiPtr(&ui); // We will use a parent ui! Passed as reference.
}
void ofApp::update()
{
waveformPlot.update();
}
void ofApp::drawGui()
{
ui.Begin();
{
//..
waveformPlot.drawImGui(false);
}
ui.End();
}
void ofApp::draw()
{
waveformPlot.drawPlots();
drawGui();
}
void ofApp::audioIn(ofSoundBuffer& input)
{
// Feed the waveformPlot object with the incomming audio samples.
// Look the examples.
}
```
## DEPENDENCIES
* [ofxSurfingImGui](https://github.com/moebiussurfing/ofxSurfingImGui)
* [ofxImGui](https://github.com/Daandelange/ofxImGui/) / Fork
* [ofxSurfingHelpers](https://github.com/moebiussurfing/ofxSurfingHelpers)
* [ofxSurfingBox](https://github.com/moebiussurfing/ofxSurfingBox)
OPTIONAL
* ofxGui / oF core
(Probably not working _out-of-the-box_ as a full replacement to `ofxSurfingImGui`, but could be done with some work.
* [ofxBloom](https://github.com/P-A-N/ofxBloom) / WIP
TODO
* BUG: Fix bloom shader that fails whe resizing the fbo / box container.
* Improve plotting performance using `ofMesh`.
* Improve spread of elements correctly related to audio samples and buffer size.
## TESTED SYSTEMS
* **Windows 10** / **VS 2022** / **OF ~0.11+**
## AUTHOR
An add-on by **@moebiusSurfing**
*(ManuMolina). 2022-2023.*
## LICENSE
*MIT License*