Matrix4.js 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948
  1. import { Vector3 } from './Vector3.js';
  2. /**
  3. * @author mrdoob / http://mrdoob.com/
  4. * @author supereggbert / http://www.paulbrunt.co.uk/
  5. * @author philogb / http://blog.thejit.org/
  6. * @author jordi_ros / http://plattsoft.com
  7. * @author D1plo1d / http://github.com/D1plo1d
  8. * @author alteredq / http://alteredqualia.com/
  9. * @author mikael emtinger / http://gomo.se/
  10. * @author timknip / http://www.floorplanner.com/
  11. * @author bhouston / http://clara.io
  12. * @author WestLangley / http://github.com/WestLangley
  13. */
  14. function Matrix4() {
  15. this.elements = [
  16. 1, 0, 0, 0,
  17. 0, 1, 0, 0,
  18. 0, 0, 1, 0,
  19. 0, 0, 0, 1
  20. ];
  21. if ( arguments.length > 0 ) {
  22. console.error( 'THREE.Matrix4: the constructor no longer reads arguments. use .set() instead.' );
  23. }
  24. }
  25. Object.assign( Matrix4.prototype, {
  26. isMatrix4: true,
  27. set: function ( n11, n12, n13, n14, n21, n22, n23, n24, n31, n32, n33, n34, n41, n42, n43, n44 ) {
  28. var te = this.elements;
  29. te[ 0 ] = n11; te[ 4 ] = n12; te[ 8 ] = n13; te[ 12 ] = n14;
  30. te[ 1 ] = n21; te[ 5 ] = n22; te[ 9 ] = n23; te[ 13 ] = n24;
  31. te[ 2 ] = n31; te[ 6 ] = n32; te[ 10 ] = n33; te[ 14 ] = n34;
  32. te[ 3 ] = n41; te[ 7 ] = n42; te[ 11 ] = n43; te[ 15 ] = n44;
  33. return this;
  34. },
  35. identity: function () {
  36. this.set(
  37. 1, 0, 0, 0,
  38. 0, 1, 0, 0,
  39. 0, 0, 1, 0,
  40. 0, 0, 0, 1
  41. );
  42. return this;
  43. },
  44. clone: function () {
  45. return new Matrix4().fromArray( this.elements );
  46. },
  47. copy: function ( m ) {
  48. var te = this.elements;
  49. var me = m.elements;
  50. te[ 0 ] = me[ 0 ]; te[ 1 ] = me[ 1 ]; te[ 2 ] = me[ 2 ]; te[ 3 ] = me[ 3 ];
  51. te[ 4 ] = me[ 4 ]; te[ 5 ] = me[ 5 ]; te[ 6 ] = me[ 6 ]; te[ 7 ] = me[ 7 ];
  52. te[ 8 ] = me[ 8 ]; te[ 9 ] = me[ 9 ]; te[ 10 ] = me[ 10 ]; te[ 11 ] = me[ 11 ];
  53. te[ 12 ] = me[ 12 ]; te[ 13 ] = me[ 13 ]; te[ 14 ] = me[ 14 ]; te[ 15 ] = me[ 15 ];
  54. return this;
  55. },
  56. copyPosition: function ( m ) {
  57. var te = this.elements, me = m.elements;
  58. te[ 12 ] = me[ 12 ];
  59. te[ 13 ] = me[ 13 ];
  60. te[ 14 ] = me[ 14 ];
  61. return this;
  62. },
  63. extractBasis: function ( xAxis, yAxis, zAxis ) {
  64. xAxis.setFromMatrixColumn( this, 0 );
  65. yAxis.setFromMatrixColumn( this, 1 );
  66. zAxis.setFromMatrixColumn( this, 2 );
  67. return this;
  68. },
  69. makeBasis: function ( xAxis, yAxis, zAxis ) {
  70. this.set(
  71. xAxis.x, yAxis.x, zAxis.x, 0,
  72. xAxis.y, yAxis.y, zAxis.y, 0,
  73. xAxis.z, yAxis.z, zAxis.z, 0,
  74. 0, 0, 0, 1
  75. );
  76. return this;
  77. },
  78. extractRotation: function () {
  79. var v1 = new Vector3();
  80. return function extractRotation( m ) {
  81. // this method does not support reflection matrices
  82. var te = this.elements;
  83. var me = m.elements;
  84. var scaleX = 1 / v1.setFromMatrixColumn( m, 0 ).length();
  85. var scaleY = 1 / v1.setFromMatrixColumn( m, 1 ).length();
  86. var scaleZ = 1 / v1.setFromMatrixColumn( m, 2 ).length();
  87. te[ 0 ] = me[ 0 ] * scaleX;
  88. te[ 1 ] = me[ 1 ] * scaleX;
  89. te[ 2 ] = me[ 2 ] * scaleX;
  90. te[ 3 ] = 0;
  91. te[ 4 ] = me[ 4 ] * scaleY;
  92. te[ 5 ] = me[ 5 ] * scaleY;
  93. te[ 6 ] = me[ 6 ] * scaleY;
  94. te[ 7 ] = 0;
  95. te[ 8 ] = me[ 8 ] * scaleZ;
  96. te[ 9 ] = me[ 9 ] * scaleZ;
  97. te[ 10 ] = me[ 10 ] * scaleZ;
  98. te[ 11 ] = 0;
  99. te[ 12 ] = 0;
  100. te[ 13 ] = 0;
  101. te[ 14 ] = 0;
  102. te[ 15 ] = 1;
  103. return this;
  104. };
  105. }(),
  106. makeRotationFromEuler: function ( euler ) {
  107. if ( ! ( euler && euler.isEuler ) ) {
  108. console.error( 'THREE.Matrix4: .makeRotationFromEuler() now expects a Euler rotation rather than a Vector3 and order.' );
  109. }
  110. var te = this.elements;
  111. var x = euler.x, y = euler.y, z = euler.z;
  112. var a = Math.cos( x ), b = Math.sin( x );
  113. var c = Math.cos( y ), d = Math.sin( y );
  114. var e = Math.cos( z ), f = Math.sin( z );
  115. if ( euler.order === 'XYZ' ) {
  116. var ae = a * e, af = a * f, be = b * e, bf = b * f;
  117. te[ 0 ] = c * e;
  118. te[ 4 ] = - c * f;
  119. te[ 8 ] = d;
  120. te[ 1 ] = af + be * d;
  121. te[ 5 ] = ae - bf * d;
  122. te[ 9 ] = - b * c;
  123. te[ 2 ] = bf - ae * d;
  124. te[ 6 ] = be + af * d;
  125. te[ 10 ] = a * c;
  126. } else if ( euler.order === 'YXZ' ) {
  127. var ce = c * e, cf = c * f, de = d * e, df = d * f;
  128. te[ 0 ] = ce + df * b;
  129. te[ 4 ] = de * b - cf;
  130. te[ 8 ] = a * d;
  131. te[ 1 ] = a * f;
  132. te[ 5 ] = a * e;
  133. te[ 9 ] = - b;
  134. te[ 2 ] = cf * b - de;
  135. te[ 6 ] = df + ce * b;
  136. te[ 10 ] = a * c;
  137. } else if ( euler.order === 'ZXY' ) {
  138. var ce = c * e, cf = c * f, de = d * e, df = d * f;
  139. te[ 0 ] = ce - df * b;
  140. te[ 4 ] = - a * f;
  141. te[ 8 ] = de + cf * b;
  142. te[ 1 ] = cf + de * b;
  143. te[ 5 ] = a * e;
  144. te[ 9 ] = df - ce * b;
  145. te[ 2 ] = - a * d;
  146. te[ 6 ] = b;
  147. te[ 10 ] = a * c;
  148. } else if ( euler.order === 'ZYX' ) {
  149. var ae = a * e, af = a * f, be = b * e, bf = b * f;
  150. te[ 0 ] = c * e;
  151. te[ 4 ] = be * d - af;
  152. te[ 8 ] = ae * d + bf;
  153. te[ 1 ] = c * f;
  154. te[ 5 ] = bf * d + ae;
  155. te[ 9 ] = af * d - be;
  156. te[ 2 ] = - d;
  157. te[ 6 ] = b * c;
  158. te[ 10 ] = a * c;
  159. } else if ( euler.order === 'YZX' ) {
  160. var ac = a * c, ad = a * d, bc = b * c, bd = b * d;
  161. te[ 0 ] = c * e;
  162. te[ 4 ] = bd - ac * f;
  163. te[ 8 ] = bc * f + ad;
  164. te[ 1 ] = f;
  165. te[ 5 ] = a * e;
  166. te[ 9 ] = - b * e;
  167. te[ 2 ] = - d * e;
  168. te[ 6 ] = ad * f + bc;
  169. te[ 10 ] = ac - bd * f;
  170. } else if ( euler.order === 'XZY' ) {
  171. var ac = a * c, ad = a * d, bc = b * c, bd = b * d;
  172. te[ 0 ] = c * e;
  173. te[ 4 ] = - f;
  174. te[ 8 ] = d * e;
  175. te[ 1 ] = ac * f + bd;
  176. te[ 5 ] = a * e;
  177. te[ 9 ] = ad * f - bc;
  178. te[ 2 ] = bc * f - ad;
  179. te[ 6 ] = b * e;
  180. te[ 10 ] = bd * f + ac;
  181. }
  182. // bottom row
  183. te[ 3 ] = 0;
  184. te[ 7 ] = 0;
  185. te[ 11 ] = 0;
  186. // last column
  187. te[ 12 ] = 0;
  188. te[ 13 ] = 0;
  189. te[ 14 ] = 0;
  190. te[ 15 ] = 1;
  191. return this;
  192. },
  193. makeRotationFromQuaternion: function () {
  194. var zero = new Vector3( 0, 0, 0 );
  195. var one = new Vector3( 1, 1, 1 );
  196. return function makeRotationFromQuaternion( q ) {
  197. return this.compose( zero, q, one );
  198. };
  199. }(),
  200. lookAt: function () {
  201. var x = new Vector3();
  202. var y = new Vector3();
  203. var z = new Vector3();
  204. return function lookAt( eye, target, up ) {
  205. var te = this.elements;
  206. z.subVectors( eye, target );
  207. if ( z.lengthSq() === 0 ) {
  208. // eye and target are in the same position
  209. z.z = 1;
  210. }
  211. z.normalize();
  212. x.crossVectors( up, z );
  213. if ( x.lengthSq() === 0 ) {
  214. // up and z are parallel
  215. if ( Math.abs( up.z ) === 1 ) {
  216. z.x += 0.0001;
  217. } else {
  218. z.z += 0.0001;
  219. }
  220. z.normalize();
  221. x.crossVectors( up, z );
  222. }
  223. x.normalize();
  224. y.crossVectors( z, x );
  225. te[ 0 ] = x.x; te[ 4 ] = y.x; te[ 8 ] = z.x;
  226. te[ 1 ] = x.y; te[ 5 ] = y.y; te[ 9 ] = z.y;
  227. te[ 2 ] = x.z; te[ 6 ] = y.z; te[ 10 ] = z.z;
  228. return this;
  229. };
  230. }(),
  231. multiply: function ( m, n ) {
  232. if ( n !== undefined ) {
  233. console.warn( 'THREE.Matrix4: .multiply() now only accepts one argument. Use .multiplyMatrices( a, b ) instead.' );
  234. return this.multiplyMatrices( m, n );
  235. }
  236. return this.multiplyMatrices( this, m );
  237. },
  238. premultiply: function ( m ) {
  239. return this.multiplyMatrices( m, this );
  240. },
  241. multiplyMatrices: function ( a, b ) {
  242. var ae = a.elements;
  243. var be = b.elements;
  244. var te = this.elements;
  245. var a11 = ae[ 0 ], a12 = ae[ 4 ], a13 = ae[ 8 ], a14 = ae[ 12 ];
  246. var a21 = ae[ 1 ], a22 = ae[ 5 ], a23 = ae[ 9 ], a24 = ae[ 13 ];
  247. var a31 = ae[ 2 ], a32 = ae[ 6 ], a33 = ae[ 10 ], a34 = ae[ 14 ];
  248. var a41 = ae[ 3 ], a42 = ae[ 7 ], a43 = ae[ 11 ], a44 = ae[ 15 ];
  249. var b11 = be[ 0 ], b12 = be[ 4 ], b13 = be[ 8 ], b14 = be[ 12 ];
  250. var b21 = be[ 1 ], b22 = be[ 5 ], b23 = be[ 9 ], b24 = be[ 13 ];
  251. var b31 = be[ 2 ], b32 = be[ 6 ], b33 = be[ 10 ], b34 = be[ 14 ];
  252. var b41 = be[ 3 ], b42 = be[ 7 ], b43 = be[ 11 ], b44 = be[ 15 ];
  253. te[ 0 ] = a11 * b11 + a12 * b21 + a13 * b31 + a14 * b41;
  254. te[ 4 ] = a11 * b12 + a12 * b22 + a13 * b32 + a14 * b42;
  255. te[ 8 ] = a11 * b13 + a12 * b23 + a13 * b33 + a14 * b43;
  256. te[ 12 ] = a11 * b14 + a12 * b24 + a13 * b34 + a14 * b44;
  257. te[ 1 ] = a21 * b11 + a22 * b21 + a23 * b31 + a24 * b41;
  258. te[ 5 ] = a21 * b12 + a22 * b22 + a23 * b32 + a24 * b42;
  259. te[ 9 ] = a21 * b13 + a22 * b23 + a23 * b33 + a24 * b43;
  260. te[ 13 ] = a21 * b14 + a22 * b24 + a23 * b34 + a24 * b44;
  261. te[ 2 ] = a31 * b11 + a32 * b21 + a33 * b31 + a34 * b41;
  262. te[ 6 ] = a31 * b12 + a32 * b22 + a33 * b32 + a34 * b42;
  263. te[ 10 ] = a31 * b13 + a32 * b23 + a33 * b33 + a34 * b43;
  264. te[ 14 ] = a31 * b14 + a32 * b24 + a33 * b34 + a34 * b44;
  265. te[ 3 ] = a41 * b11 + a42 * b21 + a43 * b31 + a44 * b41;
  266. te[ 7 ] = a41 * b12 + a42 * b22 + a43 * b32 + a44 * b42;
  267. te[ 11 ] = a41 * b13 + a42 * b23 + a43 * b33 + a44 * b43;
  268. te[ 15 ] = a41 * b14 + a42 * b24 + a43 * b34 + a44 * b44;
  269. return this;
  270. },
  271. multiplyScalar: function ( s ) {
  272. var te = this.elements;
  273. te[ 0 ] *= s; te[ 4 ] *= s; te[ 8 ] *= s; te[ 12 ] *= s;
  274. te[ 1 ] *= s; te[ 5 ] *= s; te[ 9 ] *= s; te[ 13 ] *= s;
  275. te[ 2 ] *= s; te[ 6 ] *= s; te[ 10 ] *= s; te[ 14 ] *= s;
  276. te[ 3 ] *= s; te[ 7 ] *= s; te[ 11 ] *= s; te[ 15 ] *= s;
  277. return this;
  278. },
  279. applyToBufferAttribute: function () {
  280. var v1 = new Vector3();
  281. return function applyToBufferAttribute( attribute ) {
  282. for ( var i = 0, l = attribute.count; i < l; i ++ ) {
  283. v1.x = attribute.getX( i );
  284. v1.y = attribute.getY( i );
  285. v1.z = attribute.getZ( i );
  286. v1.applyMatrix4( this );
  287. attribute.setXYZ( i, v1.x, v1.y, v1.z );
  288. }
  289. return attribute;
  290. };
  291. }(),
  292. determinant: function () {
  293. var te = this.elements;
  294. var n11 = te[ 0 ], n12 = te[ 4 ], n13 = te[ 8 ], n14 = te[ 12 ];
  295. var n21 = te[ 1 ], n22 = te[ 5 ], n23 = te[ 9 ], n24 = te[ 13 ];
  296. var n31 = te[ 2 ], n32 = te[ 6 ], n33 = te[ 10 ], n34 = te[ 14 ];
  297. var n41 = te[ 3 ], n42 = te[ 7 ], n43 = te[ 11 ], n44 = te[ 15 ];
  298. //TODO: make this more efficient
  299. //( based on http://www.euclideanspace.com/maths/algebra/matrix/functions/inverse/fourD/index.htm )
  300. return (
  301. n41 * (
  302. + n14 * n23 * n32
  303. - n13 * n24 * n32
  304. - n14 * n22 * n33
  305. + n12 * n24 * n33
  306. + n13 * n22 * n34
  307. - n12 * n23 * n34
  308. ) +
  309. n42 * (
  310. + n11 * n23 * n34
  311. - n11 * n24 * n33
  312. + n14 * n21 * n33
  313. - n13 * n21 * n34
  314. + n13 * n24 * n31
  315. - n14 * n23 * n31
  316. ) +
  317. n43 * (
  318. + n11 * n24 * n32
  319. - n11 * n22 * n34
  320. - n14 * n21 * n32
  321. + n12 * n21 * n34
  322. + n14 * n22 * n31
  323. - n12 * n24 * n31
  324. ) +
  325. n44 * (
  326. - n13 * n22 * n31
  327. - n11 * n23 * n32
  328. + n11 * n22 * n33
  329. + n13 * n21 * n32
  330. - n12 * n21 * n33
  331. + n12 * n23 * n31
  332. )
  333. );
  334. },
  335. transpose: function () {
  336. var te = this.elements;
  337. var tmp;
  338. tmp = te[ 1 ]; te[ 1 ] = te[ 4 ]; te[ 4 ] = tmp;
  339. tmp = te[ 2 ]; te[ 2 ] = te[ 8 ]; te[ 8 ] = tmp;
  340. tmp = te[ 6 ]; te[ 6 ] = te[ 9 ]; te[ 9 ] = tmp;
  341. tmp = te[ 3 ]; te[ 3 ] = te[ 12 ]; te[ 12 ] = tmp;
  342. tmp = te[ 7 ]; te[ 7 ] = te[ 13 ]; te[ 13 ] = tmp;
  343. tmp = te[ 11 ]; te[ 11 ] = te[ 14 ]; te[ 14 ] = tmp;
  344. return this;
  345. },
  346. setPosition: function ( x, y, z ) {
  347. var te = this.elements;
  348. if ( x.isVector3 ) {
  349. te[ 12 ] = x.x;
  350. te[ 13 ] = x.y;
  351. te[ 14 ] = x.z;
  352. } else {
  353. te[ 12 ] = x;
  354. te[ 13 ] = y;
  355. te[ 14 ] = z;
  356. }
  357. return this;
  358. },
  359. getInverse: function ( m, throwOnDegenerate ) {
  360. // based on http://www.euclideanspace.com/maths/algebra/matrix/functions/inverse/fourD/index.htm
  361. var te = this.elements,
  362. me = m.elements,
  363. n11 = me[ 0 ], n21 = me[ 1 ], n31 = me[ 2 ], n41 = me[ 3 ],
  364. n12 = me[ 4 ], n22 = me[ 5 ], n32 = me[ 6 ], n42 = me[ 7 ],
  365. n13 = me[ 8 ], n23 = me[ 9 ], n33 = me[ 10 ], n43 = me[ 11 ],
  366. n14 = me[ 12 ], n24 = me[ 13 ], n34 = me[ 14 ], n44 = me[ 15 ],
  367. t11 = n23 * n34 * n42 - n24 * n33 * n42 + n24 * n32 * n43 - n22 * n34 * n43 - n23 * n32 * n44 + n22 * n33 * n44,
  368. t12 = n14 * n33 * n42 - n13 * n34 * n42 - n14 * n32 * n43 + n12 * n34 * n43 + n13 * n32 * n44 - n12 * n33 * n44,
  369. t13 = n13 * n24 * n42 - n14 * n23 * n42 + n14 * n22 * n43 - n12 * n24 * n43 - n13 * n22 * n44 + n12 * n23 * n44,
  370. t14 = n14 * n23 * n32 - n13 * n24 * n32 - n14 * n22 * n33 + n12 * n24 * n33 + n13 * n22 * n34 - n12 * n23 * n34;
  371. var det = n11 * t11 + n21 * t12 + n31 * t13 + n41 * t14;
  372. if ( det === 0 ) {
  373. var msg = "THREE.Matrix4: .getInverse() can't invert matrix, determinant is 0";
  374. if ( throwOnDegenerate === true ) {
  375. throw new Error( msg );
  376. } else {
  377. console.warn( msg );
  378. }
  379. return this.identity();
  380. }
  381. var detInv = 1 / det;
  382. te[ 0 ] = t11 * detInv;
  383. te[ 1 ] = ( n24 * n33 * n41 - n23 * n34 * n41 - n24 * n31 * n43 + n21 * n34 * n43 + n23 * n31 * n44 - n21 * n33 * n44 ) * detInv;
  384. te[ 2 ] = ( n22 * n34 * n41 - n24 * n32 * n41 + n24 * n31 * n42 - n21 * n34 * n42 - n22 * n31 * n44 + n21 * n32 * n44 ) * detInv;
  385. te[ 3 ] = ( n23 * n32 * n41 - n22 * n33 * n41 - n23 * n31 * n42 + n21 * n33 * n42 + n22 * n31 * n43 - n21 * n32 * n43 ) * detInv;
  386. te[ 4 ] = t12 * detInv;
  387. te[ 5 ] = ( n13 * n34 * n41 - n14 * n33 * n41 + n14 * n31 * n43 - n11 * n34 * n43 - n13 * n31 * n44 + n11 * n33 * n44 ) * detInv;
  388. te[ 6 ] = ( n14 * n32 * n41 - n12 * n34 * n41 - n14 * n31 * n42 + n11 * n34 * n42 + n12 * n31 * n44 - n11 * n32 * n44 ) * detInv;
  389. te[ 7 ] = ( n12 * n33 * n41 - n13 * n32 * n41 + n13 * n31 * n42 - n11 * n33 * n42 - n12 * n31 * n43 + n11 * n32 * n43 ) * detInv;
  390. te[ 8 ] = t13 * detInv;
  391. te[ 9 ] = ( n14 * n23 * n41 - n13 * n24 * n41 - n14 * n21 * n43 + n11 * n24 * n43 + n13 * n21 * n44 - n11 * n23 * n44 ) * detInv;
  392. te[ 10 ] = ( n12 * n24 * n41 - n14 * n22 * n41 + n14 * n21 * n42 - n11 * n24 * n42 - n12 * n21 * n44 + n11 * n22 * n44 ) * detInv;
  393. te[ 11 ] = ( n13 * n22 * n41 - n12 * n23 * n41 - n13 * n21 * n42 + n11 * n23 * n42 + n12 * n21 * n43 - n11 * n22 * n43 ) * detInv;
  394. te[ 12 ] = t14 * detInv;
  395. te[ 13 ] = ( n13 * n24 * n31 - n14 * n23 * n31 + n14 * n21 * n33 - n11 * n24 * n33 - n13 * n21 * n34 + n11 * n23 * n34 ) * detInv;
  396. te[ 14 ] = ( n14 * n22 * n31 - n12 * n24 * n31 - n14 * n21 * n32 + n11 * n24 * n32 + n12 * n21 * n34 - n11 * n22 * n34 ) * detInv;
  397. te[ 15 ] = ( n12 * n23 * n31 - n13 * n22 * n31 + n13 * n21 * n32 - n11 * n23 * n32 - n12 * n21 * n33 + n11 * n22 * n33 ) * detInv;
  398. return this;
  399. },
  400. scale: function ( v ) {
  401. var te = this.elements;
  402. var x = v.x, y = v.y, z = v.z;
  403. te[ 0 ] *= x; te[ 4 ] *= y; te[ 8 ] *= z;
  404. te[ 1 ] *= x; te[ 5 ] *= y; te[ 9 ] *= z;
  405. te[ 2 ] *= x; te[ 6 ] *= y; te[ 10 ] *= z;
  406. te[ 3 ] *= x; te[ 7 ] *= y; te[ 11 ] *= z;
  407. return this;
  408. },
  409. getMaxScaleOnAxis: function () {
  410. var te = this.elements;
  411. var scaleXSq = te[ 0 ] * te[ 0 ] + te[ 1 ] * te[ 1 ] + te[ 2 ] * te[ 2 ];
  412. var scaleYSq = te[ 4 ] * te[ 4 ] + te[ 5 ] * te[ 5 ] + te[ 6 ] * te[ 6 ];
  413. var scaleZSq = te[ 8 ] * te[ 8 ] + te[ 9 ] * te[ 9 ] + te[ 10 ] * te[ 10 ];
  414. return Math.sqrt( Math.max( scaleXSq, scaleYSq, scaleZSq ) );
  415. },
  416. makeTranslation: function ( x, y, z ) {
  417. this.set(
  418. 1, 0, 0, x,
  419. 0, 1, 0, y,
  420. 0, 0, 1, z,
  421. 0, 0, 0, 1
  422. );
  423. return this;
  424. },
  425. makeRotationX: function ( theta ) {
  426. var c = Math.cos( theta ), s = Math.sin( theta );
  427. this.set(
  428. 1, 0, 0, 0,
  429. 0, c, - s, 0,
  430. 0, s, c, 0,
  431. 0, 0, 0, 1
  432. );
  433. return this;
  434. },
  435. makeRotationY: function ( theta ) {
  436. var c = Math.cos( theta ), s = Math.sin( theta );
  437. this.set(
  438. c, 0, s, 0,
  439. 0, 1, 0, 0,
  440. - s, 0, c, 0,
  441. 0, 0, 0, 1
  442. );
  443. return this;
  444. },
  445. makeRotationZ: function ( theta ) {
  446. var c = Math.cos( theta ), s = Math.sin( theta );
  447. this.set(
  448. c, - s, 0, 0,
  449. s, c, 0, 0,
  450. 0, 0, 1, 0,
  451. 0, 0, 0, 1
  452. );
  453. return this;
  454. },
  455. makeRotationAxis: function ( axis, angle ) {
  456. // Based on http://www.gamedev.net/reference/articles/article1199.asp
  457. var c = Math.cos( angle );
  458. var s = Math.sin( angle );
  459. var t = 1 - c;
  460. var x = axis.x, y = axis.y, z = axis.z;
  461. var tx = t * x, ty = t * y;
  462. this.set(
  463. tx * x + c, tx * y - s * z, tx * z + s * y, 0,
  464. tx * y + s * z, ty * y + c, ty * z - s * x, 0,
  465. tx * z - s * y, ty * z + s * x, t * z * z + c, 0,
  466. 0, 0, 0, 1
  467. );
  468. return this;
  469. },
  470. makeScale: function ( x, y, z ) {
  471. this.set(
  472. x, 0, 0, 0,
  473. 0, y, 0, 0,
  474. 0, 0, z, 0,
  475. 0, 0, 0, 1
  476. );
  477. return this;
  478. },
  479. makeShear: function ( x, y, z ) {
  480. this.set(
  481. 1, y, z, 0,
  482. x, 1, z, 0,
  483. x, y, 1, 0,
  484. 0, 0, 0, 1
  485. );
  486. return this;
  487. },
  488. compose: function ( position, quaternion, scale ) {
  489. var te = this.elements;
  490. var x = quaternion._x, y = quaternion._y, z = quaternion._z, w = quaternion._w;
  491. var x2 = x + x, y2 = y + y, z2 = z + z;
  492. var xx = x * x2, xy = x * y2, xz = x * z2;
  493. var yy = y * y2, yz = y * z2, zz = z * z2;
  494. var wx = w * x2, wy = w * y2, wz = w * z2;
  495. var sx = scale.x, sy = scale.y, sz = scale.z;
  496. te[ 0 ] = ( 1 - ( yy + zz ) ) * sx;
  497. te[ 1 ] = ( xy + wz ) * sx;
  498. te[ 2 ] = ( xz - wy ) * sx;
  499. te[ 3 ] = 0;
  500. te[ 4 ] = ( xy - wz ) * sy;
  501. te[ 5 ] = ( 1 - ( xx + zz ) ) * sy;
  502. te[ 6 ] = ( yz + wx ) * sy;
  503. te[ 7 ] = 0;
  504. te[ 8 ] = ( xz + wy ) * sz;
  505. te[ 9 ] = ( yz - wx ) * sz;
  506. te[ 10 ] = ( 1 - ( xx + yy ) ) * sz;
  507. te[ 11 ] = 0;
  508. te[ 12 ] = position.x;
  509. te[ 13 ] = position.y;
  510. te[ 14 ] = position.z;
  511. te[ 15 ] = 1;
  512. return this;
  513. },
  514. decompose: function () {
  515. var vector = new Vector3();
  516. var matrix = new Matrix4();
  517. return function decompose( position, quaternion, scale ) {
  518. var te = this.elements;
  519. var sx = vector.set( te[ 0 ], te[ 1 ], te[ 2 ] ).length();
  520. var sy = vector.set( te[ 4 ], te[ 5 ], te[ 6 ] ).length();
  521. var sz = vector.set( te[ 8 ], te[ 9 ], te[ 10 ] ).length();
  522. // if determine is negative, we need to invert one scale
  523. var det = this.determinant();
  524. if ( det < 0 ) sx = - sx;
  525. position.x = te[ 12 ];
  526. position.y = te[ 13 ];
  527. position.z = te[ 14 ];
  528. // scale the rotation part
  529. matrix.copy( this );
  530. var invSX = 1 / sx;
  531. var invSY = 1 / sy;
  532. var invSZ = 1 / sz;
  533. matrix.elements[ 0 ] *= invSX;
  534. matrix.elements[ 1 ] *= invSX;
  535. matrix.elements[ 2 ] *= invSX;
  536. matrix.elements[ 4 ] *= invSY;
  537. matrix.elements[ 5 ] *= invSY;
  538. matrix.elements[ 6 ] *= invSY;
  539. matrix.elements[ 8 ] *= invSZ;
  540. matrix.elements[ 9 ] *= invSZ;
  541. matrix.elements[ 10 ] *= invSZ;
  542. quaternion.setFromRotationMatrix( matrix );
  543. scale.x = sx;
  544. scale.y = sy;
  545. scale.z = sz;
  546. return this;
  547. };
  548. }(),
  549. makePerspective: function ( left, right, top, bottom, near, far ) {
  550. if ( far === undefined ) {
  551. console.warn( 'THREE.Matrix4: .makePerspective() has been redefined and has a new signature. Please check the docs.' );
  552. }
  553. var te = this.elements;
  554. var x = 2 * near / ( right - left );
  555. var y = 2 * near / ( top - bottom );
  556. var a = ( right + left ) / ( right - left );
  557. var b = ( top + bottom ) / ( top - bottom );
  558. var c = - ( far + near ) / ( far - near );
  559. var d = - 2 * far * near / ( far - near );
  560. te[ 0 ] = x; te[ 4 ] = 0; te[ 8 ] = a; te[ 12 ] = 0;
  561. te[ 1 ] = 0; te[ 5 ] = y; te[ 9 ] = b; te[ 13 ] = 0;
  562. te[ 2 ] = 0; te[ 6 ] = 0; te[ 10 ] = c; te[ 14 ] = d;
  563. te[ 3 ] = 0; te[ 7 ] = 0; te[ 11 ] = - 1; te[ 15 ] = 0;
  564. return this;
  565. },
  566. makeOrthographic: function ( left, right, top, bottom, near, far ) {
  567. var te = this.elements;
  568. var w = 1.0 / ( right - left );
  569. var h = 1.0 / ( top - bottom );
  570. var p = 1.0 / ( far - near );
  571. var x = ( right + left ) * w;
  572. var y = ( top + bottom ) * h;
  573. var z = ( far + near ) * p;
  574. te[ 0 ] = 2 * w; te[ 4 ] = 0; te[ 8 ] = 0; te[ 12 ] = - x;
  575. te[ 1 ] = 0; te[ 5 ] = 2 * h; te[ 9 ] = 0; te[ 13 ] = - y;
  576. te[ 2 ] = 0; te[ 6 ] = 0; te[ 10 ] = - 2 * p; te[ 14 ] = - z;
  577. te[ 3 ] = 0; te[ 7 ] = 0; te[ 11 ] = 0; te[ 15 ] = 1;
  578. return this;
  579. },
  580. equals: function ( matrix ) {
  581. var te = this.elements;
  582. var me = matrix.elements;
  583. for ( var i = 0; i < 16; i ++ ) {
  584. if ( te[ i ] !== me[ i ] ) return false;
  585. }
  586. return true;
  587. },
  588. fromArray: function ( array, offset ) {
  589. if ( offset === undefined ) offset = 0;
  590. for ( var i = 0; i < 16; i ++ ) {
  591. this.elements[ i ] = array[ i + offset ];
  592. }
  593. return this;
  594. },
  595. toArray: function ( array, offset ) {
  596. if ( array === undefined ) array = [];
  597. if ( offset === undefined ) offset = 0;
  598. var te = this.elements;
  599. array[ offset ] = te[ 0 ];
  600. array[ offset + 1 ] = te[ 1 ];
  601. array[ offset + 2 ] = te[ 2 ];
  602. array[ offset + 3 ] = te[ 3 ];
  603. array[ offset + 4 ] = te[ 4 ];
  604. array[ offset + 5 ] = te[ 5 ];
  605. array[ offset + 6 ] = te[ 6 ];
  606. array[ offset + 7 ] = te[ 7 ];
  607. array[ offset + 8 ] = te[ 8 ];
  608. array[ offset + 9 ] = te[ 9 ];
  609. array[ offset + 10 ] = te[ 10 ];
  610. array[ offset + 11 ] = te[ 11 ];
  611. array[ offset + 12 ] = te[ 12 ];
  612. array[ offset + 13 ] = te[ 13 ];
  613. array[ offset + 14 ] = te[ 14 ];
  614. array[ offset + 15 ] = te[ 15 ];
  615. return array;
  616. }
  617. } );
  618. export { Matrix4 };