LiTouch マニュアル

LiTouch は、Hokuyo製のLiDAR（測域センサ）から得た距離データを処理して、タッチ座標やプレイヤーの位置・動きを検出し、OSC / UDP で外部ソフト・機器に送信するデスクトップツールです。プロジェクションマッピング、インタラクティブな床・壁面、インスタレーションなどで利用します。

このマニュアルは、現場でLiTouchをセットアップ・調整・運用するオペレーター向けの操作ガイドです。

はじめての方へ

クイックスタート センサ接続からOSC送信まで、最短の流れを一気に体験する。

画面構成とUI タブ・サイドバー・ビューワーなど、画面の見方を把握する。

やりたいことから探す

センサをつなぐ・並べる

センサの接続 → アライン（配置調整） → 背景キャプチャ。複数台はマージで1つの座標系に統合します。

検出を調整する

ブロブ検出とトラッキングのパラメータで、「複数人が1つに見える」「IDが入れ替わる」などを解決します。プリセットも活用。

ゾーンとマスクを作る

検出範囲をキャンバスゾーンで区切り、ポリゴンマスクやイメージマスクで柱・什器などを除外します。

OSC / トリガーで送る

OSC送信先を設定し、テスト送信で受信側を確認。ゾーンの出入りで外部機器を動かすUDPトリガーも。

本番運用する

本番モードで描画負荷を抑え、システム状態とログで監視。長時間運用の備えも解説します。

困ったときは

トラブルシューティングで典型的な不具合と対処を確認。パラメータ一覧やOSC仕様もリファレンスにあります。