ofxAddons
A lightweight addon for openFrameworks supporting crossfading, data passing and event handling. You can write your own scenes just like ofApp.
Forks
Forks pushed to more recently than kokinomura/ofxSceneManager itself, plus any admin-confirmed fork with commits of its own — worth checking if you're hitting issues with the original.
WhatFor/ofxSceneManager
kschaer/ofxSceneManager
dernster/ofxSceneManager
schwittlick/ofxSceneManager
loudcube/ofxSceneManager
0x705h/ofxSceneManager
Branches ahead of master
These branches have commits not yet on master — could be unmerged fixes or work in progress worth a look.
README
ofxSceneManager
A lightweight addon for openFrameworks supporting crossfading, data passing and event handling.
You can write your own scenes just like ofApp!
Dependency
- ofxTween (https://github.com/arturoc/ofxTween)
Getting Started
- Write your own subclasses of ofxScene.
#include "ofxScene.h"
class FirstScene : public ofxScene {
public:
void setup();
void update();
void draw();
void exit();
}- Fill all functions you need.
void setup();
void update();
void draw();
void willFadeIn();
void willDraw();
void willFadeOut();
void willExit();
void keyPressed(int key);
void keyReleased(int key);
void mouseMoved(int x, int y);
void mouseDragged(int x, int y, int button);
void mousePressed(int x, int y, int button);
void mouseReleased(int x, int y, int button);
void windowResized(int w, int h);
void dragEvent(ofDragInfo dragInfo);
void gotMessage(ofMessage msg);- Instantiate ofxSceneManager and add scenes.
class testApp : public ofBaseApp {
public:
// definitions
ofxSceneManager sceneManager;
}void testApp::setup() {
sceneManager.addScene(ofPtr<ofxScene>(new FirstScene));
sceneManager.addScene(ofPtr<ofxScene>(new SecondScene));
}- Run the ofxSceneManager.
void testApp::setup() {
sceneManager.addScene(ofPtr<ofxScene>(new FirstScene));
sceneManager.addScene(ofPtr<ofxScene>(new SecondScene));
sceneManager.run();
}
void testApp::update() {
sceneManager.update();
}
void testApp::draw() {
sceneManager.draw();
}Functionality
Transition
ofxSceneManager supports two types of transition.- Transition when you trigger. (default)
- Transition after certain period of time.
void testApp::setup() {
sceneManager.addScene(ofPtr<ofxScene>(new FirstScene));
sceneManager.addScene(ofPtr<ofxScene>(new SecondScene));
sceneManager.setExitByTime(false); // You don't need this line since it's false by default.
sceneManager.setSceneDuration(0.3, 0.3); //fade-in, fade-out time.
}
void testApp::keyPressed(int key){
if (key == ' ') {
sceneManager.changeScene();
}
}void testApp::setup() {
sceneManager.addScene(ofPtr<ofxScene>(new FirstScene));
sceneManager.addScene(ofPtr<ofxScene>(new SecondScene));
sceneManager.setExitByTime(true);
sceneManager.setSceneDuration(0.3, 15.0, 0.3); //fade-in, drawing, fade-out time respectively.
}Call ofxSceneManager::changeScene() to change scenes.
Fading
ofxSceneManager does fading by default, and the background color while transition is a default color of oF. If you want another color or a picture as a background, you can change intestApp::draw();void testApp::draw() {
ofBackground(255, 255, 0);
sceneManager.draw();
}Data Passing
You have two kinds of setup(). ofxSceneManager calls one you implement. void setup()
void setup(ofPtr<ofxScene> previousScene)If a scene needs data of a previous scene, implement ``
void setup(ofPtr<ofxScene> previousScene)` instead of `void setup()`. You can get data as public variables of the previous scene.
void SecondScene::setup() {
}
void SecondScene::setup(ofPtr<ofxScene> previousScene) {
}
Note: If you implement both, only `setup()` will be called and `setup(ofPtr<ofxScene> previousScene)`` will be ignored. Get this addon
Latest release
- Add example-Advanced.
- Add default event handlers such as mousePressed to ofxScene.