指定位置にあるタッチ可能なエンティティを探す
指定位置にあるタッチ可能なエンティティを探すには、g.Scene#findPointSourceByPoint()
を利用します。
凡例
javascript
// 指定座標上にタッチ可能なエンティティが存在する場合は、戻り値の target プロパティにエンティティが格納される。
var pointSource = scene.findPointSourceByPoint({ x: 10, y: 10 });
if (pointSource.target) {
// 指定された座標にエンティティが存在した場合。pointSource.target は見つかったエンティティ
} else {
// 存在しなかった場合
}
利用例
次のコンテンツは、画面中央の十字の位置にあるタッチ可能なエンティティを毎フレーム探し、見つかる度にそのエンティティの cssColor
プロパティをランダムな色に変更します。
詳細
g.Scene#findPointSourceByPoint()
はシーン内で引数に渡された座標にあるタッチ可能なエンティティのうち、もっとも手前にあるエンティティを戻り値の target
プロパティに格納して返します。対象が存在しない場合は target
プロパティが undefined
になります。
g.Scene#findPointSourceByPoint()
の第二引数 に true
を渡すと、タッチ可能でないものを含めてもっとも手前にあるエンティティを探します。