Remove device orientation

2017-12-12 19:16:13 -07:00
parent bb48b09920
commit ac6b3fb908
3 changed files with 0 additions and 267 deletions
@@ -38,20 +38,6 @@ olx.AttributionOptions;
 olx.AttributionOptions.prototype.html;
 /**
 * @typedef {{tracking: (boolean|undefined)}}
 */
 olx.DeviceOrientationOptions;
 /**
 * Start tracking. Default is `false`.
 * @type {boolean|undefined}
 * @api
 */
 olx.DeviceOrientationOptions.prototype.tracking;
 /**
 * @typedef {{tracking: (boolean|undefined),
 *     trackingOptions: (GeolocationPositionOptions|undefined),
@@ -1,238 +0,0 @@
 /**
 * @module ol/DeviceOrientation
 */
 import _ol_events_ from './events.js';
 import {inherits} from './index.js';
 import _ol_Object_ from './Object.js';
 import _ol_has_ from './has.js';
 import _ol_math_ from './math.js';
 /**
 * @classdesc
 * The ol.DeviceOrientation class provides access to information from
 * DeviceOrientation events.  See the [HTML 5 DeviceOrientation Specification](
 * http://www.w3.org/TR/orientation-event/) for more details.
 *
 * Many new computers, and especially mobile phones
 * and tablets, provide hardware support for device orientation. Web
 * developers targeting mobile devices will be especially interested in this
 * class.
 *
 * Device orientation data are relative to a common starting point. For mobile
 * devices, the starting point is to lay your phone face up on a table with the
 * top of the phone pointing north. This represents the zero state. All
 * angles are then relative to this state. For computers, it is the same except
 * the screen is open at 90 degrees.
 *
 * Device orientation is reported as three angles - `alpha`, `beta`, and
 * `gamma` - relative to the starting position along the three planar axes X, Y
 * and Z. The X axis runs from the left edge to the right edge through the
 * middle of the device. Similarly, the Y axis runs from the bottom to the top
 * of the device through the middle. The Z axis runs from the back to the front
 * through the middle. In the starting position, the X axis points to the
 * right, the Y axis points away from you and the Z axis points straight up
 * from the device lying flat.
 *
 * The three angles representing the device orientation are relative to the
 * three axes. `alpha` indicates how much the device has been rotated around the
 * Z axis, which is commonly interpreted as the compass heading (see note
 * below). `beta` indicates how much the device has been rotated around the X
 * axis, or how much it is tilted from front to back.  `gamma` indicates how
 * much the device has been rotated around the Y axis, or how much it is tilted
 * from left to right.
 *
 * For most browsers, the `alpha` value returns the compass heading so if the
 * device points north, it will be 0.  With Safari on iOS, the 0 value of
 * `alpha` is calculated from when device orientation was first requested.
 * ol.DeviceOrientation provides the `heading` property which normalizes this
 * behavior across all browsers for you.
 *
 * It is important to note that the HTML 5 DeviceOrientation specification
 * indicates that `alpha`, `beta` and `gamma` are in degrees while the
 * equivalent properties in ol.DeviceOrientation are in radians for consistency
 * with all other uses of angles throughout OpenLayers.
 *
 * To get notified of device orientation changes, register a listener for the
 * generic `change` event on your `ol.DeviceOrientation` instance.
 *
 * @see {@link http://www.w3.org/TR/orientation-event/}
 *
 * @deprecated This class is deprecated and will removed in the next major release.
 *
 * @constructor
 * @extends {ol.Object}
 * @param {olx.DeviceOrientationOptions=} opt_options Options.
 * @api
 */
 var _ol_DeviceOrientation_ = function(opt_options) {
  _ol_Object_.call(this);
  var options = opt_options ? opt_options : {};
  /**
   * @private
   * @type {?ol.EventsKey}
   */
  this.listenerKey_ = null;
  _ol_events_.listen(this,
      _ol_Object_.getChangeEventType(_ol_DeviceOrientation_.Property_.TRACKING),
      this.handleTrackingChanged_, this);
  this.setTracking(options.tracking !== undefined ? options.tracking : false);
 };
 inherits(_ol_DeviceOrientation_, _ol_Object_);
 /**
 * @inheritDoc
 */
 _ol_DeviceOrientation_.prototype.disposeInternal = function() {
  this.setTracking(false);
  _ol_Object_.prototype.disposeInternal.call(this);
 };
 /**
 * @private
 * @param {Event} originalEvent Event.
 */
 _ol_DeviceOrientation_.prototype.orientationChange_ = function(originalEvent) {
  var event = /** @type {DeviceOrientationEvent} */ (originalEvent);
  if (event.alpha !== null) {
    var alpha = _ol_math_.toRadians(event.alpha);
    this.set(_ol_DeviceOrientation_.Property_.ALPHA, alpha);
    // event.absolute is undefined in iOS.
    if (typeof event.absolute === 'boolean' && event.absolute) {
      this.set(_ol_DeviceOrientation_.Property_.HEADING, alpha);
    } else if (typeof event.webkitCompassHeading === 'number' &&
               event.webkitCompassAccuracy != -1) {
      var heading = _ol_math_.toRadians(event.webkitCompassHeading);
      this.set(_ol_DeviceOrientation_.Property_.HEADING, heading);
    }
  }
  if (event.beta !== null) {
    this.set(_ol_DeviceOrientation_.Property_.BETA,
        _ol_math_.toRadians(event.beta));
  }
  if (event.gamma !== null) {
    this.set(_ol_DeviceOrientation_.Property_.GAMMA,
        _ol_math_.toRadians(event.gamma));
  }
  this.changed();
 };
 /**
 * Rotation around the device z-axis (in radians).
 * @return {number|undefined} The euler angle in radians of the device from the
 *     standard Z axis.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.getAlpha = function() {
  return (
    /** @type {number|undefined} */ this.get(_ol_DeviceOrientation_.Property_.ALPHA)
  );
 };
 /**
 * Rotation around the device x-axis (in radians).
 * @return {number|undefined} The euler angle in radians of the device from the
 *     planar X axis.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.getBeta = function() {
  return (
    /** @type {number|undefined} */ this.get(_ol_DeviceOrientation_.Property_.BETA)
  );
 };
 /**
 * Rotation around the device y-axis (in radians).
 * @return {number|undefined} The euler angle in radians of the device from the
 *     planar Y axis.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.getGamma = function() {
  return (
    /** @type {number|undefined} */ this.get(_ol_DeviceOrientation_.Property_.GAMMA)
  );
 };
 /**
 * The heading of the device relative to north (in radians).
 * @return {number|undefined} The heading of the device relative to north, in
 *     radians, normalizing for different browser behavior.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.getHeading = function() {
  return (
    /** @type {number|undefined} */ this.get(_ol_DeviceOrientation_.Property_.HEADING)
  );
 };
 /**
 * Determine if orientation is being tracked.
 * @return {boolean} Changes in device orientation are being tracked.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.getTracking = function() {
  return (
    /** @type {boolean} */ this.get(_ol_DeviceOrientation_.Property_.TRACKING)
  );
 };
 /**
 * @private
 */
 _ol_DeviceOrientation_.prototype.handleTrackingChanged_ = function() {
  if (_ol_has_.DEVICE_ORIENTATION) {
    var tracking = this.getTracking();
    if (tracking && !this.listenerKey_) {
      this.listenerKey_ = _ol_events_.listen(window, 'deviceorientation',
          this.orientationChange_, this);
    } else if (!tracking && this.listenerKey_ !== null) {
      _ol_events_.unlistenByKey(this.listenerKey_);
      this.listenerKey_ = null;
    }
  }
 };
 /**
 * Enable or disable tracking of device orientation events.
 * @param {boolean} tracking The status of tracking changes to alpha, beta and
 *     gamma. If true, changes are tracked and reported immediately.
 * @observable
 * @api
 */
 _ol_DeviceOrientation_.prototype.setTracking = function(tracking) {
  this.set(_ol_DeviceOrientation_.Property_.TRACKING, tracking);
 };
 /**
 * @enum {string}
 * @private
 */
 _ol_DeviceOrientation_.Property_ = {
  ALPHA: 'alpha',
  BETA: 'beta',
  GAMMA: 'gamma',
  HEADING: 'heading',
  TRACKING: 'tracking'
 };
 export default _ol_DeviceOrientation_;
@@ -1,15 +0,0 @@
 import _ol_DeviceOrientation_ from '../../../src/ol/DeviceOrientation.js';
 describe('ol.DeviceOrientation', function() {
  describe('constructor', function() {
    it('can be constructed without arguments', function() {
      var instance = new _ol_DeviceOrientation_();
      expect(instance).to.be.an(_ol_DeviceOrientation_);
    });
  });
 });