Multi Touch In DAT

概要

Multi Touch In DATは、Windows7以降の標準マルチタッチAPIからメッセージとイベントを受信するために使用されます。 すべてのメッセージをキャプチャし、新しいメッセージごとに出力するテーブルを変更します。 メッセージがDATに追加されると、新しいメッセージを指す任意のスクリプトを呼び出すことができます。 Multi Touch In DATは、最も頻繁にRender Pick DATに送信されます。
次の2つのテーブル形式のいずれかを出力できます。(1)生のイベントをFIFO(first in – first out)リストとして、または(2)IDテーブル。これは、より使いやすいone-row-per-fingerのテーブルに処理されるイベントです。
Raw Eventsフォーマットでは、FIFOタイプのDAT(FIFO DATも参照)が作成され、マルチタッチイベントごとにテーブルの下部に行が追加され、同時に上部の行が削除されます。

注意:Windows 7、8、または10のイベントストリームを介してイベントを送信するマルチタッチスクリーンでパネルガジェットを操作するには、DATを必要とせずにマルチタッチが機能します。 オブジェクトを選択する3Dレンダリングを表示するコンテナのように、1つのパネルで複数の指を使用する場合は、DATを使用する必要があります。
IDテーブル形式には、次の列が含まれます。

  • id
    指を押すたびにIDが1増えます。
  • sn
    各指のプレスの継続的なカウント。
  • select
    1の場合、この行は指が下がっていることを表します。
  • downf
    指で押したときの絶対フレーム番号。
  • upf
    指のプレスが終了した絶対フレーム番号。
  • x, y
    水平方向と垂直方向のピクセル単位の位置。 注:x値とy値は、パネルの幅/高さのピクセルではなく、画面のピクセルで表されます。 たとえば、パネルが別のパネル、ウィンドウ、またはネットワークビューア内で拡大縮小されている場合、パネルの右上隅は異なります。 uとvを使用し、パネルの幅と高さでスケーリングすることをお勧めします。
  • u, v
    位置、水平・垂直方向に0~1
  • downu, downv
    最初にタッチしたときの水平方向と垂直方向の位置(最初にタッチダウンした位置)を0から1までの範囲で指定します。
  • contactx, contacty
    接触領域の幅との高さ。contactu、contactv
  • monitor
    0から始まるモニター番号
  • clicktime
    クリック回数。downfのように、数秒で
  • elapsedtime
    指がダウンしている秒数。
  • changedtime
    指で押してから最新のuまたはv値が変更された時間。
  • dclick
    ダブルタップの発生
  • aux
    イベントは、PanelCOMP_Class メソッド interactTouch() を介してユーザが提供したデータを使用します。 Include Mouse オプションを使用してイベントがマウスによってトリガーされると、auxには使用されるマウスボタンが含まれます(左に1、中央に2、右に4、ビット単位でテストできます)。

添付のcallback DAT(`mtouchin1_callbacks`という名前)を使って、マルチタッチイベントに反応させることができます。これはRender Pick DATを必要としない2Dインターフェースに適しています。
パレットのToolsの下にあるmultiTouchの例を参照してください。
MultiTouch の章も参照してください。

パラメータ – Multi Touch In ページ
Active / active

ActiveがOnの時のイベントを登録します。

Output / outputtype

テーブルでの出力の表示方法を設定します。

  • Raw Events / log
    イベントは、first in – first out(FIFO)の順序でテーブルに追加されます。
  • ID Table / changes
    イベントは、テーブル内のone-row-per-fingerを使って処理されます。
Panel / panel

タッチイベントをキャプチャするパネルコンポーネントを設定します。

Relative IDs / relativeid

指定したパネル内のタッチIDのみがカウントされるように、タッチIDを並べ替えます。

Relative Position / relativepos

指定したパネルの左下隅を基準とした位置と正規化された座標を出力します。

Include Mouse / mouse

オンにすると、マウスがクリックされたときにタッチイベントを追加します。このイベントは常に最初のタッチと ID 1 を共有します。マウスとマルチタッチを同時に使用すると、予期せぬ動作をすることがあります。

Position Threshold / posthresh

指の移動がこの単位数よりも少ない場合、新しいメッセージは追加されません。単位は入力デバイスによって決定され、必ずしもそれに関連付けられた画面の解像度ではありません。

Contact Threshold / contactthresh

タッチデバイスの中には、指の接触量の圧力を表すプレスの幅と高さを持っているものがあります。これは、イベントが認識されない最小のしきい値を設定します。

Min Rows Displayed / minrows

テーブルに常に表示される行数の最小値を設定します。

Double Click (secs) / doubleclickthresh

クリック間の最大許容時間を設定して、ダブルクリックとして登録します。

パラメータ – Received Messages ページ
Callbacks DAT / callbacks

コールバックを含む DAT へのパスを設定します。

Execute from / executeloc

スクリプトが実行される場所を設定します。

  • Current Node / current
    スクリプトは現在のノードの位置から実行されます。
  • Callbacks DAT / callbacks
    スクリプトは、Callbacks DATパラメータで指定されたDATの場所から実行されます。
  • Specified Operator / op
    スクリプトは、以下のFrom Operatorパラメータで指定したオペレータから実行されます。
From Operator / fromop

Execute FromパラメーターがSpecified Operatorに設定されている場合に実行されるスクリプトのパスを設定します。

Clamp Output / clamp

DATはデフォルトで100メッセージに制限されていますが、Clamp Outputでは無制限を含む任意の設定が可能です。

Maximum Lines / maxlines

メッセージ数を制限し、古いメッセージはリストから最初に削除されます。

Clear Output / clear

見出し以外の行をすべて削除します。スクリプトコマンドでクリアするには、次のような例があります。: `opparm -c /serial1 clear`

パラメータ – Common ページ

参照:共通 Common ページ