VREffect.js 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404
  1. /**
  2. * @author dmarcos / https://github.com/dmarcos
  3. * @author mrdoob / http://mrdoob.com
  4. *
  5. * WebVR Spec: http://mozvr.github.io/webvr-spec/webvr.html
  6. *
  7. * Firefox: http://mozvr.com/downloads/
  8. * Chromium: https://drive.google.com/folderview?id=0BzudLt22BqGRbW9WTHMtOWMzNjQ&usp=sharing#list
  9. *
  10. */
  11. THREE.VREffect = function ( renderer, onError ) {
  12. var vrHMD;
  13. var isDeprecatedAPI = false;
  14. var eyeTranslationL = new THREE.Vector3();
  15. var eyeTranslationR = new THREE.Vector3();
  16. var renderRectL, renderRectR;
  17. var eyeFOVL, eyeFOVR;
  18. function gotVRDevices( devices ) {
  19. for ( var i = 0; i < devices.length; i ++ ) {
  20. if ( 'VRDisplay' in window && devices[ i ] instanceof VRDisplay ) {
  21. vrHMD = devices[ i ];
  22. isDeprecatedAPI = false;
  23. break; // We keep the first we encounter
  24. } else if ( 'HMDVRDevice' in window && devices[ i ] instanceof HMDVRDevice ) {
  25. vrHMD = devices[ i ];
  26. isDeprecatedAPI = true;
  27. break; // We keep the first we encounter
  28. }
  29. }
  30. if ( vrHMD === undefined ) {
  31. if ( onError ) onError( 'HMD not available' );
  32. }
  33. }
  34. if ( navigator.getVRDisplays ) {
  35. navigator.getVRDisplays().then( gotVRDevices );
  36. } else if ( navigator.getVRDevices ) {
  37. // Deprecated API.
  38. navigator.getVRDevices().then( gotVRDevices );
  39. }
  40. //
  41. this.scale = 1;
  42. var isPresenting = false;
  43. var rendererSize = renderer.getSize();
  44. var rendererPixelRatio = renderer.getPixelRatio();
  45. this.setSize = function ( width, height ) {
  46. rendererSize = { width: width, height: height };
  47. if ( isPresenting ) {
  48. var eyeParamsL = vrHMD.getEyeParameters( 'left' );
  49. renderer.setPixelRatio( 1 );
  50. if ( isDeprecatedAPI ) {
  51. renderer.setSize( eyeParamsL.renderRect.width * 2, eyeParamsL.renderRect.height, false );
  52. } else {
  53. renderer.setSize( eyeParamsL.renderWidth * 2, eyeParamsL.renderHeight, false );
  54. }
  55. } else {
  56. renderer.setPixelRatio( rendererPixelRatio );
  57. renderer.setSize( width, height );
  58. }
  59. };
  60. // fullscreen
  61. var canvas = renderer.domElement;
  62. var fullscreenchange = canvas.mozRequestFullScreen ? 'mozfullscreenchange' : 'webkitfullscreenchange';
  63. document.addEventListener( fullscreenchange, function () {
  64. isPresenting = vrHMD !== undefined && ( vrHMD.isPresenting || ( isDeprecatedAPI && ( document.mozFullScreenElement || document.webkitFullscreenElement ) !== undefined ) );
  65. if ( isPresenting ) {
  66. rendererPixelRatio = renderer.getPixelRatio();
  67. rendererSize = renderer.getSize();
  68. var eyeParamsL = vrHMD.getEyeParameters( 'left' );
  69. var eyeWidth, eyeHeight;
  70. if ( isDeprecatedAPI ) {
  71. eyeWidth = eyeParamsL.renderRect.width;
  72. eyeHeight = eyeParamsL.renderRect.height;
  73. } else {
  74. eyeWidth = eyeParamsL.renderWidth;
  75. eyeHeight = eyeParamsL.renderHeight;
  76. }
  77. renderer.setPixelRatio( 1 );
  78. renderer.setSize( eyeWidth * 2, eyeHeight, false );
  79. } else {
  80. renderer.setPixelRatio( rendererPixelRatio );
  81. renderer.setSize( rendererSize.width, rendererSize.height );
  82. }
  83. }, false );
  84. window.addEventListener( 'vrdisplaypresentchange', function () {
  85. isPresenting = vrHMD && vrHMD.isPresenting;
  86. if ( isPresenting ) {
  87. rendererPixelRatio = renderer.getPixelRatio();
  88. rendererSize = renderer.getSize();
  89. var eyeParamsL = vrHMD.getEyeParameters( 'left' );
  90. renderer.setPixelRatio( 1 );
  91. renderer.setSize( eyeParamsL.renderWidth * 2, eyeParamsL.renderHeight, false );
  92. } else {
  93. renderer.setPixelRatio( rendererPixelRatio );
  94. renderer.setSize( rendererSize.width, rendererSize.height );
  95. }
  96. }, false );
  97. this.setFullScreen = function ( boolean ) {
  98. return new Promise( function ( resolve, reject ) {
  99. if ( vrHMD === undefined ) {
  100. reject( new Error( 'No VR hardware found.' ) );
  101. return;
  102. }
  103. if ( isPresenting === boolean ) {
  104. resolve();
  105. return;
  106. }
  107. if ( ! isDeprecatedAPI ) {
  108. if ( boolean ) {
  109. resolve( vrHMD.requestPresent( [ { source: canvas } ] ) );
  110. } else {
  111. resolve( vrHMD.exitPresent() );
  112. }
  113. } else {
  114. if ( canvas.mozRequestFullScreen ) {
  115. canvas.mozRequestFullScreen( { vrDisplay: vrHMD } );
  116. resolve();
  117. } else if ( canvas.webkitRequestFullscreen ) {
  118. canvas.webkitRequestFullscreen( { vrDisplay: vrHMD } );
  119. resolve();
  120. } else {
  121. console.error( 'No compatible requestFullscreen method found.' );
  122. reject( new Error( 'No compatible requestFullscreen method found.' ) );
  123. }
  124. }
  125. } );
  126. };
  127. this.requestPresent = function () {
  128. return this.setFullScreen( true );
  129. };
  130. this.exitPresent = function () {
  131. return this.setFullScreen( false );
  132. };
  133. // render
  134. var cameraL = new THREE.PerspectiveCamera();
  135. cameraL.layers.enable( 1 );
  136. var cameraR = new THREE.PerspectiveCamera();
  137. cameraR.layers.enable( 2 );
  138. this.render = function ( scene, camera ) {
  139. if ( vrHMD && isPresenting ) {
  140. var autoUpdate = scene.autoUpdate;
  141. if ( autoUpdate ) {
  142. scene.updateMatrixWorld();
  143. scene.autoUpdate = false;
  144. }
  145. var eyeParamsL = vrHMD.getEyeParameters( 'left' );
  146. var eyeParamsR = vrHMD.getEyeParameters( 'right' );
  147. if ( ! isDeprecatedAPI ) {
  148. eyeTranslationL.fromArray( eyeParamsL.offset );
  149. eyeTranslationR.fromArray( eyeParamsR.offset );
  150. eyeFOVL = eyeParamsL.fieldOfView;
  151. eyeFOVR = eyeParamsR.fieldOfView;
  152. } else {
  153. eyeTranslationL.copy( eyeParamsL.eyeTranslation );
  154. eyeTranslationR.copy( eyeParamsR.eyeTranslation );
  155. eyeFOVL = eyeParamsL.recommendedFieldOfView;
  156. eyeFOVR = eyeParamsR.recommendedFieldOfView;
  157. }
  158. if ( Array.isArray( scene ) ) {
  159. console.warn( 'THREE.VREffect.render() no longer supports arrays. Use object.layers instead.' );
  160. scene = scene[ 0 ];
  161. }
  162. // When rendering we don't care what the recommended size is, only what the actual size
  163. // of the backbuffer is.
  164. var size = renderer.getSize();
  165. renderRectL = { x: 0, y: 0, width: size.width / 2, height: size.height };
  166. renderRectR = { x: size.width / 2, y: 0, width: size.width / 2, height: size.height };
  167. renderer.setScissorTest( true );
  168. renderer.clear();
  169. if ( camera.parent === null ) camera.updateMatrixWorld();
  170. cameraL.projectionMatrix = fovToProjection( eyeFOVL, true, camera.near, camera.far );
  171. cameraR.projectionMatrix = fovToProjection( eyeFOVR, true, camera.near, camera.far );
  172. camera.matrixWorld.decompose( cameraL.position, cameraL.quaternion, cameraL.scale );
  173. camera.matrixWorld.decompose( cameraR.position, cameraR.quaternion, cameraR.scale );
  174. var scale = this.scale;
  175. cameraL.translateOnAxis( eyeTranslationL, scale );
  176. cameraR.translateOnAxis( eyeTranslationR, scale );
  177. // render left eye
  178. renderer.setViewport( renderRectL.x, renderRectL.y, renderRectL.width, renderRectL.height );
  179. renderer.setScissor( renderRectL.x, renderRectL.y, renderRectL.width, renderRectL.height );
  180. renderer.render( scene, cameraL );
  181. // render right eye
  182. renderer.setViewport( renderRectR.x, renderRectR.y, renderRectR.width, renderRectR.height );
  183. renderer.setScissor( renderRectR.x, renderRectR.y, renderRectR.width, renderRectR.height );
  184. renderer.render( scene, cameraR );
  185. renderer.setScissorTest( false );
  186. if ( autoUpdate ) {
  187. scene.autoUpdate = true;
  188. }
  189. if ( ! isDeprecatedAPI ) {
  190. vrHMD.submitFrame();
  191. }
  192. return;
  193. }
  194. // Regular render mode if not HMD
  195. renderer.render( scene, camera );
  196. };
  197. //
  198. function fovToNDCScaleOffset( fov ) {
  199. var pxscale = 2.0 / ( fov.leftTan + fov.rightTan );
  200. var pxoffset = ( fov.leftTan - fov.rightTan ) * pxscale * 0.5;
  201. var pyscale = 2.0 / ( fov.upTan + fov.downTan );
  202. var pyoffset = ( fov.upTan - fov.downTan ) * pyscale * 0.5;
  203. return { scale: [ pxscale, pyscale ], offset: [ pxoffset, pyoffset ] };
  204. }
  205. function fovPortToProjection( fov, rightHanded, zNear, zFar ) {
  206. rightHanded = rightHanded === undefined ? true : rightHanded;
  207. zNear = zNear === undefined ? 0.01 : zNear;
  208. zFar = zFar === undefined ? 10000.0 : zFar;
  209. var handednessScale = rightHanded ? - 1.0 : 1.0;
  210. // start with an identity matrix
  211. var mobj = new THREE.Matrix4();
  212. var m = mobj.elements;
  213. // and with scale/offset info for normalized device coords
  214. var scaleAndOffset = fovToNDCScaleOffset( fov );
  215. // X result, map clip edges to [-w,+w]
  216. m[ 0 * 4 + 0 ] = scaleAndOffset.scale[ 0 ];
  217. m[ 0 * 4 + 1 ] = 0.0;
  218. m[ 0 * 4 + 2 ] = scaleAndOffset.offset[ 0 ] * handednessScale;
  219. m[ 0 * 4 + 3 ] = 0.0;
  220. // Y result, map clip edges to [-w,+w]
  221. // Y offset is negated because this proj matrix transforms from world coords with Y=up,
  222. // but the NDC scaling has Y=down (thanks D3D?)
  223. m[ 1 * 4 + 0 ] = 0.0;
  224. m[ 1 * 4 + 1 ] = scaleAndOffset.scale[ 1 ];
  225. m[ 1 * 4 + 2 ] = - scaleAndOffset.offset[ 1 ] * handednessScale;
  226. m[ 1 * 4 + 3 ] = 0.0;
  227. // Z result (up to the app)
  228. m[ 2 * 4 + 0 ] = 0.0;
  229. m[ 2 * 4 + 1 ] = 0.0;
  230. m[ 2 * 4 + 2 ] = zFar / ( zNear - zFar ) * - handednessScale;
  231. m[ 2 * 4 + 3 ] = ( zFar * zNear ) / ( zNear - zFar );
  232. // W result (= Z in)
  233. m[ 3 * 4 + 0 ] = 0.0;
  234. m[ 3 * 4 + 1 ] = 0.0;
  235. m[ 3 * 4 + 2 ] = handednessScale;
  236. m[ 3 * 4 + 3 ] = 0.0;
  237. mobj.transpose();
  238. return mobj;
  239. }
  240. function fovToProjection( fov, rightHanded, zNear, zFar ) {
  241. var DEG2RAD = Math.PI / 180.0;
  242. var fovPort = {
  243. upTan: Math.tan( fov.upDegrees * DEG2RAD ),
  244. downTan: Math.tan( fov.downDegrees * DEG2RAD ),
  245. leftTan: Math.tan( fov.leftDegrees * DEG2RAD ),
  246. rightTan: Math.tan( fov.rightDegrees * DEG2RAD )
  247. };
  248. return fovPortToProjection( fovPort, rightHanded, zNear, zFar );
  249. }
  250. };