パラメータプリセット

このページでは、メインタブのパラメータパネル上部にある プリセットバー の使い方を説明します。プリセットは、ブロブ検出とトラッキングの設定をまとめて保存・適用する仕組みです。

検出対象（細い棒・手・人体など）が決まっている場合は、ビルトインプリセットを適用してから微調整すると、ゼロから値を詰めるより早く目的の検出にたどり着けます。

ビルトインプリセット

最初から 3 種類のプリセットが用意されています。用途に近いものを選んで適用してください。

プリセット	想定する検出対象
細い棒（2cm）	ペンや細い棒など、ごく小さなタッチ点
手	手のひら・指によるタッチ
人体（全身）	床面などで人そのものを検出するインスタレーション

ノート

ビルトインプリセットは、ブロブ検出の cluster_distance や min_blob_radius、トラッキングの max_match_distance やスムージングなどを、対象の大きさ・速さに合わせて一括で設定します。適用後の値はそのまま手動で微調整できます。

プリセットの適用

1. パラメータパネル上部のプリセットのドロップダウン（「プリセット…」）を開きます。
2. 一覧からプリセットを選びます。
3. 選んだ瞬間に、ブロブ検出とトラッキングの設定がそのプリセットの値に置き換わります。
4. ビューワーで検出の様子を見ながら、必要に応じて各パラメータを微調整します。

注意

プリセットを適用すると、現在のブロブ検出・トラッキングの設定はプリセットの値で上書きされます。今の設定を残したい場合は、適用する前に「新規保存」で別名のプリセットとして保存しておいてください。

新規保存

現在の調整結果を、自分のプリセットとして保存できます。

1. プリセットバーの保存ボタン（ディスクアイコン）を押します。
2. 名前の入力欄が現れるので、プリセット名を入力します。
3. 確定すると、現在のブロブ検出・トラッキング設定がその名前で保存されます。
4. 以降はドロップダウンからいつでも呼び出せます。

ヒント

ビルトインと同じ名前で保存すると、その内容で上書き表示されます。現場ごとに「会場A_手」のような分かりやすい名前を付けておくと、再来場時にすぐ復元できます。

削除

不要になった自作プリセットは削除できます。

1. ドロップダウンで削除したいプリセットを選びます。
2. プリセットバーの削除ボタン（ゴミ箱アイコン）を押します。

エクスポート / インポート（TOML）

プリセットは TOML ファイルとして書き出し・取り込みができます。別の PC や現場へ設定を持ち運ぶときに使います。

1. エクスポート: ドロップダウンで対象のプリセットを選び、エクスポートボタン（書き出しアイコン）を押します。保存先とファイル名（.toml）を指定すると、そのプリセットの内容がファイルに書き出されます。
2. ファイルを USB メモリやネットワーク経由で別の PC に渡します。
3. インポート: 取り込み先で、インポートボタン（読み込みアイコン）を押し、受け取った .toml ファイルを選びます。
4. 取り込んだプリセットがドロップダウンに追加され、選択した状態になります。

ノート

ここで扱うのは、ブロブ検出・トラッキング設定だけをまとめた プリセット単位 の TOML ファイルです。センサや OSC など、アプリ全体の設定をまとめて持ち運ぶ場合は、設定タブの設定エクスポート / インポートを使います（ログ出力などと同じ設定タブにあります）。

関連ページ

• ブロブ検出パラメータ — プリセットが設定するブロブ側の値
• トラッキングパラメータ — プリセットが設定するトラッキング側の値
• パラメータ一覧 — 全パラメータの初期値・範囲のリファレンス