画面への指の接触をシミュレート (touch.on)

宣言

タッチイベント = touch.on(横座標, 縦座標)

パラメータ

• 横座標, 縦座標
  整数型。接触させる点の、現在の回転座標系における座標

戻り値

• タッチイベント
  タッチイベントオブジェクト

説明

指を画面上の指定位置に接触させる動作をシミュレートし、このタッチ操作を制御するためのタッチイベントオブジェクトを返します
この関数の座標値パラメータは、screen.init 関数で初期化された座標系の影響を受けます
注: この関数はフィンガー id を自動的に割り当てて占有します。利用可能なフィンガー id の数には上限があります (約 30 個) 。上限を超えて touch.on または touch.tap を呼び出すと finger pool overflow エラーが発生します。フィンガー id を同時に占有しすぎないよう注意し、速やかに :off メソッドを呼び出してフィンガーを解放してください
この関数は次の形式でも呼び出せます（フィンガー ID には 1 ~ 29 の範囲の任意の数字を指定します。この形式ではフィンガー id を自身で管理する必要があります）

touch.on(フィンガー ID, 横座標, 縦座標)

例

-- 画面上の点 100, 100 に指を接触させ、一定速度で点 200, 200 までスワイプしてから離す動作をシミュレート
touch.on(100, 100):move(200, 200):off()

touch.on(1, 100, 100) -- 番号 1 の指を画面上の点 100, 100 に接触させる動作をシミュレート
touch.off(1)          -- 番号 1 の指を離す