Source: gesture/Touch.js

  1. /*
  2.  * Copyright 2003-2006, 2009, 2017, 2020 United States Government, as represented
  3.  * by the Administrator of the National Aeronautics and Space Administration.
  4.  * All rights reserved.
  5.  *
  6.  * The NASAWorldWind/WebWorldWind platform is licensed under the Apache License,
  7.  * Version 2.0 (the "License"); you may not use this file except in compliance
  8.  * with the License. You may obtain a copy of the License
  9.  * at http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software distributed
  12.  * under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
  13.  * CONDITIONS OF ANY KIND, either express or implied. See the License for the
  14.  * specific language governing permissions and limitations under the License.
  15.  *
  16.  * NASAWorldWind/WebWorldWind also contains the following 3rd party Open Source
  17.  * software:
  18.  *
  19.  *    ES6-Promise – under MIT License
  20.  *    libtess.js – SGI Free Software License B
  21.  *    Proj4 – under MIT License
  22.  *    JSZip – under MIT License
  23.  *
  24.  * A complete listing of 3rd Party software notices and licenses included in
  25.  * WebWorldWind can be found in the WebWorldWind 3rd-party notices and licenses
  26.  * PDF found in code  directory.
  27.  */
  28. /**
  29.  * @exports Touch
  30.  */
  31. define([],
  32.     function () {
  33.         "use strict";
  35.         /**
  36.          * Constructs a touch point.
  37.          * @alias Touch
  38.          * @constructor
  39.          * @classdesc Represents a touch point.
  40.          * @param {Color} identifier A number uniquely identifying the touch point
  41.          * @param {Number} clientX The X coordinate of the touch point's location.
  42.          * @param {Number} clientY The Y coordinate of the touch point's location.
  43.          */
  44.         var Touch = function (identifier, clientX, clientY) {
  46.             /**
  47.              * A number uniquely identifying this touch point.
  48.              * @type {Number}
  49.              * @readonly
  50.              */
  51.             this.identifier = identifier;
  53.             // Intentionally not documented.
  54.             this._clientX = clientX;
  56.             // Intentionally not documented.
  57.             this._clientY = clientY;
  59.             // Intentionally not documented.
  60.             this._clientStartX = clientX;
  62.             // Intentionally not documented.
  63.             this._clientStartY = clientY;
  64.         };
  66.         Object.defineProperties(Touch.prototype, {
  67.             /**
  68.              * Indicates the X coordinate of this touch point's location.
  69.              * @type {Number}
  70.              * @memberof Touch.prototype
  71.              */
  72.             clientX: {
  73.                 get: function () {
  74.                     return this._clientX;
  75.                 },
  76.                 set: function (value) {
  77.                     this._clientX = value;
  78.                 }
  79.             },
  81.             /**
  82.              * Indicates the Y coordinate of this touch point's location.
  83.              * @type {Number}
  84.              * @memberof Touch.prototype
  85.              */
  86.             clientY: {
  87.                 get: function () {
  88.                     return this._clientY;
  89.                 },
  90.                 set: function (value) {
  91.                     this._clientY = value;
  92.                 }
  93.             },
  95.             /**
  96.              * Indicates this touch point's translation along the X axis since the touch started.
  97.              * @type {Number}
  98.              * @memberof Touch.prototype
  99.              */
  100.             translationX: {
  101.                 get: function () {
  102.                     return this._clientX - this._clientStartX;
  103.                 },
  104.                 set: function (value) {
  105.                     this._clientStartX = this._clientX - value;
  106.                 }
  107.             },
  109.             /**
  110.              * Indicates this touch point's translation along the Y axis since the touch started.
  111.              * @type {Number}
  112.              * @memberof Touch.prototype
  113.              */
  114.             translationY: {
  115.                 get: function () {
  116.                     return this._clientY - this._clientStartY;
  117.                 },
  118.                 set: function (value) {
  119.                     this._clientStartY = this._clientY - value;
  120.                 }
  121.             }
  122.         });
  124.         return Touch;
  125.     });