phaser/src/input/events/POINTER_WHEEL_EVENT.js

34 lines
1.7 KiB
JavaScript
Raw Normal View History

2019-06-05 14:30:54 +00:00
/**
* @author Richard Davey <rich@photonstorm.com>
2022-02-28 14:29:51 +00:00
* @copyright 2022 Photon Storm Ltd.
2019-06-05 14:30:54 +00:00
* @license {@link https://opensource.org/licenses/MIT|MIT License}
*/
/**
* The Pointer Wheel Input Event.
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +00:00
* This event is dispatched by the Input Plugin belonging to a Scene if a pointer has its wheel updated.
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +00:00
* Listen to this event from within a Scene using: `this.input.on('wheel', listener)`.
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +00:00
* The event hierarchy is as follows:
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +00:00
* 1. [GAMEOBJECT_POINTER_WHEEL]{@linkcode Phaser.Input.Events#event:GAMEOBJECT_POINTER_WHEEL}
* 2. [GAMEOBJECT_WHEEL]{@linkcode Phaser.Input.Events#event:GAMEOBJECT_WHEEL}
* 3. [POINTER_WHEEL]{@linkcode Phaser.Input.Events#event:POINTER_WHEEL}
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +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.
*
* @event Phaser.Input.Events#POINTER_WHEEL
* @type {string}
2019-06-05 14:30:54 +00:00
* @since 3.18.0
2022-02-28 14:29:51 +00:00
*
2019-06-05 14:30:54 +00:00
* @param {Phaser.Input.Pointer} pointer - The Pointer responsible for triggering this event.
* @param {Phaser.GameObjects.GameObject[]} currentlyOver - An array containing all interactive Game Objects that the pointer was over when the event was created.
* @param {number} deltaX - The horizontal scroll amount that occurred due to the user moving a mouse wheel or similar input device.
* @param {number} deltaY - The vertical scroll amount that occurred due to the user moving a mouse wheel or similar input device. This value will typically be less than 0 if the user scrolls up and greater than zero if scrolling down.
* @param {number} deltaZ - The z-axis scroll amount that occurred due to the user moving a mouse wheel or similar input device.
*/
module.exports = 'wheel';