DeviceOrientationControls.js 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
  1. console.warn( "THREE.DeviceOrientationControls: As part of the transition to ES6 Modules, the files in 'examples/js' were deprecated in May 2020 (r117) and will be deleted in December 2020 (r124). You can find more information about developing using ES6 Modules in https://threejs.org/docs/#manual/en/introduction/Installation." );
  2. /**
  3. * @author richt / http://richt.me
  4. * @author WestLangley / http://github.com/WestLangley
  5. *
  6. * W3C Device Orientation control (http://w3c.github.io/deviceorientation/spec-source-orientation.html)
  7. */
  8. THREE.DeviceOrientationControls = function ( object ) {
  9. var scope = this;
  10. var changeEvent = { type: "change" };
  11. var EPS = 0.000001;
  12. this.object = object;
  13. this.object.rotation.reorder( 'YXZ' );
  14. this.enabled = true;
  15. this.deviceOrientation = {};
  16. this.screenOrientation = 0;
  17. this.alphaOffset = 0; // radians
  18. var onDeviceOrientationChangeEvent = function ( event ) {
  19. scope.deviceOrientation = event;
  20. };
  21. var onScreenOrientationChangeEvent = function () {
  22. scope.screenOrientation = window.orientation || 0;
  23. };
  24. // The angles alpha, beta and gamma form a set of intrinsic Tait-Bryan angles of type Z-X'-Y''
  25. var setObjectQuaternion = function () {
  26. var zee = new THREE.Vector3( 0, 0, 1 );
  27. var euler = new THREE.Euler();
  28. var q0 = new THREE.Quaternion();
  29. var q1 = new THREE.Quaternion( - Math.sqrt( 0.5 ), 0, 0, Math.sqrt( 0.5 ) ); // - PI/2 around the x-axis
  30. return function ( quaternion, alpha, beta, gamma, orient ) {
  31. euler.set( beta, alpha, - gamma, 'YXZ' ); // 'ZXY' for the device, but 'YXZ' for us
  32. quaternion.setFromEuler( euler ); // orient the device
  33. quaternion.multiply( q1 ); // camera looks out the back of the device, not the top
  34. quaternion.multiply( q0.setFromAxisAngle( zee, - orient ) ); // adjust for screen orientation
  35. };
  36. }();
  37. this.connect = function () {
  38. onScreenOrientationChangeEvent(); // run once on load
  39. // iOS 13+
  40. if ( window.DeviceOrientationEvent !== undefined && typeof window.DeviceOrientationEvent.requestPermission === 'function' ) {
  41. window.DeviceOrientationEvent.requestPermission().then( function ( response ) {
  42. if ( response == 'granted' ) {
  43. window.addEventListener( 'orientationchange', onScreenOrientationChangeEvent, false );
  44. window.addEventListener( 'deviceorientation', onDeviceOrientationChangeEvent, false );
  45. }
  46. } ).catch( function ( error ) {
  47. console.error( 'THREE.DeviceOrientationControls: Unable to use DeviceOrientation API:', error );
  48. } );
  49. } else {
  50. window.addEventListener( 'orientationchange', onScreenOrientationChangeEvent, false );
  51. window.addEventListener( 'deviceorientation', onDeviceOrientationChangeEvent, false );
  52. }
  53. scope.enabled = true;
  54. };
  55. this.disconnect = function () {
  56. window.removeEventListener( 'orientationchange', onScreenOrientationChangeEvent, false );
  57. window.removeEventListener( 'deviceorientation', onDeviceOrientationChangeEvent, false );
  58. scope.enabled = false;
  59. };
  60. this.update = ( function () {
  61. var lastQuaternion = new THREE.Quaternion();
  62. return function () {
  63. if ( scope.enabled === false ) return;
  64. var device = scope.deviceOrientation;
  65. if ( device ) {
  66. var alpha = device.alpha ? THREE.MathUtils.degToRad( device.alpha ) + scope.alphaOffset : 0; // Z
  67. var beta = device.beta ? THREE.MathUtils.degToRad( device.beta ) : 0; // X'
  68. var gamma = device.gamma ? THREE.MathUtils.degToRad( device.gamma ) : 0; // Y''
  69. var orient = scope.screenOrientation ? THREE.MathUtils.degToRad( scope.screenOrientation ) : 0; // O
  70. setObjectQuaternion( scope.object.quaternion, alpha, beta, gamma, orient );
  71. if ( 8 * ( 1 - lastQuaternion.dot( scope.object.quaternion ) ) > EPS ) {
  72. lastQuaternion.copy( scope.object.quaternion );
  73. scope.dispatchEvent( changeEvent );
  74. }
  75. }
  76. };
  77. } )();
  78. this.dispose = function () {
  79. scope.disconnect();
  80. };
  81. this.connect();
  82. };
  83. THREE.DeviceOrientationControls.prototype = Object.create( THREE.EventDispatcher.prototype );
  84. THREE.DeviceOrientationControls.prototype.constructor = THREE.DeviceOrientationControls;