ofxUI: A User Interface Addon for OF を使うと openFrameworks に ofxControlPanel よりもちょっとかっこいい UI を追加することができます。github のページ の Readme を超訳してみました。
ダウンロードページから ofxUI をダウンロード。中の
src
をof/addons
の中に移して、名前をofxUI
にします。残りはof/apps
に移してofxUIExamples
などとします。すると以下のようなファイル構成になります。of |--- addons | |--- ofxUI | |--- ofxUI.h | |--- ... | |--- apps | |--- addonExamples | |--- examples | |--- myapps | |--- ofxUIExamples | |--- example-ofxUIAllWidgets | |--- ... |--- …
of/apps/examples/emptyExample
をof/apps/myapps
以下にコピーして新しいプロジェクトを作ります。新しく作ったプロジェクトを Xcode で開きます。
Xcode の左側の
addons
のところに Finder からof/addons/ofxUI
をドラッグアンドドロップします。"Choose options for adding these files" と聞かれたら、何もせず "finish" を押します。
of/addons/ofxXmlSettings
も同様に Xcode のaddons
フォルダに追加。このアドオンは XML ファイルに設定を保存して読み出すのに使われます。Finder で
of/apps/ofxUIExamples/example-ofxUIAllWidgets/bin/data/GUI
をコピーし、プロジェクトのbin/data
に入れます。アプリのヘッダファイル(testApp.h)で "ofxUI.h" を include します。
ヘッダに続けて以下の変数と関数を追加。
ofxUICanvas *gui; void exit(); void guiEvent(ofxUIEventArgs &e);
実装ファイルにメソッドを追加します。
void testApp::exit() { } void testApp::guiEvent(ofxUIEventArgs &e) { }
setup()
の中で初期化。引数は GUI の左上の点の座標と幅と高さです。gui = new ofxUICanvas(0,0,320,320); //ofxUICanvas(float x, float y, float width, float height)
exit()
はアプリの終了前に呼ばれます。ここでは設定の保存と gui オブジェクトの破棄を行います(変数がポインタなので参照先を解放しないとメモリリーク)。void testApp::exit() { gui->saveSettings("GUI/guiSettings.xml"); delete gui; }
GUI にウィジェット(UI 部品のこと)を追加する。最後から二番目の行は、リスナー/コールバックを追加することで、ウィジェットがユーザに操作されたときに何をすればいいか GUI に教えています。よくわからなくても気にしない。また、最後の行は GUI に XML に保存された設定を読み込んでいます。ファイルがなければ、ウィジェットのデフォルトの値が使用されます。
gui->addWidgetDown(new ofxUILabel("OFXUI TUTORIAL", OFX_UI_FONT_LARGE)); gui->addWidgetDown(new ofxUISlider(304,16,0.0,255.0,100.0,"BACKGROUND VALUE")); ofAddListener(gui->newGUIEvent, this, &testApp::guiEvent); gui->loadSettings("GUI/guiSettings.xml");
ユーザが UI を操作したときに呼ばれます。操作されたウィジェットに関する処理を書きましょう。
void testApp::guiEvent(ofxUIEventArgs &e) { if(e.widget->getName() == "BACKGROUND VALUE") { ofxUISlider *slider = (ofxUISlider *) e.widget; ofBackground(slider->getScaledValue()); } }
フルスクリーンモードとウィンドウモードを切り替えるためにトグルを追加します。
setup()
メソッドの中で他のウィジェットの後に以下を追加。もしこれをもうひとつのaddWidgetDown
の呼び出しの前に書けば、トグルはスライダーの上に置かれます。gui->addWidgetDown(new ofxUIToggle(32, 32, false, "FULLSCREEN"));
"FULLSCREEN" トグルウィジェットに対応するため、
guiEvent
メソッドにもう一つ機能を追加します。結局のところ、こんな風に見えるはず。void testApp::guiEvent(ofxUIEventArgs &e) { if(e.widget->getName() == "BACKGROUND VALUE") { ofxUISlider *slider = (ofxUISlider *) e.widget; ofBackground(slider->getScaledValue()); } else if(e.widget->getName() == "FULLSCREEN") { ofxUIToggle *toggle = (ofxUIToggle *) e.widget; ofSetFullscreen(toggle->getValue()); } }
こんな感じで他のウィジェットを置いて操作できるようにすることができます。
サンプルコードを見れば、もっと複雑なウィジェットの使い方をしらべることもできます。ここで紹介したコードもサンプルコードの中に入っているので、わからなくなったら見てみるとよいでしょう。