イメージマスク

イメージマスクは、白黒画像を使ってキャンバスゾーン内の除外領域を指定する機能です。このページでは、画像ファイルの選択、しきい値（threshold）、白黒反転（invert）、領域の拡縮（choke_m）の使い方を説明します。

イメージマスクとは

ポリゴンマスクが多角形で除外範囲を囲むのに対し、イメージマスクは 白黒画像の濃淡 で除外する場所を決めます。輪郭が複雑で多角形では追い込みにくい形状や、CAD・グラフィックソフトで正確に作った型をそのまま使いたい場合に向いています。

既定では 黒 = 除外 / 白 = 通過 です。つまり、画像の黒い部分に重なった範囲が検出対象から外れ、白い部分は通常どおり検出されます。

対応する画像形式は PNG / JPEG / BMP です。

イメージマスクは、メインタブのビューワー画面で、対象ゾーンの配下に追加します。

メインタブを開き、パラメータパネルのゾーン一覧から、マスクを置きたいキャンバスゾーンを展開します。
ゾーン配下の イメージマスク セクションにある 「+」 を押します。
ファイル選択ダイアログで、白黒画像（PNG / JPEG / BMP）を選びます。
選んだ画像は自動的に設定フォルダ内の li-touch/masks/ にコピーされます。元ファイルを移動・削除しても、LiTouch 側のマスクはコピーを参照し続けます。
ゾーンの範囲に画像が当てはめられ、黒い部分が除外領域として反映されます。

パラメータ	意味	範囲	初期値
threshold	白黒を判定するしきい値	0〜1	0.5
invert	白黒（除外/通過）を反転	—	オフ
choke_m	除外領域の拡縮（メートル単位）	—	0.0

threshold は、画像の各画素を「黒（除外）」と「白（通過）」のどちらに振り分けるかの境界です。画素の明るさがこのしきい値より暗ければ除外、明るければ通過になります。

invert をオンにすると、黒と白の役割が入れ替わります。既定は「黒 = 除外 / 白 = 通過」ですが、反転すると「白 = 除外 / 黒 = 通過」になります。

手元の画像が「残したい部分を黒、除外したい部分を白」で作られている場合などに、画像を作り直さずに invert で合わせられます。

choke_m は、除外領域の輪郭を メートル単位 で広げたり縮めたりします。マスクの境界ぎりぎりで検出が出てしまう、あるいは除外しすぎている、といった微調整に使います。

単純な柱や什器ならポリゴンマスクが手軽です。曲線が多い、あるいは図面・デザインデータから正確な型を流用したい場合はイメージマスクが適しています。両方を同じゾーンに併用することもできます。