マウストリガー

マウストリガー（mouse trigger）を使用すると、マウスボタンやスクロールホイールからの入力をゲームのアクションにバインドできます。

マウスボタン

マウスボタンは pressed、released、repeated イベントを生成します。次の例は、マウスの左ボタンが押された、または離されたことを検出する方法を示しています。

function on_input(self, action_id, action)
    if action_id == hash("mouse_button_left") then
        if action.pressed then
            -- left mouse button pressed
        elseif action.released then
            -- left mouse button released
        end
    end
end

マウスホイール

マウスホイール入力はスクロール操作を検出します。ホイールがスクロールされた場合、action.value フィールドは 1 になり、それ以外の場合は 0 になります。（スクロール操作は、ボタンを押す操作と同じように扱われます。現在、Defold はタッチパッドでの細かなスクロール入力をサポートしていません。）

function on_input(self, action_id, action)
    if action_id == hash("mouse_wheel_up") then
        if action.value == 1 then
            -- mouse wheel is scrolled up
        end
    end
end

マウスの移動

マウスの移動は別個に処理されます。入力バインディング（input binding）に少なくとも1つのマウストリガーを設定しない限り、マウスの移動イベントは受信されません。

マウスの移動は入力バインディングではバインドされませんが、action_id は nil に設定され、action テーブルにはマウスの位置と移動量が格納されます。

function on_input(self, action_id, action)
    if action.x and action.y then
        -- let game object follow mouse/touch movement
        local pos = vmath.vector3(action.x, action.y, 0)
        go.set_position(pos)
    end
end

タッチトリガー

シングルタッチ型とマルチタッチ型のトリガーは、iOS および Android デバイスのネイティブアプリケーションと HTML5 バンドルで使用できます。

シングルタッチ

シングルタッチ型のトリガーは、入力バインディングの Touch Triggers セクションでは設定しません。代わりに、 MOUSE_BUTTON_LEFT または MOUSE_BUTTON_1 のマウスボタン入力を設定すると、シングルタッチトリガーが自動的に設定されます。

マルチタッチ

マルチタッチ型のトリガーは、アクションテーブル内の touch というテーブルにデータを格納します。このテーブルの要素には、1–N の整数インデックスが付けられます。N はタッチ点の数です。テーブルの各要素には、入力データを持つフィールドが含まれます。

function on_input(self, action_id, action)
    if action_id == hash("touch_multi") then
        -- Spawn at each touch point
        for i, touchdata in ipairs(action.touch) do
            local pos = vmath.vector3(touchdata.x, touchdata.y, 0)
            factory.create("#factory", pos)
        end
    end
end

オブジェクトのクリックやタップの検出

表示されるコンポーネント（component）をユーザーがクリックまたはタップしたことを検出するのは、多くのゲームで必要になる、ごく一般的な操作です。ボタンなどの UI 要素への操作や、ストラテジーゲームでプレイヤーが操作するユニット、ダンジョン探索ゲームのレベル内にある宝物、RPG でクエストを依頼するキャラクターといったゲームオブジェクト（game object）への操作が考えられます。使用する方法は、表示するコンポーネントの種類によって異なります。

GUI ノードへの操作の検出

UI 要素には gui.pick_node(node, x, y) 関数を使用できます。この関数は、指定した座標が GUI ノード（GUI node）の範囲内にあるかどうかに応じて true または false を返します。詳細は、API ドキュメント、ポインターを重ねる例、ボタンの例を参照してください。

ゲームオブジェクトへの操作の検出

ゲームオブジェクトの場合は、カメラの平行移動やレンダースクリプト（render script）の投影などが必要な計算に影響するため、操作の検出がより複雑になります。ゲームオブジェクトへの操作を検出するには、大きく分けて2つの方法があります。

1. ユーザーが操作できるゲームオブジェクトの位置とサイズを追跡し、マウスまたはタッチの座標がいずれかのオブジェクトの範囲内にあるかを確認します。
2. ユーザーが操作できるゲームオブジェクトにコリジョンオブジェクト（collision object）を取り付け、マウスまたは指に追従するコリジョンオブジェクトを1つ用意し、それらの間の衝突を確認します。

どちらの場合も、マウスまたはタッチイベントのスクリーン座標と、ゲームオブジェクトのワールド座標の間で変換する必要があります。これにはいくつかの方法があります。

• レンダースクリプトが使用するビューと投影を手動で追跡し、それらを使ってワールド空間との間で座標を変換します。カメラマニュアルの例を参照してください。
• サードパーティーのカメラ実装を使用し、提供されているスクリーン座標からワールド座標への変換関数を利用します。