Cinderでの実験のお供にパラメータパネル

Cinder
Cinderでの実験のお供にパラメータパネル

2011.04.19 | kaminaly
どやさ、kaminalyです。
Cinderではデバッグや実験用に結果画面を見ながら
パラメータの変更ができるパネルを簡単に設置できる。
※AntTweakBarというライブラリをラップしている。
わたくしは、パラメータ以外に、
fpsとかベンチマークの結果とか簡単なトレースを常に表示するようにしています。
view source
print?
001 ヘッダファイルをインクルード
002 #include "cinder/params/Params.h"
003  
004 ヘッダにパネルの変数定義
005 ci::params::InterfaceGl mParams;
006  
007 セットアップなどで
008 void PracticeApp::setup()
009 {
010     //パネル生成（引数：パネル名、サイズ）
011     mParams = params::InterfaceGl( "Paramaters", Vec2i( 200, 200 ) );
012     //変更したいパラメータ追加（引数：パラメータ名、変数、オプション、readonly）
013     mParams.addParam( "param name", &#038;var[, "option", false] );
014     //区切りを追加（引数：パラメータ名、オプション）
015     mParams.addSeparator(["separator name", "option"]);
016 }
017 ※日本語は文字化けする。
018 ※addParamで渡せる変数の型
019     bool, float, int32_t, Vec3f, Quatf, Color, ColorA, std::string, std::vector<std::string>
020  
021 引数で渡すオプションで色々設定できる。オプションについては後で。
022  
023 描画の最後に
024 void PracticeApp::draw()
025 {
026     //色々描画
027     //色々描画
028     //色々描画
029  
030     //パネルの描画
031     params::InterfaceGl::draw();
032 }
033  
034 以上でOK。わぉ！簡単！
035  
036 オプションについて
037 最小値／最大値とか、変化量とか、keyイベントとか
038 色々設定できます。
039  
040 フォーマットは
041 "min=0.0f max=20.0f step=0.5f keyIncr=x keyDecr=X"
042 param=valueをスペース区切りで複数設定できます。
043  
044 種類
045 min=value
046 最小値設定（数値の変数のみ）
047  
048 max=value
049 最大値設定（数値の変数のみ）
050  
051 step=value
052 変更量の粒度（数値の変数のみ）
053  
054 key=string
055  
056 keyincr=string
057 ショートカットキーでstep分足す
058  
059 keydecr=string
060 ショートカットキーでstep分引く
061  
062 ※ショートカットに指定できるもの
063     a,A,1,#, などキーボードで打てる文字
064     SPACE (or ' ')
065     BACKSPACE (or BS)
066     TAB
067     CLEAR (or CLR)
068     RETURN (or RET)
069     PAUSE
070     ESCAPE (or ESC)
071     DELETE (or DEL), INSERT (or INS)
072     UP, DOWN, RIGHT, LEFT
073     HOME, END
074     PGUP, PGDOWN
075     F1, F2,..., F15
076  
077 ※+でつなげて指定するもの
078     SHIFT
079     ALT
080     CTRL
081         例、CTRL+a, ALT+F1, SHIFT+ALT+F1
082         ※SHIFTとCTRLはキーボードで打てる文字と一緒には使わない方が良い。
083         SHIFT+a → A, CTRL+a..z → ASCII codeの1〜26に置き換えるべき？
084  
085 label=string
086 ラベルつける
087  
088 help=string
089 ヘルプ用の文字列。配布する時とか。
090  
091 group=string
092 同じグループの
093  
094 visible=bool
095 欄を表示したり消したり
096  
097 readonly=bool
098 変更出来なくなる
099  
100 precision=value（double型の変数のみ）
101 小数点以下何桁まで使うか
102 0〜12が指定できます。
103 -1を指定すると無効になります。
104 precisionが定義されず、stepが定義されている場合は
105 stepの値を元に定義されます。
106  
107 hexa=bool（integer型の変数のみ）
108 16進数で表示
109  
110 true=string（boolean型の変数のみ）
111 false=string（boolean型の変数のみ）
112 表示される文字を設定する
113 例、"true=Yes! false='No !!'"
114  
115 opened=bool(groupのみ)
116 グループを開いたり閉じたり
117  
118 enum='const1 {label1} , const2 {label2} , ...'(enum型の変数のみ)
119 cinderではつかえないのでノー説明
120  
121 coloralpha=bool（ColorA型の変数のみ）
122 アルファの有効無効
123  
124 colororder=rgba（ColorA型の変数のみ）
125 colororder=argb（ColorA型の変数のみ）
126 OpenGL and Direct3D10はrgba、Direct3D9はargbのフォーマットのようです。
127  
128 colormode=rgb（Color型の変数のみ）
129 colormode=hls（Color型の変数のみ）
130 値をRGB(Red Green Blue) かHLS(Hue Lightness Saturation)のどちらとして使うか指定できる 。
131  
132 arrow='x y z'（Quatf型の変数のみ）
133 arrow=0（Quatf型の変数のみ）
134 3Dの矢印を表示
135 値がゼロの場合0リセット
136  
137 arrowcolor='r g b'（Quatf型の変数のみ）
138 矢印の色を変える
139  
140 axisx=n（Quatf型の変数のみ）
141 axisy=n（Quatf型の変数のみ）
142 axisz=n（Quatf型の変数のみ）
143 左手系のなにか
144  
145 showval=bool（Quatf型の変数のみ）
146 数値を表示