2019-01-16 13:12:07 +00:00
|
|
|
/**
|
|
|
|
* @author Richard Davey <rich@photonstorm.com>
|
2022-02-28 14:29:51 +00:00
|
|
|
* @copyright 2022 Photon Storm Ltd.
|
2019-05-10 15:15:04 +00:00
|
|
|
* @license {@link https://opensource.org/licenses/MIT|MIT License}
|
2019-01-16 13:12:07 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The Game Object Out Input Event.
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* This event is dispatched by the Input Plugin belonging to a Scene if a pointer moves out of _any_ interactive Game Object.
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* Listen to this event from within a Scene using: `this.input.on('gameobjectout', listener)`.
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* To receive this event, the Game Objects must have been set as interactive.
|
2019-01-18 15:20:56 +00:00
|
|
|
* See [GameObject.setInteractive]{@link Phaser.GameObjects.GameObject#setInteractive} for more details.
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-18 15:20:56 +00:00
|
|
|
* To listen for this event from a _specific_ Game Object, use the [GAMEOBJECT_POINTER_OUT]{@linkcode Phaser.Input.Events#event:GAMEOBJECT_POINTER_OUT} event instead.
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* The event hierarchy is as follows:
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-18 15:20:56 +00:00
|
|
|
* 1. [GAMEOBJECT_POINTER_OUT]{@linkcode Phaser.Input.Events#event:GAMEOBJECT_POINTER_OUT}
|
|
|
|
* 2. [GAMEOBJECT_OUT]{@linkcode Phaser.Input.Events#event:GAMEOBJECT_OUT}
|
|
|
|
* 3. [POINTER_OUT]{@linkcode Phaser.Input.Events#event:POINTER_OUT}
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* With the top event being dispatched first and then flowing down the list. Note that higher-up event handlers can stop
|
|
|
|
* the propagation of this event.
|
|
|
|
*
|
2021-12-01 17:41:46 +00:00
|
|
|
* If the pointer leaves the game canvas itself, it will not trigger an this event. To handle those cases,
|
|
|
|
* please listen for the [GAME_OUT]{@linkcode Phaser.Input.Events#event:GAME_OUT} event.
|
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* @event Phaser.Input.Events#GAMEOBJECT_OUT
|
2022-09-21 21:01:03 +00:00
|
|
|
* @type {string}
|
2019-02-12 11:37:58 +00:00
|
|
|
* @since 3.0.0
|
2021-12-01 17:41:46 +00:00
|
|
|
*
|
2019-01-16 13:12:07 +00:00
|
|
|
* @param {Phaser.Input.Pointer} pointer - The Pointer responsible for triggering this event.
|
|
|
|
* @param {Phaser.GameObjects.GameObject} gameObject - The Game Object the pointer moved out of.
|
2019-05-09 11:02:03 +00:00
|
|
|
* @param {Phaser.Types.Input.EventData} event - The Phaser input event. You can call `stopPropagation()` to halt it from going any further in the event flow.
|
2019-01-16 13:12:07 +00:00
|
|
|
*/
|
|
|
|
module.exports = 'gameobjectout';
|