Source: extern/input.js

  1. import register from "../util/register.js";
  3. import m_input_fact from "../intern/input.js";
  4. import m_cam_fact from "../intern/camera.js";
  5. import m_cfg_fact from "../intern/config.js";
  6. import m_cont_fact from "../intern/container.js";
  7. import m_obj_util_fact from "../intern/obj_util.js";
  8. import m_print_fact from "../intern/print.js";
  9. import m_scs_fact from "../intern/scenes.js";
  10. import * as m_vec4 from "../libs/gl_matrix/vec4.js";
  12. /**
  13.  * Low-level input device API.
  14.  * For more generic cases use {@link module:controls|sensor-based API}.
  15.  * @module input
  16.  * @local DeviceType
  17.  * @local DeviceVectorParameterSync
  18.  * @local DeviceValueParameterSync
  19.  * @local DeviceParameterAsync
  20.  * @local DeviceHMDType
  21.  * @local DeviceConfig
  22.  * @local MouseLocationCallback
  23.  * @local MouseDownWhichCallback
  24.  * @local MouseUpWhichCallback
  25.  * @local MouseWheelCallback
  26.  * @local KeyboardDownCallback
  27.  * @local KeyboardUpCallback
  28.  * @local TouchStartCallback
  29.  * @local TouchMoveCallback
  30.  * @local TouchEndCallback
  31.  * @local GyroscopeQuatCallback
  32.  * @local GyroscopeAnglesCallback
  33.  */
  35. function Input(ns, exports) {
  37. var m_input   = m_input_fact(ns);
  38. var m_cam     = m_cam_fact(ns);
  39. var m_cfg     = m_cfg_fact(ns);
  40. var m_cont    = m_cont_fact(ns);
  41. var m_obj_util= m_obj_util_fact(ns);
  42. var m_print   = m_print_fact(ns);
  43. var m_scs     = m_scs_fact(ns);
  45. var _vec4_tmp = m_vec4.create();
  46. var _vec4_tmp2 = m_vec4.create();
  48. var _splited_screen = false;
  50. var cfg_dbg = m_cfg.debug_subs;
  51. var cfg_def = m_cfg.defaults;
  53. /**
  54.  * Type of the names of the synchronous vector parameter of a device.
  55.  * @typedef {Float32Array} DeviceVectorParameterSync
  56.  */
  58. /**
  59. * Type of the names of the synchronous value parameter of a device.
  60. * @typedef {number} DeviceValueParameterSync
  61. */
  63. /**
  64.  * Type of the names of the asynchronous parameter of a device.
  65.  * @typedef {number} DeviceParameterAsync
  66.  */
  68. /**
  69.  * HMD type enum. Value of {@link module:input.HMD_WEBVR_TYPE|input.HMD_WEBVR_TYPE}.
  70.  * @typedef {number} DeviceHMDType
  71.  */
  73. /**
  74.  * Type of the names of the device config.
  75.  * @typedef {number} DeviceConfig
  76.  */
  78. /**
  79.  * Gamepad D-pad up button ID.
  80.  * @const {number} module:input.GMPD_BUTTON_12
  81.  */
  82. exports.GMPD_BUTTON_12 = m_input.GMPD_BUTTON_12;
  83. /**
  84.  * Gamepad D-pad down button ID.
  85.  * @const {number} module:input.GMPD_BUTTON_13
  86.  */
  87. exports.GMPD_BUTTON_13 = m_input.GMPD_BUTTON_13;
  88. /**
  89.  * Gamepad D-pad right button ID.
  90.  * @const {number} module:input.GMPD_BUTTON_15
  91.  */
  92. exports.GMPD_BUTTON_15 = m_input.GMPD_BUTTON_15;
  93. /**
  94.  * Gamepad D-pad left button ID.
  95.  * @const {number} module:input.GMPD_BUTTON_14
  96.  */
  97. exports.GMPD_BUTTON_14 = m_input.GMPD_BUTTON_14;
  98. /**
  99.  * Gamepad face panel up button ID.
  100.  * @const {number} module:input.GMPD_BUTTON_3
  101.  */
  102. exports.GMPD_BUTTON_3 = m_input.GMPD_BUTTON_3;
  103. /**
  104.  * Gamepad face panel down button ID.
  105.  * @const {number} module:input.GMPD_BUTTON_0
  106.  */
  107. exports.GMPD_BUTTON_0 = m_input.GMPD_BUTTON_0;
  108. /**
  109.  * Gamepad face panel right button ID.
  110.  * @const {number} module:input.GMPD_BUTTON_1
  111.  */
  112. exports.GMPD_BUTTON_1 = m_input.GMPD_BUTTON_1;
  113. /**
  114.  * Gamepad face panel left button ID.
  115.  * @const {number} module:input.GMPD_BUTTON_2
  116.  */
  117. exports.GMPD_BUTTON_2 = m_input.GMPD_BUTTON_2;
  118. /**
  119.  * Gamepad right top shoulder button ID.
  120.  * @const {number} module:input.GMPD_BUTTON_5
  121.  */
  122. exports.GMPD_BUTTON_5 = m_input.GMPD_BUTTON_5;
  123. /**
  124.  * Gamepad right bottom shoulder button ID.
  125.  * @const {number} module:input.GMPD_BUTTON_7
  126.  */
  127. exports.GMPD_BUTTON_7 = m_input.GMPD_BUTTON_7;
  128. /**
  129.  * Gamepad left top shoulder button ID.
  130.  * @const {number} module:input.GMPD_BUTTON_4
  131.  */
  132. exports.GMPD_BUTTON_4 = m_input.GMPD_BUTTON_4;
  133. /**
  134.  * Gamepad left bottom shoulder button ID.
  135.  * @const {number} module:input.GMPD_BUTTON_6
  136.  */
  137. exports.GMPD_BUTTON_6 = m_input.GMPD_BUTTON_6;
  138. /**
  139.  * Gamepad select/back button ID.
  140.  * @const {number} module:input.GMPD_BUTTON_8
  141.  */
  142. exports.GMPD_BUTTON_8 = m_input.GMPD_BUTTON_8;
  143. /**
  144.  * Gamepad start/forward button ID.
  145.  * @const {number} module:input.GMPD_BUTTON_9
  146.  */
  147. exports.GMPD_BUTTON_9 = m_input.GMPD_BUTTON_9;
  148. /**
  149.  * Gamepad left analog button ID.
  150.  * @const {number} module:input.GMPD_BUTTON_10
  151.  */
  152. exports.GMPD_BUTTON_10 = m_input.GMPD_BUTTON_10;
  153. /**
  154.  * Gamepad right analog button ID.
  155.  * @const {number} module:input.GMPD_BUTTON_11
  156.  */
  157. exports.GMPD_BUTTON_11 = m_input.GMPD_BUTTON_11;
  158. /**
  159.  * Gamepad main button ID.
  160.  * @const {number} module:input.GMPD_BUTTON_16
  161.  */
  162. exports.GMPD_BUTTON_16 = m_input.GMPD_BUTTON_16;
  163. /**
  164.  * Gamepad button.
  165.  * @const {number} module:input.GMPD_BUTTON_17
  166.  */
  167. exports.GMPD_BUTTON_17 = m_input.GMPD_BUTTON_17;
  168. /**
  169.  * Gamepad button.
  170.  * @const {number} module:input.GMPD_BUTTON_18
  171.  */
  172. exports.GMPD_BUTTON_18 = m_input.GMPD_BUTTON_18;
  173. /**
  174.  * Gamepad button.
  175.  * @const {number} module:input.GMPD_BUTTON_19
  176.  */
  177. exports.GMPD_BUTTON_19 = m_input.GMPD_BUTTON_19;
  178. /**
  179.  * Gamepad button.
  180.  * @const {number} module:input.GMPD_BUTTON_20
  181.  */
  182. exports.GMPD_BUTTON_20 = m_input.GMPD_BUTTON_20;
  183. /**
  184.  * Gamepad button.
  185.  * @const {number} module:input.GMPD_BUTTON_21
  186.  */
  187. exports.GMPD_BUTTON_21 = m_input.GMPD_BUTTON_21;
  188. /**
  189.  * Gamepad button.
  190.  * @const {number} module:input.GMPD_BUTTON_22
  191.  */
  192. exports.GMPD_BUTTON_22 = m_input.GMPD_BUTTON_22;
  193. /**
  194.  * Gamepad button.
  195.  * @const {number} module:input.GMPD_BUTTON_23
  196.  */
  197. exports.GMPD_BUTTON_23 = m_input.GMPD_BUTTON_23;
  198. /**
  199.  * Gamepad button.
  200.  * @const {number} module:input.GMPD_BUTTON_24
  201.  */
  202. exports.GMPD_BUTTON_24 = m_input.GMPD_BUTTON_24;
  203. /**
  204.  * Gamepad button.
  205.  * @const {number} module:input.GMPD_BUTTON_25
  206.  */
  207. exports.GMPD_BUTTON_25 = m_input.GMPD_BUTTON_25;
  208. /**
  209.  * Gamepad track pad ID.
  210.  * @const {number} module:input.GMPD_TRACKPAD_BUTTON
  211.  */
  212. exports.GMPD_TRACKPAD_BUTTON = m_input.GMPD_TRACKPAD_BUTTON;
  213. /**
  214.  * Gamepad trigger ID.
  215.  * @const {number} module:input.GMPD_TRIGGER_BUTTON
  216.  */
  217. exports.GMPD_TRIGGER_BUTTON = m_input.GMPD_TRIGGER_BUTTON;
  218. /**
  219.  * Gamepad grips ID.
  220.  * @const {number} module:input.GMPD_GRIPS_BUTTON
  221.  */
  222. exports.GMPD_GRIPS_BUTTON = m_input.GMPD_GRIPS_BUTTON;
  223. /**
  224.  * Gamepad grips ID.
  225.  * @const {number} module:input.GMPD_MENU_BUTTON
  226.  */
  227. exports.GMPD_MENU_BUTTON = m_input.GMPD_MENU_BUTTON;
  228. /**
  229.  * Gamepad axis.
  230.  * @const {number} module:input.GMPD_AXIS_0
  231.  */
  232. exports.GMPD_AXIS_0 = m_input.GMPD_AXIS_0;
  233. /**
  234.  * Gamepad axis.
  235.  * @const {number} module:input.GMPD_AXIS_1
  236.  */
  237. exports.GMPD_AXIS_1 = m_input.GMPD_AXIS_1;
  238. /**
  239.  * Gamepad axis.
  240.  * @const {number} module:input.GMPD_AXIS_2
  241.  */
  242. exports.GMPD_AXIS_2 = m_input.GMPD_AXIS_2;
  243. /**
  244.  * Gamepad axis.
  245.  * @const {number} module:input.GMPD_AXIS_3
  246.  */
  247. exports.GMPD_AXIS_3 = m_input.GMPD_AXIS_3;
  248. /**
  249.  * Gamepad axis.
  250.  * @const {number} module:input.GMPD_AXIS_4
  251.  */
  252. exports.GMPD_AXIS_4 = m_input.GMPD_AXIS_4;
  253. /**
  254.  * Gamepad axis.
  255.  * @const {number} module:input.GMPD_AXIS_5
  256.  */
  257. exports.GMPD_AXIS_5 = m_input.GMPD_AXIS_5;
  258. /**
  259.  * Gamepad axis.
  260.  * @const {number} module:input.GMPD_AXIS_6
  261.  */
  262. exports.GMPD_AXIS_6 = m_input.GMPD_AXIS_6;
  263. /**
  264.  * Gamepad axis.
  265.  * @const {number} module:input.GMPD_AXIS_7
  266.  */
  267. exports.GMPD_AXIS_7 = m_input.GMPD_AXIS_7;
  268. /**
  269.  * Gamepad axis.
  270.  * @const {number} module:input.GMPD_AXIS_8
  271.  */
  272. exports.GMPD_AXIS_8 = m_input.GMPD_AXIS_8;
  273. /**
  274.  * Gamepad axis.
  275.  * @const {number} module:input.GMPD_AXIS_9
  276.  */
  277. exports.GMPD_AXIS_9 = m_input.GMPD_AXIS_9;
  278. /**
  279.  * Gamepad axis.
  280.  * @const {number} module:input.GMPD_AXIS_10
  281.  */
  282. exports.GMPD_AXIS_10 = m_input.GMPD_AXIS_10;
  283. /**
  284.  * Gamepad axis.
  285.  * @const {number} module:input.GMPD_AXIS_11
  286.  */
  287. exports.GMPD_AXIS_11 = m_input.GMPD_AXIS_11;
  289. /**
  290.  * Parameter of HMD orientation quaternion.
  291.  * @const {DeviceVectorParameterSync} module:input.HMD_ORIENTATION_QUAT
  292.  */
  293. exports.HMD_ORIENTATION_QUAT = m_input.HMD_ORIENTATION_QUAT;
  295. /**
  296.  * Parameter of HMD position.
  297.  * @const {DeviceVectorParameterSync} module:input.HMD_POSITION
  298.  */
  299. exports.HMD_POSITION = m_input.HMD_POSITION;
  301. /**
  302.  * Parameter of HMD type.
  303.  * @const {DeviceValueParameterSync} module:input.HMD_WEBVR_TYPE
  304.  */
  305. exports.HMD_WEBVR_TYPE = m_input.HMD_WEBVR_TYPE;
  307. /**
  308.  * WebVR (old) desktop HMD
  309.  * @const {DeviceHMDType} module:input.HMD_WEBVR_DESKTOP
  310.  */
  311. exports.HMD_WEBVR_DESKTOP = m_input.HMD_WEBVR_DESKTOP;
  313. /**
  314.  * WebVR (old) mobile HMD
  315.  * @const {DeviceHMDType} module:input.HMD_WEBVR_MOBILE
  316.  */
  317. exports.HMD_WEBVR_MOBILE = m_input.HMD_WEBVR_MOBILE;
  319. /**
  320.  * Non-WebVR HMD
  321.  * @const {DeviceHMDType} module:input.HMD_NON_WEBVR
  322.  */
  323. exports.HMD_NON_WEBVR = m_input.HMD_NON_WEBVR;
  325. /**
  326.  * WebVR API 1.0
  327.  * @const {DeviceHMDType} module:input.HMD_WEBVR1
  328.  */
  329. exports.HMD_WEBVR1 = m_input.HMD_WEBVR1;
  331. /**
  332.  * WebVR API 1.1
  333.  * @const {DeviceHMDType} module:input.HMD_WEBVR1_1
  334.  */
  335. exports.HMD_WEBVR1_1 = m_input.HMD_WEBVR1_1;
  337. /**
  338.  * Parameter of HMD eye distance.
  339.  * @const {DeviceConfig} module:input.HMD_EYE_DISTANCE
  340.  */
  341. var HMD_EYE_DISTANCE = m_input.HMD_EYE_DISTANCE
  342. exports.HMD_EYE_DISTANCE = HMD_EYE_DISTANCE;
  344. /**
  345.  * Parameter of HMD distortion coefficients.
  346.  * @const {DeviceConfig} module:input.HMD_DISTORTION
  347.  */
  348. exports.HMD_DISTORTION = m_input.HMD_DISTORTION;
  350. /**
  351.  * Parameter of HMD baseline distance.
  352.  * @const {DeviceConfig} module:input.HMD_BASELINE_DIST
  353.  */
  354. exports.HMD_BASELINE_DIST = m_input.HMD_BASELINE_DIST;
  356. /**
  357.  * Parameter of HMD screen to lens distance.
  358.  * @const {DeviceConfig} module:input.HMD_SCREEN_LENS_DIST
  359.  */
  360. exports.HMD_SCREEN_LENS_DIST = m_input.HMD_SCREEN_LENS_DIST;
  362. /**
  363.  * Parameter of mobile screen width.
  364.  * @const {DeviceConfig} module:input.HMD_SCREEN_WIDTH
  365.  */
  366. exports.HMD_SCREEN_WIDTH = m_input.HMD_SCREEN_WIDTH;
  368. /**
  369.  * Parameter of mobile screen height.
  370.  * @const {DeviceConfig} module:input.HMD_SCREEN_HEIGHT
  371.  */
  372. exports.HMD_SCREEN_HEIGHT = m_input.HMD_SCREEN_HEIGHT;
  374. /**
  375.  * Parameter of mobile bevel size.
  376.  * @const {DeviceConfig} module:input.HMD_BEVEL_SIZE
  377.  */
  378. exports.HMD_BEVEL_SIZE = m_input.HMD_BEVEL_SIZE;
  380. /**
  381.  * Parameter of the mouse pointer coordinates.
  382.  * @const {DeviceVectorParameterSync | DeviceParameterAsync} module:input.MOUSE_LOCATION
  383.  */
  384. exports.MOUSE_LOCATION = m_input.MOUSE_LOCATION;
  386. /**
  387.  * Parameter of the mouse downed key.
  388.  * @const {DeviceParameterAsync} module:input.MOUSE_DOWN_WHICH
  389.  */
  390. exports.MOUSE_DOWN_WHICH = m_input.MOUSE_DOWN_WHICH;
  392. /**
  393.  * Parameter of the mouse upped key.
  394.  * @const {DeviceParameterAsync} module:input.MOUSE_UP_WHICH
  395.  */
  396. exports.MOUSE_UP_WHICH = m_input.MOUSE_UP_WHICH;
  398. /**
  399.  * Parameter of the vertical scroll amount.
  400.  * @const {DeviceParameterAsync} module:input.MOUSE_WHEEL
  401.  */
  402. exports.MOUSE_WHEEL = m_input.MOUSE_WHEEL;
  404. /**
  405.  * Parameter of the keyboard upped key.
  406.  * @const {DeviceParameterAsync} module:input.KEYBOARD_UP
  407.  */
  408. exports.KEYBOARD_UP = m_input.KEYBOARD_UP;
  410. /**
  411.  * Parameter of the keyboard downed key.
  412.  * @const {DeviceParameterAsync} module:input.KEYBOARD_DOWN
  413.  */
  414. exports.KEYBOARD_DOWN = m_input.KEYBOARD_DOWN;
  416. /**
  417.  * Parameter of started touch point list on the touch surface.
  418.  * @const {DeviceParameterAsync} module:input.TOUCH_START
  419.  */
  420. exports.TOUCH_START = m_input.TOUCH_START;
  422. /**
  423.  * Parameter of moving touch list on the touch surface.
  424.  * @const {DeviceParameterAsync} module:input.TOUCH_MOVE
  425.  */
  426. exports.TOUCH_MOVE = m_input.TOUCH_MOVE;
  428. /**
  429.  * Parameter of ended touch point list on the touch surface.
  430.  * @const {DeviceParameterAsync} module:input.TOUCH_END
  431.  */
  432. exports.TOUCH_END = m_input.TOUCH_END;
  434. /**
  435.  * Parameter of gyroscope orientation quaternion.
  436.  * @const {DeviceParameterAsync} module:input.GYRO_ORIENTATION_QUAT
  437.  */
  438. exports.GYRO_ORIENTATION_QUAT = m_input.GYRO_ORIENTATION_QUAT;
  440. /**
  441.  * Parameter of gyroscope orientation angles.
  442.  * @const {DeviceParameterAsync} module:input.GYRO_ORIENTATION_ANGLES
  443.  */
  444. exports.GYRO_ORIENTATION_ANGLES = m_input.GYRO_ORIENTATION_ANGLES;
  446. var SYNC_VECTOR_PARAMS = {};
  447. SYNC_VECTOR_PARAMS[m_input.DEVICE_HMD] = [m_input.HMD_ORIENTATION_QUAT,
  448.         m_input.HMD_POSITION];
  449. SYNC_VECTOR_PARAMS[m_input.DEVICE_MOUSE] = [m_input.MOUSE_LOCATION];
  451. var SYNC_VALUE_PARAMS = {};
  452. SYNC_VALUE_PARAMS[m_input.DEVICE_HMD] = [m_input.HMD_WEBVR_TYPE];
  454. var ASYNC_PARAMS = {};
  455. ASYNC_PARAMS[m_input.DEVICE_MOUSE] = [m_input.MOUSE_LOCATION,
  456.         m_input.MOUSE_DOWN_WHICH, m_input.MOUSE_UP_WHICH, m_input.MOUSE_WHEEL];
  457. ASYNC_PARAMS[m_input.DEVICE_KEYBOARD] = [m_input.KEYBOARD_UP,
  458.         m_input.KEYBOARD_DOWN];
  459. ASYNC_PARAMS[m_input.DEVICE_TOUCH] = [m_input.TOUCH_START, m_input.TOUCH_MOVE,
  460.         m_input.TOUCH_END];
  461. ASYNC_PARAMS[m_input.DEVICE_GYRO] = [m_input.GYRO_ORIENTATION_QUAT,
  462.         m_input.GYRO_ORIENTATION_ANGLES];
  464. var CONF = {};
  465. CONF[m_input.DEVICE_HMD] = [m_input.HMD_DISTORTION,
  466.         m_input.HMD_EYE_DISTANCE, m_input.HMD_BASELINE_DIST,
  467.         m_input.HMD_SCREEN_LENS_DIST, m_input.HMD_SCREEN_WIDTH,
  468.         m_input.HMD_SCREEN_HEIGHT, m_input.HMD_BEVEL_SIZE];
  470. /**
  471.  * The callback for the mouse location corresponding to the
  472.  * {@link module:input.MOUSE_LOCATION|MOUSE_LOCATION} param.
  473.  * @callback MouseLocationCallback
  474.  * @param {Float32Array} location List: the horizontal mouse coordinate, the
  475.  * vertical mouse coordinate.
  476.  * @example
  477.  * var m_input = require("input");
  478.  * 
  479.  * var mouse_location_cb = function(location) {
  480.  *     console.log("The horizontal location: " + location[0]);
  481.  *     console.log("The vertical location: " + location[1]);
  482.  * };
  483.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_MOUSE);
  484.  * m_input.attach_param_cb(device, m_input.MOUSE_LOCATION, mouse_location_cb);
  485.  */
  487. /**
  488.  * The callback for the pressed mouse button corresponding to the
  489.  * {@link module:input.MOUSE_DOWN_WHICH|MOUSE_DOWN_WHICH} param.
  490.  * @callback MouseDownWhichCallback
  491.  * @param {number} which Number indicates button that was pressed on the mouse
  492.  * (1 -- left button, 2 -- middle button, 3 -- right button).
  493.  * @example
  494.  * var m_input = require("input");
  495.  * 
  496.  * var mouse_down_which_cb = function(which) {
  497.  *     console.log("Pressed button: " + which);
  498.  * };
  499.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_MOUSE);
  500.  * m_input.attach_param_cb(device, m_input.MOUSE_DOWN_WHICH, mouse_down_which_cb);
  501.  */
  503. /**
  504.  * The callback for the released mouse button corresponding to the
  505.  * {@link module:input.MOUSE_UP_WHICH|MOUSE_UP_WHICH} param.
  506.  * @callback MouseUpWhichCallback
  507.  * @param {number} which Number indicates button that was released on the mouse
  508.  * (1 -- left button, 2 -- middle button, 3 -- right button).
  509.  * @example
  510.  * var m_input = require("input");
  511.  * 
  512.  * var mouse_up_which_cb = function(which) {
  513.  *     console.log("Released button: " + which);
  514.  * };
  515.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_MOUSE);
  516.  * m_input.attach_param_cb(device, m_input.MOUSE_UP_WHICH, mouse_up_which_cb);
  517.  */
  519. /**
  520.  * The callback for the mouse scroll corresponding to the
  521.  * {@link module:input.MOUSE_WHEEL|MOUSE_WHEEL} param.
  522.  * @callback MouseWheelCallback
  523.  * @param {number} delta The vertical mouse scroll amount.
  524.  * @example
  525.  * var m_input = require("input");
  526.  * 
  527.  * var mouse_wheel_cb = function(delta) {
  528.  *     console.log("Scroll amount: " + delta);
  529.  * };
  530.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_MOUSE);
  531.  * m_input.attach_param_cb(device, m_input.MOUSE_WHEEL, mouse_wheel_cb);
  532.  */
  534. /**
  535.  * The callback for the pressed keyboard button corresponding to the
  536.  * {@link module:input.KEYBOARD_DOWN|KEYBOARD_DOWN} param.
  537.  * @callback KeyboardDownCallback
  538.  * @param {number} key_code Number indicates button that was pressed on the
  539.  * keyboard (use constants KEY_* from module {@link module:controls|controls}).
  540.  * @example
  541.  * var m_input = require("input");
  542.  * 
  543.  * var keyboard_down_cb = function(key_code) {
  544.  *     console.log("Pressed keyboard button: " + key_code);
  545.  * };
  546.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_KEYBOARD);
  547.  * m_input.attach_param_cb(device, m_input.KEYBOARD_DOWN, keyboard_down_cb);
  548.  */
  550. /**
  551.  * The callback for the released keyboard button corresponding to the
  552.  * {@link module:input.KEYBOARD_UP|KEYBOARD_UP} param.
  553.  * @callback KeyboardUpCallback
  554.  * @param {number} key_code Number indicates button that was released on the
  555.  * keyboard (use constants KEY_* from module {@link module:controls|controls}).
  556.  * @example
  557.  * var m_input = require("input");
  558.  * 
  559.  * var keyboard_up_cb = function(key_code) {
  560.  *     console.log("Released keyboard button: " + key_code);
  561.  * };
  562.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_KEYBOARD);
  563.  * m_input.attach_param_cb(device, m_input.KEYBOARD_UP, keyboard_up_cb);
  564.  */
  566. /**
  567.  * The callback for the start of touch surface contacting corresponding to the
  568.  * {@link module:input.TOUCH_START|TOUCH_START} param.
  569.  * @callback TouchStartCallback
  570.  * @param {Array} touches List of touch objects corresponding to the
  571.  * contacting with the touch surface points.
  572.  * @example
  573.  * var m_input = require("input");
  574.  * 
  575.  * var touch_start_cb = function(touches) {
  576.  *     for (var i = 0; i < touches.length; ++i)
  577.  *          console.log("Touch contact " + touches[i].identifier + " has position" +
  578.  *                  + " x: " + touches[i].clientX + " y: " + touches[i].clientY);
  579.  * };
  580.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_TOUCH);
  581.  * m_input.attach_param_cb(device, m_input.TOUCH_START, touch_start_cb);
  582.  */
  584. /**
  585.  * The callback for the contact moving on the touch surface corresponding to the
  586.  * {@link module:input.TOUCH_MOVE|TOUCH_MOVE} param.
  587.  * @callback TouchMoveCallback
  588.  * @param {Array} touches List of touch objects corresponding to the
  589.  * contacting with the touch surface points.
  590.  * @example
  591.  * var m_input = require("input");
  592.  * 
  593.  * var touch_move_cb = function(touches) {
  594.  *     for (var i = 0; i < touches.length; ++i)
  595.  *          console.log("Touch contact " + touches[i].identifier + " has position" +
  596.  *                  + " x: " + touches[i].clientX + " y: " + touches[i].clientY);
  597.  * };
  598.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_TOUCH);
  599.  * m_input.attach_param_cb(device, m_input.TOUCH_MOVE, touch_move_cb);
  600.  */
  602. /**
  603.  * The callback for the end of touch surface contacting corresponding to the
  604.  * {@link module:input.TOUCH_END|TOUCH_END} param.
  605.  * @callback TouchEndCallback
  606.  * @param {Array} touches List of touch objects corresponding to the
  607.  * contacting with the touch surface points.
  608.  * @example
  609.  * var m_input = require("input");
  610.  * 
  611.  * var touch_end_cb = function(touches) {
  612.  *     for (var i = 0; i < touches.length; ++i)
  613.  *          console.log("Touch contact " + touches[i].identifier + " has position" +
  614.  *                  + " x: " + touches[i].clientX + " y: " + touches[i].clientY);
  615.  * };
  616.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_TOUCH);
  617.  * m_input.attach_param_cb(device, m_input.TOUCH_END, touch_end_cb);
  618.  */
  620. /**
  621.  * The callback for the quaternion of the gyroscope orientation corresponding 
  622.  * to the {@link module:input.GYRO_ORIENTATION_QUAT|GYRO_ORIENTATION_QUAT} param.
  623.  * @callback GyroscopeQuatCallback
  624.  * @param {Quat} quat Quaternion vector corresponding to the gyroscope orientation.
  625.  * @example
  626.  * var m_input = require("input");
  627.  * 
  628.  * var gyroscope_quat_cb = function(quat) {
  629.  *     console.log("Gyroscope orientation quaternion is " + quat);
  630.  * };
  631.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_GYRO);
  632.  * m_input.attach_param_cb(device, m_input.GYRO_ORIENTATION_QUAT, gyroscope_quat_cb);
  633.  */
  635. /**
  636.  * The callback for the Euler angles of the gyroscope orientation corresponding
  637.  * to the {@link module:input.GYRO_ORIENTATION_ANGLES|GYRO_ORIENTATION_ANGLES} param.
  638.  * @callback GyroscopeAnglesCallback
  639.  * @param {Euler} angles Euler angles (in radians) corresponding to the gyroscope 
  640.  * orientation.
  641.  * @example
  642.  * var m_input = require("input");
  643.  * 
  644.  * var gyroscope_angles_cb = function(angles) {
  645.  *     console.log("Gyroscope orientation Euler angles are " + angles);
  646.  * };
  647.  * var device = m_input.get_device_by_type_element(m_input.DEVICE_GYRO);
  648.  * m_input.attach_param_cb(device, m_input.GYRO_ORIENTATION_ANGLES, gyroscope_angles_cb);
  649.  */
  651. /**
  652.  * Device type enum.
  653.  * @typedef {number} DeviceType
  654.  */
  656. /**
  657.  * Gyroscope device type.
  658.  * @const {DeviceType} module:input.DEVICE_GYRO
  659.  */
  660. exports.DEVICE_GYRO = m_input.DEVICE_GYRO;
  662. /**
  663.  * Head mounted device type.
  664.  * @const {DeviceType} module:input.DEVICE_HMD
  665.  */
  666. exports.DEVICE_HMD = m_input.DEVICE_HMD;
  668. /**
  669.  * Mouse device type.
  670.  * @const {DeviceType} module:input.DEVICE_MOUSE
  671.  */
  672. exports.DEVICE_MOUSE = m_input.DEVICE_MOUSE;
  674. /**
  675.  * Keyboard device type.
  676.  * @const {DeviceType} module:input.DEVICE_KEYBOARD
  677.  */
  678. exports.DEVICE_KEYBOARD = m_input.DEVICE_KEYBOARD;
  680. /**
  681.  * Touch device type.
  682.  * @const {DeviceType} module:input.DEVICE_TOUCH
  683.  */
  684. exports.DEVICE_TOUCH = m_input.DEVICE_TOUCH;
  686. /**
  687.  * Check if the device can be used.
  688.  * @method module:input.can_use_device
  689.  * @param {DeviceType} type Device type.
  690.  * @returns {boolean} Result of the check
  691.  */
  692. exports.can_use_device = m_input.can_use_device;
  694. /**
  695.  * Get device object by associated device type and DOM element.
  696.  * If device is not available, then return null.
  697.  * @method module:input.get_device_by_type_element
  698.  * @param {DeviceType} type Device type.
  699.  * @param {?HTMLElement} element HTML element to add event listeners to.
  700.  * @returns {?Object} Device object.
  701.  */
  702. exports.get_device_by_type_element = m_input.get_device_by_type_element;
  704. /**
  705.  * Switch triggering of the browser default actions for registered events.
  706.  * @param {Object} device Device object. Use
  707.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  708.  * @param {boolean} prevent_default Prevent default flag.
  709.  * @method module:input.switch_prevent_default
  710.  */
  711. exports.switch_prevent_default = function(device, prevent_default) {
  712.     if (device)
  713.         m_input.switch_prevent_default(device, prevent_default);
  714. }
  716. /**
  717.  * Register device. Right now it should be used for DEVICE_HMD.
  718.  * @method module:input.register_device
  719.  * @deprecated Not needed anymore.
  720.  */
  721. exports.register_device = function() {
  722.     m_print.error_once("input.register_device() deprecated");
  723. }
  725. /**
  726.  * Reset device. The device parameters values return to zero.
  727.  * Right now it should be used for DEVICE_HMD.
  728.  * @param {Object} device Device object. Use
  729.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  730.  * @method module:input.reset_device
  731.  */
  732. exports.reset_device = function(device) {
  733.     if (!device || device.type != m_input.DEVICE_HMD) {
  734.         m_print.error("reset_device is undefined for device.");
  735.         return;
  736.     }
  738.     m_input.reset_device(device);
  739. }
  741. /**
  742.  * Get parameter vector.
  743.  * @param {Object} device Device object. Use
  744.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  745.  * @param {DeviceVectorParameterSync} param Name of the device vector parameter.
  746.  * @param {Float32Array} dest Destination vector.
  747.  * @returns {?Float32Array} Destination vector.
  748.  * @method module:input.get_vector_param
  749.  */
  750. exports.get_vector_param = function(device, param, dest) {
  751.     if (device && device.type in SYNC_VECTOR_PARAMS &&
  752.             SYNC_VECTOR_PARAMS[device.type].indexOf(param) >= 0)
  753.         return m_input.get_vector_param(device, param, dest);
  754.     else
  755.         m_print.error("device hasn't param: ", param);
  756.     return null;
  757. }
  759. /**
  760.  * Get parameter value.
  761.  * @param {Object} device Device object. Use
  762.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  763.  * @param {DeviceValueParameterSync} param Name of the device value parameter.
  764.  * @returns {number|boolean|null} Parameter value.
  765.  * @method module:input.get_value_param
  766.  */
  767. exports.get_value_param = function(device, param) {
  768.     if (device && device.type in SYNC_VALUE_PARAMS &&
  769.             SYNC_VALUE_PARAMS[device.type].indexOf(param) >= 0)
  770.         return m_input.get_value_param(device, param);
  771.     else
  772.         m_print.error("device hasn't param: ", param);
  774.     return null;
  775. }
  777. /**
  778.  * Attach callback to the device parameter. It is called when parameter is changed.
  779.  * @param {Object} device Device object. Use
  780.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  781.  * @param {DeviceParameterAsync} param Name of the device parameter.
  782.  * @param {MouseLocationCallback|MouseDownWhichCallback|MouseUpWhichCallback|
  783.  * MouseWheelCallback|KeyboardDownCallback|KeyboardUpCallback|
  784.  * TouchStartCallback|TouchMoveCallback|TouchEndCallback|
  785.  * GyroscopeQuatCallback|GyroscopeAnglesCallback} [cb = null] Callback.
  786.  * @method module:input.attach_param_cb
  787.  */
  788. exports.attach_param_cb = function(device, param, cb) {
  789.     cb = cb || null;
  790.     if (device && device.type in ASYNC_PARAMS &&
  791.             ASYNC_PARAMS[device.type].indexOf(param) >= 0)
  792.         return m_input.attach_param_cb(device, param, cb);
  793.     else
  794.         m_print.error("device hasn't param: ", param);
  795. }
  797. /**
  798.  * Detach callback from the device parameter.
  799.  * @param {Object} device Device object. Use
  800.  * {@link module:input.get_device_by_type_element|input.get_device_by_type_element} to obtain it.
  801.  * @param {DeviceParameterAsync} param Name of the device parameter.
  802.  * @param {MouseLocationCallback|MouseDownWhichCallback|MouseUpWhichCallback|
  803.  * MouseWheelCallback|KeyboardDownCallback|KeyboardUpCallback|
  804.  * TouchStartCallback|TouchMoveCallback|TouchEndCallback|
  805.  * GyroscopeQuatCallback|GyroscopeAnglesCallback} [cb = null] Callback.
  806.  * @method module:input.detach_param_cb
  807.  */
  808. exports.detach_param_cb = function(device, param, cb) {
  809.     cb = cb || null;
  810.     if (device && device.type in ASYNC_PARAMS &&
  811.             ASYNC_PARAMS[device.type].indexOf(param) >= 0)
  812.         return m_input.detach_param_cb(device, param, cb);
  813.     else
  814.         m_print.error("device hasn't param: ", param);
  815. }
  817. exports.set_config = function(device, config, value) {
  818.     if (device && device.type in CONF &&
  819.             CONF[device.type].indexOf(config) >= 0)
  820.         return m_input.set_config(device, config, value);
  821.     else
  822.         m_print.error("device hasn't config: ", config);
  823. }
  825. /**
  826.  * Request fullscreen mode.
  827.  * @method module:input.request_fullscreen_hmd
  828.  * @deprecated Use {@link module:screen.request_fullscreen_hmd} instead
  829.  */
  830. exports.request_fullscreen_hmd = function() {
  831.     m_print.error_deprecated("request_fullscreen_hmd", "screen.request_fullscreen_hmd");
  833.     if (m_scs.check_active()) {
  834.          var cam_obj = m_scs.get_camera(m_scs.get_active());
  835.          if (!cam_obj)
  836.              return;
  837.     } else
  838.         return;
  840.     enable_split_screen(cam_obj);
  842.     var hmd_device = m_input.get_device_by_type_element(m_input.DEVICE_HMD);
  843.     if (hmd_device) {
  844.         var webvr_display = hmd_device.webvr_display;
  845.         // TODO: add "&& !webvr_display.isPresenting" to "if" (optimization).
  846.         // Right now webvr_display.isPresenting is allways "true" after
  847.         // first requestPresent.
  848.         if (webvr_display && !webvr_display.isPresenting) {
  849.             var capabilities = webvr_display.capabilities;
  850.             if (!capabilities.canPresent)
  851.                 m_print.error("HMD fullscreen request failed.");
  852.             else {
  853.                 var canvas = m_cont.get_canvas();
  854.                 webvr_display.requestPresent([{source: canvas}]).then(function () {
  855.                     // TODO: check code below
  856.                     // There was strange behavior Samsung Internet on GearVR
  858.                     if (!cfg_def.is_mobile_device) {
  859.                         var left_eye = webvr_display.getEyeParameters("left");
  860.                         var right_eye = webvr_display.getEyeParameters("right");
  862.                         m_cont.resize(
  863.                                 Math.max(left_eye.renderWidth, right_eye.renderWidth) * 2,
  864.                                 Math.max(left_eye.renderHeight, right_eye.renderHeight), false);
  865.                     }
  866.                 }, function () {
  867.                     m_print.error("HMD fullscreen request failed.");
  868.                 });
  869.             }
  870.         }
  871.     }
  872. }
  874. /**
  875.  * Enable "split screen" mode.
  876.  * @method module:input.enable_split_screen
  877.  * @param {Object3D} camobj Camera 3D-object.
  878.  * @returns {boolean} "Split screen" mode is enabled.
  879.  * @deprecated Use {@link module:screen.request_split_screen} instead
  880.  */
  881. exports.enable_split_screen = enable_split_screen;
  882. function enable_split_screen(camobj) {
  883.     m_print.error_deprecated("enable_split_screen", "screen.request_split_screen");
  885.     var hmd_device = m_input.get_device_by_type_element(m_input.DEVICE_HMD);
  886.     if (!hmd_device)
  887.         return false;
  889.     if (_splited_screen)
  890.         return true;
  892.     var hmd_left_fov = m_input.get_vector_param(hmd_device, m_input.HMD_FOV_LEFT, _vec4_tmp);
  893.     var hmd_right_fov = m_input.get_vector_param(hmd_device, m_input.HMD_FOV_RIGHT, _vec4_tmp2);
  894.     m_cam.set_hmd_fov(camobj, hmd_left_fov, hmd_right_fov);
  896.     var eye_distance = m_input.get_value_param(hmd_device, HMD_EYE_DISTANCE);
  897.     if (eye_distance) {
  898.         var active_scene = m_scs.get_active();
  899.         var cam_scene_data = m_obj_util.get_scene_data(camobj, active_scene);
  900.         var cameras = cam_scene_data.cameras;
  901.         m_cam.set_eye_distance(cameras, eye_distance);
  902.     }
  904.     var hmd_params = {};
  905.     hmd_params.base_line_factor = 0.5;
  906.     hmd_params.inter_lens_factor = 0.5;
  907.     hmd_params.enable_hmd_stereo = true;
  908.     var hmd_type = m_input.get_value_param(hmd_device, m_input.HMD_WEBVR_TYPE)
  909.     if (hmd_type & (m_input.HMD_NON_WEBVR | m_input.HMD_WEBVR_MOBILE |
  910.             m_input.HMD_WEBVR_DESKTOP)) {
  911.         hmd_params.distortion_coefs = [
  912.             hmd_device.distortion_coefs[0],
  913.             hmd_device.distortion_coefs[1]
  914.         ];
  915.         hmd_params.chromatic_aberration_coefs = [
  916.             hmd_device.chromatic_aberration_coefs[0],
  917.             hmd_device.chromatic_aberration_coefs[1],
  918.             hmd_device.chromatic_aberration_coefs[2],
  919.             hmd_device.chromatic_aberration_coefs[3]
  920.         ];
  921.         if (!hmd_device.webvr_hmd_device)
  922.             if (hmd_device.base_line_dist && hmd_device.height_dist && hmd_device.bevel_size)
  923.                 hmd_params.base_line_factor = (hmd_device.base_line_dist - hmd_device.bevel_size) /
  924.                         hmd_device.height_dist;
  925.             else if (!hmd_device.bevel_size)
  926.                 hmd_params.base_line_factor = hmd_device.base_line_dist / hmd_device.height_dist;
  927.         if (hmd_device.inter_lens_dist && hmd_device.width_dist && !hmd_device.webvr_hmd_device)
  928.             hmd_params.inter_lens_factor = hmd_device.inter_lens_dist /
  929.                     hmd_device.width_dist;
  930.         // NOTE: prevent crash in case of difference of slink's dimensions.
  931.         // For example: "debug" slink ~ 0.5 X 1.0,
  932.         //              "origin" slink ~ distortion_scale * 0.5 X distortion_scale * 1.0
  933.         if (!cfg_dbg.enabled) {
  934.             var distortion_scale = (1 + hmd_device.distortion_coefs[0] + hmd_device.distortion_coefs[1]);
  935.             m_scs.multiply_size_mult(distortion_scale, distortion_scale);
  936.         }
  937.     }
  938.     m_scs.set_hmd_params(hmd_params);
  940.     m_cont.resize_to_container(true);
  942.     m_input.reset_device(hmd_device);
  944.     _splited_screen = true;
  945.     return true;
  946. }
  948. /**
  949.  * Disable "split screen" mode.
  950.  * @method module:input.disable_split_screen
  951.  * @returns {boolean} "Split screen" mode is disabled.
  952.  * @deprecated Use {@link module:screen.exit_split_screen} instead
  953.  */
  954. exports.disable_split_screen = function() {
  955.     m_print.error_deprecated("disable_split_screen", "screen.exit_split_screen");
  957.     var hmd_device = m_input.get_device_by_type_element(m_input.DEVICE_HMD)
  958.     if (!_splited_screen || !hmd_device || !hmd_device.registered)
  959.         return false;
  961.     // set up non-vr mode
  962.     var hmd_params = {};
  963.     hmd_params.enable_hmd_stereo = false;
  964.     m_scs.set_hmd_params(hmd_params);
  966.     var distortion_scale = 1 / (1 + hmd_device.distortion_coefs[0] + hmd_device.distortion_coefs[1]);
  967.     m_scs.multiply_size_mult(distortion_scale, distortion_scale);
  968.     // resize screen to canvas resolution (non-vr mode)
  969.     m_cont.resize_to_container(true);
  970.     return true;
  971. }
  972. /**
  973.  * Set gamepad button key value.
  974.  * @method module:input.set_gamepad_key
  975.  * @param {number} gamepad_id Connected gamepad number.
  976.  * @param {number} btn Button or axis identifier.
  977.  * @param {number} key Button key value.
  978.  */
  979. exports.set_gamepad_key = function(gamepad_id, btn, key) {
  980.     switch(gamepad_id) {
  981.     case 0:
  982.         var type = m_input.DEVICE_GAMEPAD0;
  983.         break;
  984.     case 1:
  985.         var type = m_input.DEVICE_GAMEPAD1;
  986.         break;
  987.     case 2:
  988.         var type = m_input.DEVICE_GAMEPAD2;
  989.         break;
  990.     case 3:
  991.         var type = m_input.DEVICE_GAMEPAD3;
  992.         break;
  993.     default:
  994.         var type = m_input.DEVICE_GAMEPAD0;
  995.     }
  996.     var device = m_input.get_device_by_type_element(type);
  997.     m_input.set_config(device, btn, key);
  998. };
  999. /**
  1000.  * Get pressed button key value.
  1001.  * @method module:input.get_pressed_gmpd_btn
  1002.  * @param {number} gamepad_id Gamepad identifier (Connected device number 0-3).
  1003.  * @returns {number} Pressed button key value.
  1004.  */
  1005. exports.get_pressed_gmpd_btn = m_input.get_pressed_gmpd_btn;
  1006. /**
  1007.  * Get moved axis key value.
  1008.  * @method module:input.get_moved_gmpd_axis
  1009.  * @param {number} gamepad_id Gamepad identifier (Connected device number 0-3).
  1010.  * @returns {number} Moved axis key value.
  1011.  */
  1012. exports.get_moved_gmpd_axis = m_input.get_moved_gmpd_axis;
  1013. /**
  1014.  * Get gamepad position.
  1015.  * @method module:input.get_gamepad_position
  1016.  * @param {number} gamepad_id Gamepad identifier (Connected device number 0-3).
  1017.  * @param {Vec3} dest Destination vector.
  1018.  * @returns {Vec3} Gamepad position.
  1019.  */
  1020. exports.get_gamepad_position = m_input.get_gamepad_position;
  1021. /**
  1022.  * Get gamepad orientation.
  1023.  * @method module:input.get_gamepad_orientation
  1024.  * @param {number} gamepad_id Gamepad identifier (Connected device number 0-3).
  1025.  * @param {Quat} dest Destination vector.
  1026.  * @returns {Quat} Gamepad orientation.
  1027.  */
  1028. exports.get_gamepad_orientation = m_input.get_gamepad_orientation;
  1029. /**
  1030.  * Check available gamepads indices.
  1031.  * @method module:input.check_enable_gamepad_indices
  1032.  * @returns {Array} Numeric array with indices
  1033.  * @cc_externs getGamepads webkitGetGamepads
  1034.  */
  1035. exports.check_enable_gamepad_indices = check_enable_gamepad_indices;
  1036. function check_enable_gamepad_indices() {
  1037.     var gamepads = navigator.getGamepads ? navigator.getGamepads() :
  1038.             (navigator.webkitGetGamepads ? navigator.webkitGetGamepads : []);
  1039.     var indices = [];
  1040.     for (var i = 0; i < gamepads.length; i++)
  1041.         if (gamepads[i])
  1042.             indices.push(i);
  1043.     return indices;
  1044. }
  1046. /**
  1047.  * Get gamepad id of VR controller.
  1048.  * @method module:input.get_vr_controller_id
  1049.  * @param {number} controller_id VR controller id.
  1050.  * @return {number} Gamepad id.
  1051.  * @example
  1052.  * var m_input = require("input");
  1053.  *
  1054.  * // get the id of the first VR controller (among all gamepads)
  1055.  * var vr_id = m_input.get_vr_controller_id(0);
  1056.  */
  1057. exports.get_vr_controller_id = function(controller_id) {
  1058.     var gamepads = navigator.getGamepads ? navigator.getGamepads() :
  1059.             (navigator.webkitGetGamepads ? navigator.webkitGetGamepads : []);
  1061.     // CHECK: there could be more than 4 gamepads in Firefox Nightly
  1062.     for (var i = 0, j = 0; i < 4; i++) {
  1063.         var gamepad = gamepads[i];
  1064.         // use gamepad.id == "", bcz there is a bug in Firefox Nightly
  1065.         if (gamepad && (gamepad.id == "" ||
  1066.                 gamepad.id == "OpenVR Gamepad" ||
  1067.                 gamepad.id == "Oculus Touch (Left)" ||
  1068.                 gamepad.id == "Oculus Touch (Right)"
  1069.                 )) {
  1070.             if (j == controller_id)
  1071.                 return j;
  1072.             j++;
  1073.         }
  1074.     }
  1076.     return controller_id;
  1077. }
  1079. /**
  1080.  * Register the listener on the click event. Callback is called on right
  1081.  * after click on element (without 300ms delay).
  1082.  * @method module:input.add_click_listener
  1083.  * @param {HTMLElement} element DOM element.
  1084.  * @param {Callback} callback Callback.
  1085.  */
  1086. exports.add_click_listener = function(element, callback) {
  1087.     if (!element || !callback)
  1088.         return;
  1090.     m_input.add_click_listener(element, callback);
  1091. }
  1093. /**
  1094.  * Unregister the listener registered with
  1095.  * {@link module:input.add_click_listener | input.add_click_listener}.
  1096.  * @method module:input.remove_click_listener
  1097.  * @param {HTMLElement} element DOM element.
  1098.  * @param {Callback} callback Callback.
  1099.  */
  1100. exports.remove_click_listener = function(element, callback) {
  1101.     if (!element || !callback)
  1102.         return;
  1104.     m_input.remove_click_listener(element, callback);
  1105. }
  1107. }
  1109. var input_factory = register("input", Input);
  1111. export default input_factory;