www.pudn.com > malic.rar > README_JP


malic var0.0.1

----------------------------------------------------------------------
malicsaver
----------------------------------------------------------------------
カメラの前に顔が在るか否かによってスクリーンセーバを起動させたり
元の画面に復帰させたりするプログラムです。

xscreensaver を立ち上げておく必要があります。
$ xscreensaver &
等としてください。

また
.xscreensaver の
unfade を True に
また、
.bash_profile 等に
xscreensaver &
と書いて xscreensaver をログイン時に自動で起動させることを勧めます。

----------------------------------------------------------------------
malicrecog
----------------------------------------------------------------------
顔部品の位置を認識するプログラムです。
顔の位置を認識するのには OpenCV の haarcascade を使用しています。
データファイルは malic/data/ 以下にありますが指定する必要はありません。


使用例

# 初めて使用する場合 (skin データと gaborrg_jet ファイルを取ってくる必要があります。)

$ malicskinconfig # skin データの設定

# jet データファイルを持っていない場合 doc から取ってくる。
$ cp malic/doc/sample_gaborrg_jet.xml gaborrg_jet.xml
$ cp malic/doc/sample_gaborrg_jet.xml.masks gaborrg_jet.xml.masks

$ malicrecog -j gaborrg_jet.xml -m gaborrg_jet.xml.masks
もしくは
$ malicrecog     # デフォルトの gaborrg_jet ファイルが読み込まれます。
で起動して下さい。

# 2回目以降は
$ malicrecog -j gaborrg_jet.xml -m gaborrg_jet.xml.masks
もしくは
$ malicrecog     # デフォルトの gaborrg_jet ファイルが読み込まれます。
だけで起動できます。

malicrecog [options]
  -j filename, --jet  filename     jet ファイルを引数に取ります
                                   (default gaborrg_jet.xml)

  -m filename, --mask filename     set jet mask ファイルを引数にとります
                                   (default gaborrg_jet.xml.masks)

  -h, -?, --help                   ヘルプを表示します

jet file,
jet mask file, 
のデータを基に顔部品の位置を判断します。
-j -m オプションを指定しない時はそれぞれ gaborrg_jet.xml gaborrg_jet.xml.masks が
デフォルトで読み込まれます。


----------------------------------------------------------------------
malicsampling
----------------------------------------------------------------------
画面の場所ごとのガボールフィルターをかけた値をクリックで得るためのプログラムです。
最終的にファイルにxml形式でファイルに出力します。
USBカメラを継いだ状態でしか動作しません。

操作説明
(動画画面内)
右クリック: 停止、再生
左クリック: 停止&クリックした位置のガボールフィルターデータの収集

(右上スクロールウィンドウ)
-- (画面を止めてガボールフィルターデータを生成するとクリック可能になります。)
parts
得た値がどの顔パーツ(鼻や口など)かの設定
Enter ボタン
parts ボタンで設定した値を一時スタックに確保

(右下スクロールウィンドウ)
data type
gabor_mag: Malib の GaborRg による gabor magnitude のみからなるデータ
           将来 Malib に gabor phase の機能を作る可能性もあるため参考のために残してある
jet      : csuFaceIdEval を利用した gabor magnitude と gabor phase からなるデータ
           デフォルト

Save ボタン
Enter ボタン でスタックに確保した値を xml 形式でファイルに出力
data save xml file name
データをxml 形式で出力する先のファイル名
Browse
ファイル選択ダイアログの起動

#------------------------------------------------------------#
チュートリアル

USBカメラを繋ぐ
#.src ディレクトリに移動してgaborrg_maker を起動。
#.起動できたら左側に動画が表示されるはずなので顔をあわせて右クリックで停止。
  目や鼻の位置などで左クリックする。
#.画面をクリックした場所が目の位置なら右側のウィンドウのright_eye
 ボタンをクリックして値をセットする。
#.順次動画画面の顔部品(左目の位置等)をクリックしては、右側のウィンドウの
 対応するパーツ名をクリックして値をセットしていく。
#.全部(でなくてもいいが)のパーツに値をセットしたら、Enter ボタンをクリック
 一時バッファ(スタック)にデータがセーブされる(まだファイルには出力されていない)。
#.一時バッファ(スタック)にデータをセーブしたらsave ボタンを押して
 ファイルにセーブ(上書きのみ!)するか
 再び画面を再生して別の顔の向きのデータを集めるなりしていく。

#---------------------------------------------------------------#
注意!
#.USBカメラをつないだ状態でしか動作しません。 
#.まだパーツ名の構成などを初期設定ファイルから設定できるようになっていません
 (今後作ります)
# malicsampling の save はすでにファイルが存在する場合はデータ追加でセーブされます。
  既存のデータを一旦消去したいときはファイルを消去して下さい


#---------------------------------------------------------------------
# for developers
#----------------------------------------------------------------------
# ディレクトリ & ファイル構成
malic 
      |-- src (プログラムファイル群)
      |     |
      |     |-- csu (csuFaceIdEval のファイル群)
      |     |
      |     |-- gnodempa (肌色認識アプリケーション gnodempaのファイル群)
      |    
      |
      |-- glade_gui_src  (GUI インターフェース生成ツール glade で生成したファイル群)
      
malic/malic.glade
が Gtk インターフェース 生成ツール glade に与えるデータファイルです。
インターフェイスを編集したい場合は
$ glade malic.glade
のようにします。