Home Explore Help
Register Sign In
samien
/
three.js
mirror of https://github.com/mrdoob/three.js.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: 08d34b63b7
Branches Tags
three.js
/
docs
/
pages
/
Matrix4.html

Matrix4.html 53 KB
History Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="en">
    3. 

  3. <head>
    4. 

  4. 	<meta charset="utf-8">
    5. 

  5. 	<title>Matrix4 - Three.js Docs</title>
    6. 

  6. 	<meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    7. 

  7. 	<script src="../scripts/highlight.min.js"></script>
    8. 

  8. 	<link type="text/css" rel="stylesheet" href="../styles/highlight-three.css">
    9. 

  9. 	<link type="text/css" rel="stylesheet" href="../styles/page.css">
    10. 

  10. </head>
    11. 

  11. <body>
    12. 

  12. 	<h1 translate="no">Matrix4</h1>
    13. 

  13. 		<section>
    14. 

  14. 			<header>
    15. 

  15. 				<div class="class-description"><p>Represents a 4x4 matrix.</p>
    16. 

  16. <p>The most common use of a 4x4 matrix in 3D computer graphics is as a transformation matrix.
    17. 

  17. For an introduction to transformation matrices as used in WebGL, check out <a href="https://www.opengl-tutorial.org/beginners-tutorials/tutorial-3-matrices" target="_blank" rel="noopener">this tutorial</a></p>
    18. 

  18. <p>This allows a 3D vector representing a point in 3D space to undergo
    19. 

  19. transformations such as translation, rotation, shear, scale, reflection,
    20. 

  20. orthogonal or perspective projection and so on, by being multiplied by the
    21. 

  21. matrix. This is known as <code>applying</code> the matrix to the vector.</p>
    22. 

  22. <p>A Note on Row-Major and Column-Major Ordering:</p>
    23. 

  23. <p>The constructor and <a href="Matrix3.html#set">Matrix3#set</a> method take arguments in
    24. 

  24. <a href="https://en.wikipedia.org/wiki/Row-_and_column-major_order#Column-major_order" target="_blank" rel="noopener">row-major</a>
    25. 

  25. order, while internally they are stored in the <a href="Matrix3.html#elements">Matrix3#elements</a> array in column-major order.
    26. 

  26. This means that calling:</p>
    27. 

  27. <pre><code class="language-js">const m = new THREE.Matrix4();
    28. 

  28. m.set( 11, 12, 13, 14,
    29. 

  29.        21, 22, 23, 24,
    30. 

  30.        31, 32, 33, 34,
    31. 

  31.        41, 42, 43, 44 );
    32. 

  32. </code></pre>
    33. 

  33. <p>will result in the elements array containing:</p>
    34. 

  34. <pre><code class="language-js">m.elements = [ 11, 21, 31, 41,
    35. 

  35.                12, 22, 32, 42,
    36. 

  36.                13, 23, 33, 43,
    37. 

  37.                14, 24, 34, 44 ];
    38. 

  38. </code></pre>
    39. 

  39. <p>and internally all calculations are performed using column-major ordering.
    40. 

  40. However, as the actual ordering makes no difference mathematically and
    41. 

  41. most people are used to thinking about matrices in row-major order, the
    42. 

  42. three.js documentation shows matrices in row-major order. Just bear in
    43. 

  43. mind that if you are reading the source code, you'll have to take the
    44. 

  44. transpose of any matrices outlined here to make sense of the calculations.</p></div>
    45. 

  45. 			</header>
    46. 

  46. 			<article>
    47. 

  47. 				<div class="container-overview">
    48. 

  48. 					<h2>Constructor</h2>
    49. 

  49. 					<h3 class="name name-method" id="Matrix4" translate="no">new <a href="#Matrix4">Matrix4</a><span class="signature">( n11 : <span class="param-type">number</span>, n12 : <span class="param-type">number</span>, n13 : <span class="param-type">number</span>, n14 : <span class="param-type">number</span>, n21 : <span class="param-type">number</span>, n22 : <span class="param-type">number</span>, n23 : <span class="param-type">number</span>, n24 : <span class="param-type">number</span>, n31 : <span class="param-type">number</span>, n32 : <span class="param-type">number</span>, n33 : <span class="param-type">number</span>, n34 : <span class="param-type">number</span>, n41 : <span class="param-type">number</span>, n42 : <span class="param-type">number</span>, n43 : <span class="param-type">number</span>, n44 : <span class="param-type">number</span> )</span> </h3>
    50. 

  50. 					<div class="method">
    51. 

  51. 						<div class="description">
    52. 

  52. 							<p>Constructs a new 4x4 matrix. The arguments are supposed to be
    53. 

  53. in row-major order. If no arguments are provided, the constructor
    54. 

  54. initializes the matrix as an identity matrix.</p>
    55. 

  55. 						</div>
    56. 

  56. 						<table class="params">
    57. 

  57. 							<tbody>
    58. 

  58. 								<tr>
    59. 

  59. 									<td class="name">
    60. 

  60. 										<strong translate="no">n11</strong>
    61. 

  61. 									</td>
    62. 

  62. 									<td class="description last">
    63. 

  63. 										<p>1-1 matrix element.</p>
    64. 

  64. 									</td>
    65. 

  65. 								</tr>
    66. 

  66. 								<tr>
    67. 

  67. 									<td class="name">
    68. 

  68. 										<strong translate="no">n12</strong>
    69. 

  69. 									</td>
    70. 

  70. 									<td class="description last">
    71. 

  71. 										<p>1-2 matrix element.</p>
    72. 

  72. 									</td>
    73. 

  73. 								</tr>
    74. 

  74. 								<tr>
    75. 

  75. 									<td class="name">
    76. 

  76. 										<strong translate="no">n13</strong>
    77. 

  77. 									</td>
    78. 

  78. 									<td class="description last">
    79. 

  79. 										<p>1-3 matrix element.</p>
    80. 

  80. 									</td>
    81. 

  81. 								</tr>
    82. 

  82. 								<tr>
    83. 

  83. 									<td class="name">
    84. 

  84. 										<strong translate="no">n14</strong>
    85. 

  85. 									</td>
    86. 

  86. 									<td class="description last">
    87. 

  87. 										<p>1-4 matrix element.</p>
    88. 

  88. 									</td>
    89. 

  89. 								</tr>
    90. 

  90. 								<tr>
    91. 

  91. 									<td class="name">
    92. 

  92. 										<strong translate="no">n21</strong>
    93. 

  93. 									</td>
    94. 

  94. 									<td class="description last">
    95. 

  95. 										<p>2-1 matrix element.</p>
    96. 

  96. 									</td>
    97. 

  97. 								</tr>
    98. 

  98. 								<tr>
    99. 

  99. 									<td class="name">
    100. 

  100. 										<strong translate="no">n22</strong>
    101. 

  101. 									</td>
    102. 

  102. 									<td class="description last">
    103. 

  103. 										<p>2-2 matrix element.</p>
    104. 

  104. 									</td>
    105. 

  105. 								</tr>
    106. 

  106. 								<tr>
    107. 

  107. 									<td class="name">
    108. 

  108. 										<strong translate="no">n23</strong>
    109. 

  109. 									</td>
    110. 

  110. 									<td class="description last">
    111. 

  111. 										<p>2-3 matrix element.</p>
    112. 

  112. 									</td>
    113. 

  113. 								</tr>
    114. 

  114. 								<tr>
    115. 

  115. 									<td class="name">
    116. 

  116. 										<strong translate="no">n24</strong>
    117. 

  117. 									</td>
    118. 

  118. 									<td class="description last">
    119. 

  119. 										<p>2-4 matrix element.</p>
    120. 

  120. 									</td>
    121. 

  121. 								</tr>
    122. 

  122. 								<tr>
    123. 

  123. 									<td class="name">
    124. 

  124. 										<strong translate="no">n31</strong>
    125. 

  125. 									</td>
    126. 

  126. 									<td class="description last">
    127. 

  127. 										<p>3-1 matrix element.</p>
    128. 

  128. 									</td>
    129. 

  129. 								</tr>
    130. 

  130. 								<tr>
    131. 

  131. 									<td class="name">
    132. 

  132. 										<strong translate="no">n32</strong>
    133. 

  133. 									</td>
    134. 

  134. 									<td class="description last">
    135. 

  135. 										<p>3-2 matrix element.</p>
    136. 

  136. 									</td>
    137. 

  137. 								</tr>
    138. 

  138. 								<tr>
    139. 

  139. 									<td class="name">
    140. 

  140. 										<strong translate="no">n33</strong>
    141. 

  141. 									</td>
    142. 

  142. 									<td class="description last">
    143. 

  143. 										<p>3-3 matrix element.</p>
    144. 

  144. 									</td>
    145. 

  145. 								</tr>
    146. 

  146. 								<tr>
    147. 

  147. 									<td class="name">
    148. 

  148. 										<strong translate="no">n34</strong>
    149. 

  149. 									</td>
    150. 

  150. 									<td class="description last">
    151. 

  151. 										<p>3-4 matrix element.</p>
    152. 

  152. 									</td>
    153. 

  153. 								</tr>
    154. 

  154. 								<tr>
    155. 

  155. 									<td class="name">
    156. 

  156. 										<strong translate="no">n41</strong>
    157. 

  157. 									</td>
    158. 

  158. 									<td class="description last">
    159. 

  159. 										<p>4-1 matrix element.</p>
    160. 

  160. 									</td>
    161. 

  161. 								</tr>
    162. 

  162. 								<tr>
    163. 

  163. 									<td class="name">
    164. 

  164. 										<strong translate="no">n42</strong>
    165. 

  165. 									</td>
    166. 

  166. 									<td class="description last">
    167. 

  167. 										<p>4-2 matrix element.</p>
    168. 

  168. 									</td>
    169. 

  169. 								</tr>
    170. 

  170. 								<tr>
    171. 

  171. 									<td class="name">
    172. 

  172. 										<strong translate="no">n43</strong>
    173. 

  173. 									</td>
    174. 

  174. 									<td class="description last">
    175. 

  175. 										<p>4-3 matrix element.</p>
    176. 

  176. 									</td>
    177. 

  177. 								</tr>
    178. 

  178. 								<tr>
    179. 

  179. 									<td class="name">
    180. 

  180. 										<strong translate="no">n44</strong>
    181. 

  181. 									</td>
    182. 

  182. 									<td class="description last">
    183. 

  183. 										<p>4-4 matrix element.</p>
    184. 

  184. 									</td>
    185. 

  185. 								</tr>
    186. 

  186. 							</tbody>
    187. 

  187. 						</table>
    188. 

  188. 					</div>
    189. 

  189. 				</div>
    190. 

  190. 				<h2 class="subsection-title">Properties</h2>
    191. 

  191. 				<div class="member">
    192. 

  192. 					<h3 class="name" id="elements" translate="no">.<a href="#elements">elements</a><span class="type-signature"> : Array.&lt;number></span> </h3>
    193. 

  193. 					<div class="description">
    194. 

  194. 						<p>A column-major list of matrix values.</p>
    195. 

  195. 					</div>
    196. 

  196. 				</div>
    197. 

  197. 				<h2 class="subsection-title">Methods</h2>
    198. 

  198. 					<h3 class="name name-method" id="clone" translate="no">.<a href="#clone">clone</a><span class="signature">()</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    199. 

  199. 					<div class="method">
    200. 

  200. 						<div class="description">
    201. 

  201. 							<p>Returns a matrix with copied values from this instance.</p>
    202. 

  202. 						</div>
    203. 

  203. 						<dl class="details">
    204. 

  204. 							<dt class="tag-returns"><strong>Returns:</strong> A clone of this instance.</dt>
    205. 

  205. 						</dl>
    206. 

  206. 					</div>
    207. 

  207. 					<h3 class="name name-method" id="compose" translate="no">.<a href="#compose">compose</a><span class="signature">( position : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, quaternion : <span class="param-type"><a href="Quaternion.html">Quaternion</a></span>, scale : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    208. 

  208. 					<div class="method">
    209. 

  209. 						<div class="description">
    210. 

  210. 							<p>Sets this matrix to the transformation composed of the given position,
    211. 

  211. rotation (Quaternion) and scale.</p>
    212. 

  212. 						</div>
    213. 

  213. 						<table class="params">
    214. 

  214. 							<tbody>
    215. 

  215. 								<tr>
    216. 

  216. 									<td class="name">
    217. 

  217. 										<strong translate="no">position</strong>
    218. 

  218. 									</td>
    219. 

  219. 									<td class="description last">
    220. 

  220. 										<p>The position vector.</p>
    221. 

  221. 									</td>
    222. 

  222. 								</tr>
    223. 

  223. 								<tr>
    224. 

  224. 									<td class="name">
    225. 

  225. 										<strong translate="no">quaternion</strong>
    226. 

  226. 									</td>
    227. 

  227. 									<td class="description last">
    228. 

  228. 										<p>The rotation as a Quaternion.</p>
    229. 

  229. 									</td>
    230. 

  230. 								</tr>
    231. 

  231. 								<tr>
    232. 

  232. 									<td class="name">
    233. 

  233. 										<strong translate="no">scale</strong>
    234. 

  234. 									</td>
    235. 

  235. 									<td class="description last">
    236. 

  236. 										<p>The scale vector.</p>
    237. 

  237. 									</td>
    238. 

  238. 								</tr>
    239. 

  239. 							</tbody>
    240. 

  240. 						</table>
    241. 

  241. 						<dl class="details">
    242. 

  242. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    243. 

  243. 						</dl>
    244. 

  244. 					</div>
    245. 

  245. 					<h3 class="name name-method" id="copy" translate="no">.<a href="#copy">copy</a><span class="signature">( m : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    246. 

  246. 					<div class="method">
    247. 

  247. 						<div class="description">
    248. 

  248. 							<p>Copies the values of the given matrix to this instance.</p>
    249. 

  249. 						</div>
    250. 

  250. 						<table class="params">
    251. 

  251. 							<tbody>
    252. 

  252. 								<tr>
    253. 

  253. 									<td class="name">
    254. 

  254. 										<strong translate="no">m</strong>
    255. 

  255. 									</td>
    256. 

  256. 									<td class="description last">
    257. 

  257. 										<p>The matrix to copy.</p>
    258. 

  258. 									</td>
    259. 

  259. 								</tr>
    260. 

  260. 							</tbody>
    261. 

  261. 						</table>
    262. 

  262. 						<dl class="details">
    263. 

  263. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    264. 

  264. 						</dl>
    265. 

  265. 					</div>
    266. 

  266. 					<h3 class="name name-method" id="copyPosition" translate="no">.<a href="#copyPosition">copyPosition</a><span class="signature">( m : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    267. 

  267. 					<div class="method">
    268. 

  268. 						<div class="description">
    269. 

  269. 							<p>Copies the translation component of the given matrix
    270. 

  270. into this matrix's translation component.</p>
    271. 

  271. 						</div>
    272. 

  272. 						<table class="params">
    273. 

  273. 							<tbody>
    274. 

  274. 								<tr>
    275. 

  275. 									<td class="name">
    276. 

  276. 										<strong translate="no">m</strong>
    277. 

  277. 									</td>
    278. 

  278. 									<td class="description last">
    279. 

  279. 										<p>The matrix to copy the translation component.</p>
    280. 

  280. 									</td>
    281. 

  281. 								</tr>
    282. 

  282. 							</tbody>
    283. 

  283. 						</table>
    284. 

  284. 						<dl class="details">
    285. 

  285. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    286. 

  286. 						</dl>
    287. 

  287. 					</div>
    288. 

  288. 					<h3 class="name name-method" id="decompose" translate="no">.<a href="#decompose">decompose</a><span class="signature">( position : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, quaternion : <span class="param-type"><a href="Quaternion.html">Quaternion</a></span>, scale : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    289. 

  289. 					<div class="method">
    290. 

  290. 						<div class="description">
    291. 

  291. 							<p>Decomposes this matrix into its position, rotation and scale components
    292. 

  292. and provides the result in the given objects.</p>
    293. 

  293. <p>Note: Not all matrices are decomposable in this way. For example, if an
    294. 

  294. object has a non-uniformly scaled parent, then the object's world matrix
    295. 

  295. may not be decomposable, and this method may not be appropriate.</p>
    296. 

  296. 						</div>
    297. 

  297. 						<table class="params">
    298. 

  298. 							<tbody>
    299. 

  299. 								<tr>
    300. 

  300. 									<td class="name">
    301. 

  301. 										<strong translate="no">position</strong>
    302. 

  302. 									</td>
    303. 

  303. 									<td class="description last">
    304. 

  304. 										<p>The position vector.</p>
    305. 

  305. 									</td>
    306. 

  306. 								</tr>
    307. 

  307. 								<tr>
    308. 

  308. 									<td class="name">
    309. 

  309. 										<strong translate="no">quaternion</strong>
    310. 

  310. 									</td>
    311. 

  311. 									<td class="description last">
    312. 

  312. 										<p>The rotation as a Quaternion.</p>
    313. 

  313. 									</td>
    314. 

  314. 								</tr>
    315. 

  315. 								<tr>
    316. 

  316. 									<td class="name">
    317. 

  317. 										<strong translate="no">scale</strong>
    318. 

  318. 									</td>
    319. 

  319. 									<td class="description last">
    320. 

  320. 										<p>The scale vector.</p>
    321. 

  321. 									</td>
    322. 

  322. 								</tr>
    323. 

  323. 							</tbody>
    324. 

  324. 						</table>
    325. 

  325. 						<dl class="details">
    326. 

  326. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    327. 

  327. 						</dl>
    328. 

  328. 					</div>
    329. 

  329. 					<h3 class="name name-method" id="determinant" translate="no">.<a href="#determinant">determinant</a><span class="signature">()</span><span class="type-signature"> : number</span> </h3>
    330. 

  330. 					<div class="method">
    331. 

  331. 						<div class="description">
    332. 

  332. 							<p>Computes and returns the determinant of this matrix.</p>
    333. 

  333. <p>Based on the method outlined <a href="http://www.euclideanspace.com/maths/algebra/matrix/functions/inverse/fourD/index.html" target="_blank" rel="noopener">here</a>.</p>
    334. 

  334. 						</div>
    335. 

  335. 						<dl class="details">
    336. 

  336. 							<dt class="tag-returns"><strong>Returns:</strong> The determinant.</dt>
    337. 

  337. 						</dl>
    338. 

  338. 					</div>
    339. 

  339. 					<h3 class="name name-method" id="equals" translate="no">.<a href="#equals">equals</a><span class="signature">( matrix : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : boolean</span> </h3>
    340. 

  340. 					<div class="method">
    341. 

  341. 						<div class="description">
    342. 

  342. 							<p>Returns <code>true</code> if this matrix is equal with the given one.</p>
    343. 

  343. 						</div>
    344. 

  344. 						<table class="params">
    345. 

  345. 							<tbody>
    346. 

  346. 								<tr>
    347. 

  347. 									<td class="name">
    348. 

  348. 										<strong translate="no">matrix</strong>
    349. 

  349. 									</td>
    350. 

  350. 									<td class="description last">
    351. 

  351. 										<p>The matrix to test for equality.</p>
    352. 

  352. 									</td>
    353. 

  353. 								</tr>
    354. 

  354. 							</tbody>
    355. 

  355. 						</table>
    356. 

  356. 						<dl class="details">
    357. 

  357. 							<dt class="tag-returns"><strong>Returns:</strong> Whether this matrix is equal with the given one.</dt>
    358. 

  358. 						</dl>
    359. 

  359. 					</div>
    360. 

  360. 					<h3 class="name name-method" id="extractBasis" translate="no">.<a href="#extractBasis">extractBasis</a><span class="signature">( xAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, yAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, zAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    361. 

  361. 					<div class="method">
    362. 

  362. 						<div class="description">
    363. 

  363. 							<p>Extracts the basis of this matrix into the three axis vectors provided.</p>
    364. 

  364. 						</div>
    365. 

  365. 						<table class="params">
    366. 

  366. 							<tbody>
    367. 

  367. 								<tr>
    368. 

  368. 									<td class="name">
    369. 

  369. 										<strong translate="no">xAxis</strong>
    370. 

  370. 									</td>
    371. 

  371. 									<td class="description last">
    372. 

  372. 										<p>The basis's x axis.</p>
    373. 

  373. 									</td>
    374. 

  374. 								</tr>
    375. 

  375. 								<tr>
    376. 

  376. 									<td class="name">
    377. 

  377. 										<strong translate="no">yAxis</strong>
    378. 

  378. 									</td>
    379. 

  379. 									<td class="description last">
    380. 

  380. 										<p>The basis's y axis.</p>
    381. 

  381. 									</td>
    382. 

  382. 								</tr>
    383. 

  383. 								<tr>
    384. 

  384. 									<td class="name">
    385. 

  385. 										<strong translate="no">zAxis</strong>
    386. 

  386. 									</td>
    387. 

  387. 									<td class="description last">
    388. 

  388. 										<p>The basis's z axis.</p>
    389. 

  389. 									</td>
    390. 

  390. 								</tr>
    391. 

  391. 							</tbody>
    392. 

  392. 						</table>
    393. 

  393. 						<dl class="details">
    394. 

  394. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    395. 

  395. 						</dl>
    396. 

  396. 					</div>
    397. 

  397. 					<h3 class="name name-method" id="extractRotation" translate="no">.<a href="#extractRotation">extractRotation</a><span class="signature">( m : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    398. 

  398. 					<div class="method">
    399. 

  399. 						<div class="description">
    400. 

  400. 							<p>Extracts the rotation component of the given matrix
    401. 

  401. into this matrix's rotation component.</p>
    402. 

  402. <p>Note: This method does not support reflection matrices.</p>
    403. 

  403. 						</div>
    404. 

  404. 						<table class="params">
    405. 

  405. 							<tbody>
    406. 

  406. 								<tr>
    407. 

  407. 									<td class="name">
    408. 

  408. 										<strong translate="no">m</strong>
    409. 

  409. 									</td>
    410. 

  410. 									<td class="description last">
    411. 

  411. 										<p>The matrix.</p>
    412. 

  412. 									</td>
    413. 

  413. 								</tr>
    414. 

  414. 							</tbody>
    415. 

  415. 						</table>
    416. 

  416. 						<dl class="details">
    417. 

  417. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    418. 

  418. 						</dl>
    419. 

  419. 					</div>
    420. 

  420. 					<h3 class="name name-method" id="fromArray" translate="no">.<a href="#fromArray">fromArray</a><span class="signature">( array : <span class="param-type">Array.&lt;number></span>, offset : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    421. 

  421. 					<div class="method">
    422. 

  422. 						<div class="description">
    423. 

  423. 							<p>Sets the elements of the matrix from the given array.</p>
    424. 

  424. 						</div>
    425. 

  425. 						<table class="params">
    426. 

  426. 							<tbody>
    427. 

  427. 								<tr>
    428. 

  428. 									<td class="name">
    429. 

  429. 										<strong translate="no">array</strong>
    430. 

  430. 									</td>
    431. 

  431. 									<td class="description last">
    432. 

  432. 										<p>The matrix elements in column-major order.</p>
    433. 

  433. 									</td>
    434. 

  434. 								</tr>
    435. 

  435. 								<tr>
    436. 

  436. 									<td class="name">
    437. 

  437. 										<strong translate="no">offset</strong>
    438. 

  438. 									</td>
    439. 

  439. 									<td class="description last">
    440. 

  440. 										<p>Index of the first element in the array.</p>
    441. 

  441. 										<p>Default is <code>0</code>.</p>
    442. 

  442. 									</td>
    443. 

  443. 								</tr>
    444. 

  444. 							</tbody>
    445. 

  445. 						</table>
    446. 

  446. 						<dl class="details">
    447. 

  447. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    448. 

  448. 						</dl>
    449. 

  449. 					</div>
    450. 

  450. 					<h3 class="name name-method" id="getMaxScaleOnAxis" translate="no">.<a href="#getMaxScaleOnAxis">getMaxScaleOnAxis</a><span class="signature">()</span><span class="type-signature"> : number</span> </h3>
    451. 

  451. 					<div class="method">
    452. 

  452. 						<div class="description">
    453. 

  453. 							<p>Gets the maximum scale value of the three axes.</p>
    454. 

  454. 						</div>
    455. 

  455. 						<dl class="details">
    456. 

  456. 							<dt class="tag-returns"><strong>Returns:</strong> The maximum scale.</dt>
    457. 

  457. 						</dl>
    458. 

  458. 					</div>
    459. 

  459. 					<h3 class="name name-method" id="identity" translate="no">.<a href="#identity">identity</a><span class="signature">()</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    460. 

  460. 					<div class="method">
    461. 

  461. 						<div class="description">
    462. 

  462. 							<p>Sets this matrix to the 4x4 identity matrix.</p>
    463. 

  463. 						</div>
    464. 

  464. 						<dl class="details">
    465. 

  465. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    466. 

  466. 						</dl>
    467. 

  467. 					</div>
    468. 

  468. 					<h3 class="name name-method" id="invert" translate="no">.<a href="#invert">invert</a><span class="signature">()</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    469. 

  469. 					<div class="method">
    470. 

  470. 						<div class="description">
    471. 

  471. 							<p>Inverts this matrix, using the <a href="https://en.wikipedia.org/wiki/Invertible_matrix#Analytic_solution" target="_blank" rel="noopener">analytic method</a>.
    472. 

  472. You can not invert with a determinant of zero. If you attempt this, the method produces
    473. 

  473. a zero matrix instead.</p>
    474. 

  474. 						</div>
    475. 

  475. 						<dl class="details">
    476. 

  476. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    477. 

  477. 						</dl>
    478. 

  478. 					</div>
    479. 

  479. 					<h3 class="name name-method" id="lookAt" translate="no">.<a href="#lookAt">lookAt</a><span class="signature">( eye : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, target : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, up : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    480. 

  480. 					<div class="method">
    481. 

  481. 						<div class="description">
    482. 

  482. 							<p>Sets the rotation component of the transformation matrix, looking from <code>eye</code> towards
    483. 

  483. <code>target</code>, and oriented by the up-direction.</p>
    484. 

  484. 						</div>
    485. 

  485. 						<table class="params">
    486. 

  486. 							<tbody>
    487. 

  487. 								<tr>
    488. 

  488. 									<td class="name">
    489. 

  489. 										<strong translate="no">eye</strong>
    490. 

  490. 									</td>
    491. 

  491. 									<td class="description last">
    492. 

  492. 										<p>The eye vector.</p>
    493. 

  493. 									</td>
    494. 

  494. 								</tr>
    495. 

  495. 								<tr>
    496. 

  496. 									<td class="name">
    497. 

  497. 										<strong translate="no">target</strong>
    498. 

  498. 									</td>
    499. 

  499. 									<td class="description last">
    500. 

  500. 										<p>The target vector.</p>
    501. 

  501. 									</td>
    502. 

  502. 								</tr>
    503. 

  503. 								<tr>
    504. 

  504. 									<td class="name">
    505. 

  505. 										<strong translate="no">up</strong>
    506. 

  506. 									</td>
    507. 

  507. 									<td class="description last">
    508. 

  508. 										<p>The up vector.</p>
    509. 

  509. 									</td>
    510. 

  510. 								</tr>
    511. 

  511. 							</tbody>
    512. 

  512. 						</table>
    513. 

  513. 						<dl class="details">
    514. 

  514. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    515. 

  515. 						</dl>
    516. 

  516. 					</div>
    517. 

  517. 					<h3 class="name name-method" id="makeBasis" translate="no">.<a href="#makeBasis">makeBasis</a><span class="signature">( xAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, yAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, zAxis : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    518. 

  518. 					<div class="method">
    519. 

  519. 						<div class="description">
    520. 

  520. 							<p>Sets the given basis vectors to this matrix.</p>
    521. 

  521. 						</div>
    522. 

  522. 						<table class="params">
    523. 

  523. 							<tbody>
    524. 

  524. 								<tr>
    525. 

  525. 									<td class="name">
    526. 

  526. 										<strong translate="no">xAxis</strong>
    527. 

  527. 									</td>
    528. 

  528. 									<td class="description last">
    529. 

  529. 										<p>The basis's x axis.</p>
    530. 

  530. 									</td>
    531. 

  531. 								</tr>
    532. 

  532. 								<tr>
    533. 

  533. 									<td class="name">
    534. 

  534. 										<strong translate="no">yAxis</strong>
    535. 

  535. 									</td>
    536. 

  536. 									<td class="description last">
    537. 

  537. 										<p>The basis's y axis.</p>
    538. 

  538. 									</td>
    539. 

  539. 								</tr>
    540. 

  540. 								<tr>
    541. 

  541. 									<td class="name">
    542. 

  542. 										<strong translate="no">zAxis</strong>
    543. 

  543. 									</td>
    544. 

  544. 									<td class="description last">
    545. 

  545. 										<p>The basis's z axis.</p>
    546. 

  546. 									</td>
    547. 

  547. 								</tr>
    548. 

  548. 							</tbody>
    549. 

  549. 						</table>
    550. 

  550. 						<dl class="details">
    551. 

  551. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    552. 

  552. 						</dl>
    553. 

  553. 					</div>
    554. 

  554. 					<h3 class="name name-method" id="makeOrthographic" translate="no">.<a href="#makeOrthographic">makeOrthographic</a><span class="signature">( left : <span class="param-type">number</span>, right : <span class="param-type">number</span>, top : <span class="param-type">number</span>, bottom : <span class="param-type">number</span>, near : <span class="param-type">number</span>, far : <span class="param-type">number</span>, coordinateSystem : <span class="param-type"><a href="global.html#WebGLCoordinateSystem">WebGLCoordinateSystem</a> | <a href="global.html#WebGPUCoordinateSystem">WebGPUCoordinateSystem</a></span>, reversedDepth : <span class="param-type">boolean</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    555. 

  555. 					<div class="method">
    556. 

  556. 						<div class="description">
    557. 

  557. 							<p>Creates a orthographic projection matrix. This is used internally by
    558. 

  558. <a href="OrthographicCamera.html#updateProjectionMatrix">OrthographicCamera#updateProjectionMatrix</a>.</p>
    559. 

  559. 						</div>
    560. 

  560. 						<table class="params">
    561. 

  561. 							<tbody>
    562. 

  562. 								<tr>
    563. 

  563. 									<td class="name">
    564. 

  564. 										<strong translate="no">left</strong>
    565. 

  565. 									</td>
    566. 

  566. 									<td class="description last">
    567. 

  567. 										<p>Left boundary of the viewing frustum at the near plane.</p>
    568. 

  568. 									</td>
    569. 

  569. 								</tr>
    570. 

  570. 								<tr>
    571. 

  571. 									<td class="name">
    572. 

  572. 										<strong translate="no">right</strong>
    573. 

  573. 									</td>
    574. 

  574. 									<td class="description last">
    575. 

  575. 										<p>Right boundary of the viewing frustum at the near plane.</p>
    576. 

  576. 									</td>
    577. 

  577. 								</tr>
    578. 

  578. 								<tr>
    579. 

  579. 									<td class="name">
    580. 

  580. 										<strong translate="no">top</strong>
    581. 

  581. 									</td>
    582. 

  582. 									<td class="description last">
    583. 

  583. 										<p>Top boundary of the viewing frustum at the near plane.</p>
    584. 

  584. 									</td>
    585. 

  585. 								</tr>
    586. 

  586. 								<tr>
    587. 

  587. 									<td class="name">
    588. 

  588. 										<strong translate="no">bottom</strong>
    589. 

  589. 									</td>
    590. 

  590. 									<td class="description last">
    591. 

  591. 										<p>Bottom boundary of the viewing frustum at the near plane.</p>
    592. 

  592. 									</td>
    593. 

  593. 								</tr>
    594. 

  594. 								<tr>
    595. 

  595. 									<td class="name">
    596. 

  596. 										<strong translate="no">near</strong>
    597. 

  597. 									</td>
    598. 

  598. 									<td class="description last">
    599. 

  599. 										<p>The distance from the camera to the near plane.</p>
    600. 

  600. 									</td>
    601. 

  601. 								</tr>
    602. 

  602. 								<tr>
    603. 

  603. 									<td class="name">
    604. 

  604. 										<strong translate="no">far</strong>
    605. 

  605. 									</td>
    606. 

  606. 									<td class="description last">
    607. 

  607. 										<p>The distance from the camera to the far plane.</p>
    608. 

  608. 									</td>
    609. 

  609. 								</tr>
    610. 

  610. 								<tr>
    611. 

  611. 									<td class="name">
    612. 

  612. 										<strong translate="no">coordinateSystem</strong>
    613. 

  613. 									</td>
    614. 

  614. 									<td class="description last">
    615. 

  615. 										<p>The coordinate system.</p>
    616. 

  616. 										<p>Default is <code>WebGLCoordinateSystem</code>.</p>
    617. 

  617. 									</td>
    618. 

  618. 								</tr>
    619. 

  619. 								<tr>
    620. 

  620. 									<td class="name">
    621. 

  621. 										<strong translate="no">reversedDepth</strong>
    622. 

  622. 									</td>
    623. 

  623. 									<td class="description last">
    624. 

  624. 										<p>Whether to use a reversed depth.</p>
    625. 

  625. 										<p>Default is <code>false</code>.</p>
    626. 

  626. 									</td>
    627. 

  627. 								</tr>
    628. 

  628. 							</tbody>
    629. 

  629. 						</table>
    630. 

  630. 						<dl class="details">
    631. 

  631. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    632. 

  632. 						</dl>
    633. 

  633. 					</div>
    634. 

  634. 					<h3 class="name name-method" id="makePerspective" translate="no">.<a href="#makePerspective">makePerspective</a><span class="signature">( left : <span class="param-type">number</span>, right : <span class="param-type">number</span>, top : <span class="param-type">number</span>, bottom : <span class="param-type">number</span>, near : <span class="param-type">number</span>, far : <span class="param-type">number</span>, coordinateSystem : <span class="param-type"><a href="global.html#WebGLCoordinateSystem">WebGLCoordinateSystem</a> | <a href="global.html#WebGPUCoordinateSystem">WebGPUCoordinateSystem</a></span>, reversedDepth : <span class="param-type">boolean</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    635. 

  635. 					<div class="method">
    636. 

  636. 						<div class="description">
    637. 

  637. 							<p>Creates a perspective projection matrix. This is used internally by
    638. 

  638. <a href="PerspectiveCamera.html#updateProjectionMatrix">PerspectiveCamera#updateProjectionMatrix</a>.</p>
    639. 

  639. 						</div>
    640. 

  640. 						<table class="params">
    641. 

  641. 							<tbody>
    642. 

  642. 								<tr>
    643. 

  643. 									<td class="name">
    644. 

  644. 										<strong translate="no">left</strong>
    645. 

  645. 									</td>
    646. 

  646. 									<td class="description last">
    647. 

  647. 										<p>Left boundary of the viewing frustum at the near plane.</p>
    648. 

  648. 									</td>
    649. 

  649. 								</tr>
    650. 

  650. 								<tr>
    651. 

  651. 									<td class="name">
    652. 

  652. 										<strong translate="no">right</strong>
    653. 

  653. 									</td>
    654. 

  654. 									<td class="description last">
    655. 

  655. 										<p>Right boundary of the viewing frustum at the near plane.</p>
    656. 

  656. 									</td>
    657. 

  657. 								</tr>
    658. 

  658. 								<tr>
    659. 

  659. 									<td class="name">
    660. 

  660. 										<strong translate="no">top</strong>
    661. 

  661. 									</td>
    662. 

  662. 									<td class="description last">
    663. 

  663. 										<p>Top boundary of the viewing frustum at the near plane.</p>
    664. 

  664. 									</td>
    665. 

  665. 								</tr>
    666. 

  666. 								<tr>
    667. 

  667. 									<td class="name">
    668. 

  668. 										<strong translate="no">bottom</strong>
    669. 

  669. 									</td>
    670. 

  670. 									<td class="description last">
    671. 

  671. 										<p>Bottom boundary of the viewing frustum at the near plane.</p>
    672. 

  672. 									</td>
    673. 

  673. 								</tr>
    674. 

  674. 								<tr>
    675. 

  675. 									<td class="name">
    676. 

  676. 										<strong translate="no">near</strong>
    677. 

  677. 									</td>
    678. 

  678. 									<td class="description last">
    679. 

  679. 										<p>The distance from the camera to the near plane.</p>
    680. 

  680. 									</td>
    681. 

  681. 								</tr>
    682. 

  682. 								<tr>
    683. 

  683. 									<td class="name">
    684. 

  684. 										<strong translate="no">far</strong>
    685. 

  685. 									</td>
    686. 

  686. 									<td class="description last">
    687. 

  687. 										<p>The distance from the camera to the far plane.</p>
    688. 

  688. 									</td>
    689. 

  689. 								</tr>
    690. 

  690. 								<tr>
    691. 

  691. 									<td class="name">
    692. 

  692. 										<strong translate="no">coordinateSystem</strong>
    693. 

  693. 									</td>
    694. 

  694. 									<td class="description last">
    695. 

  695. 										<p>The coordinate system.</p>
    696. 

  696. 										<p>Default is <code>WebGLCoordinateSystem</code>.</p>
    697. 

  697. 									</td>
    698. 

  698. 								</tr>
    699. 

  699. 								<tr>
    700. 

  700. 									<td class="name">
    701. 

  701. 										<strong translate="no">reversedDepth</strong>
    702. 

  702. 									</td>
    703. 

  703. 									<td class="description last">
    704. 

  704. 										<p>Whether to use a reversed depth.</p>
    705. 

  705. 										<p>Default is <code>false</code>.</p>
    706. 

  706. 									</td>
    707. 

  707. 								</tr>
    708. 

  708. 							</tbody>
    709. 

  709. 						</table>
    710. 

  710. 						<dl class="details">
    711. 

  711. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    712. 

  712. 						</dl>
    713. 

  713. 					</div>
    714. 

  714. 					<h3 class="name name-method" id="makeRotationAxis" translate="no">.<a href="#makeRotationAxis">makeRotationAxis</a><span class="signature">( axis : <span class="param-type"><a href="Vector3.html">Vector3</a></span>, angle : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    715. 

  715. 					<div class="method">
    716. 

  716. 						<div class="description">
    717. 

  717. 							<p>Sets this matrix as a rotational transformation around the given axis by
    718. 

  718. the given angle.</p>
    719. 

  719. <p>This is a somewhat controversial but mathematically sound alternative to
    720. 

  720. rotating via Quaternions. See the discussion <a href="https://www.gamedev.net/articles/programming/math-and-physics/do-we-really-need-quaternions-r1199" target="_blank" rel="noopener">here</a>.</p>
    721. 

  721. 						</div>
    722. 

  722. 						<table class="params">
    723. 

  723. 							<tbody>
    724. 

  724. 								<tr>
    725. 

  725. 									<td class="name">
    726. 

  726. 										<strong translate="no">axis</strong>
    727. 

  727. 									</td>
    728. 

  728. 									<td class="description last">
    729. 

  729. 										<p>The normalized rotation axis.</p>
    730. 

  730. 									</td>
    731. 

  731. 								</tr>
    732. 

  732. 								<tr>
    733. 

  733. 									<td class="name">
    734. 

  734. 										<strong translate="no">angle</strong>
    735. 

  735. 									</td>
    736. 

  736. 									<td class="description last">
    737. 

  737. 										<p>The rotation in radians.</p>
    738. 

  738. 									</td>
    739. 

  739. 								</tr>
    740. 

  740. 							</tbody>
    741. 

  741. 						</table>
    742. 

  742. 						<dl class="details">
    743. 

  743. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    744. 

  744. 						</dl>
    745. 

  745. 					</div>
    746. 

  746. 					<h3 class="name name-method" id="makeRotationFromEuler" translate="no">.<a href="#makeRotationFromEuler">makeRotationFromEuler</a><span class="signature">( euler : <span class="param-type"><a href="Euler.html">Euler</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    747. 

  747. 					<div class="method">
    748. 

  748. 						<div class="description">
    749. 

  749. 							<p>Sets the rotation component (the upper left 3x3 matrix) of this matrix to
    750. 

  750. the rotation specified by the given Euler angles. The rest of
    751. 

  751. the matrix is set to the identity. Depending on the <a href="Euler.html#order">Euler#order</a>,
    752. 

  752. there are six possible outcomes. See <a href="https://en.wikipedia.org/wiki/Euler_angles#Rotation_matrix" target="_blank" rel="noopener">this page</a>
    753. 

  753. for a complete list.</p>
    754. 

  754. 						</div>
    755. 

  755. 						<table class="params">
    756. 

  756. 							<tbody>
    757. 

  757. 								<tr>
    758. 

  758. 									<td class="name">
    759. 

  759. 										<strong translate="no">euler</strong>
    760. 

  760. 									</td>
    761. 

  761. 									<td class="description last">
    762. 

  762. 										<p>The Euler angles.</p>
    763. 

  763. 									</td>
    764. 

  764. 								</tr>
    765. 

  765. 							</tbody>
    766. 

  766. 						</table>
    767. 

  767. 						<dl class="details">
    768. 

  768. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    769. 

  769. 						</dl>
    770. 

  770. 					</div>
    771. 

  771. 					<h3 class="name name-method" id="makeRotationFromQuaternion" translate="no">.<a href="#makeRotationFromQuaternion">makeRotationFromQuaternion</a><span class="signature">( q : <span class="param-type"><a href="Quaternion.html">Quaternion</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    772. 

  772. 					<div class="method">
    773. 

  773. 						<div class="description">
    774. 

  774. 							<p>Sets the rotation component of this matrix to the rotation specified by
    775. 

  775. the given Quaternion as outlined <a href="https://en.wikipedia.org/wiki/Rotation_matrix#Quaternion" target="_blank" rel="noopener">here</a>
    776. 

  776. The rest of the matrix is set to the identity.</p>
    777. 

  777. 						</div>
    778. 

  778. 						<table class="params">
    779. 

  779. 							<tbody>
    780. 

  780. 								<tr>
    781. 

  781. 									<td class="name">
    782. 

  782. 										<strong translate="no">q</strong>
    783. 

  783. 									</td>
    784. 

  784. 									<td class="description last">
    785. 

  785. 										<p>The Quaternion.</p>
    786. 

  786. 									</td>
    787. 

  787. 								</tr>
    788. 

  788. 							</tbody>
    789. 

  789. 						</table>
    790. 

  790. 						<dl class="details">
    791. 

  791. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    792. 

  792. 						</dl>
    793. 

  793. 					</div>
    794. 

  794. 					<h3 class="name name-method" id="makeRotationX" translate="no">.<a href="#makeRotationX">makeRotationX</a><span class="signature">( theta : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    795. 

  795. 					<div class="method">
    796. 

  796. 						<div class="description">
    797. 

  797. 							<p>Sets this matrix as a rotational transformation around the X axis by
    798. 

  798. the given angle.</p>
    799. 

  799. 						</div>
    800. 

  800. 						<table class="params">
    801. 

  801. 							<tbody>
    802. 

  802. 								<tr>
    803. 

  803. 									<td class="name">
    804. 

  804. 										<strong translate="no">theta</strong>
    805. 

  805. 									</td>
    806. 

  806. 									<td class="description last">
    807. 

  807. 										<p>The rotation in radians.</p>
    808. 

  808. 									</td>
    809. 

  809. 								</tr>
    810. 

  810. 							</tbody>
    811. 

  811. 						</table>
    812. 

  812. 						<dl class="details">
    813. 

  813. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    814. 

  814. 						</dl>
    815. 

  815. 					</div>
    816. 

  816. 					<h3 class="name name-method" id="makeRotationY" translate="no">.<a href="#makeRotationY">makeRotationY</a><span class="signature">( theta : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    817. 

  817. 					<div class="method">
    818. 

  818. 						<div class="description">
    819. 

  819. 							<p>Sets this matrix as a rotational transformation around the Y axis by
    820. 

  820. the given angle.</p>
    821. 

  821. 						</div>
    822. 

  822. 						<table class="params">
    823. 

  823. 							<tbody>
    824. 

  824. 								<tr>
    825. 

  825. 									<td class="name">
    826. 

  826. 										<strong translate="no">theta</strong>
    827. 

  827. 									</td>
    828. 

  828. 									<td class="description last">
    829. 

  829. 										<p>The rotation in radians.</p>
    830. 

  830. 									</td>
    831. 

  831. 								</tr>
    832. 

  832. 							</tbody>
    833. 

  833. 						</table>
    834. 

  834. 						<dl class="details">
    835. 

  835. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    836. 

  836. 						</dl>
    837. 

  837. 					</div>
    838. 

  838. 					<h3 class="name name-method" id="makeRotationZ" translate="no">.<a href="#makeRotationZ">makeRotationZ</a><span class="signature">( theta : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    839. 

  839. 					<div class="method">
    840. 

  840. 						<div class="description">
    841. 

  841. 							<p>Sets this matrix as a rotational transformation around the Z axis by
    842. 

  842. the given angle.</p>
    843. 

  843. 						</div>
    844. 

  844. 						<table class="params">
    845. 

  845. 							<tbody>
    846. 

  846. 								<tr>
    847. 

  847. 									<td class="name">
    848. 

  848. 										<strong translate="no">theta</strong>
    849. 

  849. 									</td>
    850. 

  850. 									<td class="description last">
    851. 

  851. 										<p>The rotation in radians.</p>
    852. 

  852. 									</td>
    853. 

  853. 								</tr>
    854. 

  854. 							</tbody>
    855. 

  855. 						</table>
    856. 

  856. 						<dl class="details">
    857. 

  857. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    858. 

  858. 						</dl>
    859. 

  859. 					</div>
    860. 

  860. 					<h3 class="name name-method" id="makeScale" translate="no">.<a href="#makeScale">makeScale</a><span class="signature">( x : <span class="param-type">number</span>, y : <span class="param-type">number</span>, z : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    861. 

  861. 					<div class="method">
    862. 

  862. 						<div class="description">
    863. 

  863. 							<p>Sets this matrix as a scale transformation.</p>
    864. 

  864. 						</div>
    865. 

  865. 						<table class="params">
    866. 

  866. 							<tbody>
    867. 

  867. 								<tr>
    868. 

  868. 									<td class="name">
    869. 

  869. 										<strong translate="no">x</strong>
    870. 

  870. 									</td>
    871. 

  871. 									<td class="description last">
    872. 

  872. 										<p>The amount to scale in the X axis.</p>
    873. 

  873. 									</td>
    874. 

  874. 								</tr>
    875. 

  875. 								<tr>
    876. 

  876. 									<td class="name">
    877. 

  877. 										<strong translate="no">y</strong>
    878. 

  878. 									</td>
    879. 

  879. 									<td class="description last">
    880. 

  880. 										<p>The amount to scale in the Y axis.</p>
    881. 

  881. 									</td>
    882. 

  882. 								</tr>
    883. 

  883. 								<tr>
    884. 

  884. 									<td class="name">
    885. 

  885. 										<strong translate="no">z</strong>
    886. 

  886. 									</td>
    887. 

  887. 									<td class="description last">
    888. 

  888. 										<p>The amount to scale in the Z axis.</p>
    889. 

  889. 									</td>
    890. 

  890. 								</tr>
    891. 

  891. 							</tbody>
    892. 

  892. 						</table>
    893. 

  893. 						<dl class="details">
    894. 

  894. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    895. 

  895. 						</dl>
    896. 

  896. 					</div>
    897. 

  897. 					<h3 class="name name-method" id="makeShear" translate="no">.<a href="#makeShear">makeShear</a><span class="signature">( xy : <span class="param-type">number</span>, xz : <span class="param-type">number</span>, yx : <span class="param-type">number</span>, yz : <span class="param-type">number</span>, zx : <span class="param-type">number</span>, zy : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    898. 

  898. 					<div class="method">
    899. 

  899. 						<div class="description">
    900. 

  900. 							<p>Sets this matrix as a shear transformation.</p>
    901. 

  901. 						</div>
    902. 

  902. 						<table class="params">
    903. 

  903. 							<tbody>
    904. 

  904. 								<tr>
    905. 

  905. 									<td class="name">
    906. 

  906. 										<strong translate="no">xy</strong>
    907. 

  907. 									</td>
    908. 

  908. 									<td class="description last">
    909. 

  909. 										<p>The amount to shear X by Y.</p>
    910. 

  910. 									</td>
    911. 

  911. 								</tr>
    912. 

  912. 								<tr>
    913. 

  913. 									<td class="name">
    914. 

  914. 										<strong translate="no">xz</strong>
    915. 

  915. 									</td>
    916. 

  916. 									<td class="description last">
    917. 

  917. 										<p>The amount to shear X by Z.</p>
    918. 

  918. 									</td>
    919. 

  919. 								</tr>
    920. 

  920. 								<tr>
    921. 

  921. 									<td class="name">
    922. 

  922. 										<strong translate="no">yx</strong>
    923. 

  923. 									</td>
    924. 

  924. 									<td class="description last">
    925. 

  925. 										<p>The amount to shear Y by X.</p>
    926. 

  926. 									</td>
    927. 

  927. 								</tr>
    928. 

  928. 								<tr>
    929. 

  929. 									<td class="name">
    930. 

  930. 										<strong translate="no">yz</strong>
    931. 

  931. 									</td>
    932. 

  932. 									<td class="description last">
    933. 

  933. 										<p>The amount to shear Y by Z.</p>
    934. 

  934. 									</td>
    935. 

  935. 								</tr>
    936. 

  936. 								<tr>
    937. 

  937. 									<td class="name">
    938. 

  938. 										<strong translate="no">zx</strong>
    939. 

  939. 									</td>
    940. 

  940. 									<td class="description last">
    941. 

  941. 										<p>The amount to shear Z by X.</p>
    942. 

  942. 									</td>
    943. 

  943. 								</tr>
    944. 

  944. 								<tr>
    945. 

  945. 									<td class="name">
    946. 

  946. 										<strong translate="no">zy</strong>
    947. 

  947. 									</td>
    948. 

  948. 									<td class="description last">
    949. 

  949. 										<p>The amount to shear Z by Y.</p>
    950. 

  950. 									</td>
    951. 

  951. 								</tr>
    952. 

  952. 							</tbody>
    953. 

  953. 						</table>
    954. 

  954. 						<dl class="details">
    955. 

  955. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    956. 

  956. 						</dl>
    957. 

  957. 					</div>
    958. 

  958. 					<h3 class="name name-method" id="makeTranslation" translate="no">.<a href="#makeTranslation">makeTranslation</a><span class="signature">( x : <span class="param-type">number | <a href="Vector3.html">Vector3</a></span>, y : <span class="param-type">number</span>, z : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    959. 

  959. 					<div class="method">
    960. 

  960. 						<div class="description">
    961. 

  961. 							<p>Sets this matrix as a translation transform from the given vector.</p>
    962. 

  962. 						</div>
    963. 

  963. 						<table class="params">
    964. 

  964. 							<tbody>
    965. 

  965. 								<tr>
    966. 

  966. 									<td class="name">
    967. 

  967. 										<strong translate="no">x</strong>
    968. 

  968. 									</td>
    969. 

  969. 									<td class="description last">
    970. 

  970. 										<p>The amount to translate in the X axis or alternatively a translation vector.</p>
    971. 

  971. 									</td>
    972. 

  972. 								</tr>
    973. 

  973. 								<tr>
    974. 

  974. 									<td class="name">
    975. 

  975. 										<strong translate="no">y</strong>
    976. 

  976. 									</td>
    977. 

  977. 									<td class="description last">
    978. 

  978. 										<p>The amount to translate in the Y axis.</p>
    979. 

  979. 									</td>
    980. 

  980. 								</tr>
    981. 

  981. 								<tr>
    982. 

  982. 									<td class="name">
    983. 

  983. 										<strong translate="no">z</strong>
    984. 

  984. 									</td>
    985. 

  985. 									<td class="description last">
    986. 

  986. 										<p>The amount to translate in the z axis.</p>
    987. 

  987. 									</td>
    988. 

  988. 								</tr>
    989. 

  989. 							</tbody>
    990. 

  990. 						</table>
    991. 

  991. 						<dl class="details">
    992. 

  992. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    993. 

  993. 						</dl>
    994. 

  994. 					</div>
    995. 

  995. 					<h3 class="name name-method" id="multiply" translate="no">.<a href="#multiply">multiply</a><span class="signature">( m : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    996. 

  996. 					<div class="method">
    997. 

  997. 						<div class="description">
    998. 

  998. 							<p>Post-multiplies this matrix by the given 4x4 matrix.</p>
    999. 

  999. 						</div>
    1000. 

  1000. 						<table class="params">
    1001. 

  1001. 							<tbody>
    1002. 

  1002. 								<tr>
    1003. 

  1003. 									<td class="name">
    1004. 

  1004. 										<strong translate="no">m</strong>
    1005. 

  1005. 									</td>
    1006. 

  1006. 									<td class="description last">
    1007. 

  1007. 										<p>The matrix to multiply with.</p>
    1008. 

  1008. 									</td>
    1009. 

  1009. 								</tr>
    1010. 

  1010. 							</tbody>
    1011. 

  1011. 						</table>
    1012. 

  1012. 						<dl class="details">
    1013. 

  1013. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1014. 

  1014. 						</dl>
    1015. 

  1015. 					</div>
    1016. 

  1016. 					<h3 class="name name-method" id="multiplyMatrices" translate="no">.<a href="#multiplyMatrices">multiplyMatrices</a><span class="signature">( a : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span>, b : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1017. 

  1017. 					<div class="method">
    1018. 

  1018. 						<div class="description">
    1019. 

  1019. 							<p>Multiples the given 4x4 matrices and stores the result
    1020. 

  1020. in this matrix.</p>
    1021. 

  1021. 						</div>
    1022. 

  1022. 						<table class="params">
    1023. 

  1023. 							<tbody>
    1024. 

  1024. 								<tr>
    1025. 

  1025. 									<td class="name">
    1026. 

  1026. 										<strong translate="no">a</strong>
    1027. 

  1027. 									</td>
    1028. 

  1028. 									<td class="description last">
    1029. 

  1029. 										<p>The first matrix.</p>
    1030. 

  1030. 									</td>
    1031. 

  1031. 								</tr>
    1032. 

  1032. 								<tr>
    1033. 

  1033. 									<td class="name">
    1034. 

  1034. 										<strong translate="no">b</strong>
    1035. 

  1035. 									</td>
    1036. 

  1036. 									<td class="description last">
    1037. 

  1037. 										<p>The second matrix.</p>
    1038. 

  1038. 									</td>
    1039. 

  1039. 								</tr>
    1040. 

  1040. 							</tbody>
    1041. 

  1041. 						</table>
    1042. 

  1042. 						<dl class="details">
    1043. 

  1043. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1044. 

  1044. 						</dl>
    1045. 

  1045. 					</div>
    1046. 

  1046. 					<h3 class="name name-method" id="multiplyScalar" translate="no">.<a href="#multiplyScalar">multiplyScalar</a><span class="signature">( s : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1047. 

  1047. 					<div class="method">
    1048. 

  1048. 						<div class="description">
    1049. 

  1049. 							<p>Multiplies every component of the matrix by the given scalar.</p>
    1050. 

  1050. 						</div>
    1051. 

  1051. 						<table class="params">
    1052. 

  1052. 							<tbody>
    1053. 

  1053. 								<tr>
    1054. 

  1054. 									<td class="name">
    1055. 

  1055. 										<strong translate="no">s</strong>
    1056. 

  1056. 									</td>
    1057. 

  1057. 									<td class="description last">
    1058. 

  1058. 										<p>The scalar.</p>
    1059. 

  1059. 									</td>
    1060. 

  1060. 								</tr>
    1061. 

  1061. 							</tbody>
    1062. 

  1062. 						</table>
    1063. 

  1063. 						<dl class="details">
    1064. 

  1064. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1065. 

  1065. 						</dl>
    1066. 

  1066. 					</div>
    1067. 

  1067. 					<h3 class="name name-method" id="premultiply" translate="no">.<a href="#premultiply">premultiply</a><span class="signature">( m : <span class="param-type"><a href="Matrix4.html">Matrix4</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1068. 

  1068. 					<div class="method">
    1069. 

  1069. 						<div class="description">
    1070. 

  1070. 							<p>Pre-multiplies this matrix by the given 4x4 matrix.</p>
    1071. 

  1071. 						</div>
    1072. 

  1072. 						<table class="params">
    1073. 

  1073. 							<tbody>
    1074. 

  1074. 								<tr>
    1075. 

  1075. 									<td class="name">
    1076. 

  1076. 										<strong translate="no">m</strong>
    1077. 

  1077. 									</td>
    1078. 

  1078. 									<td class="description last">
    1079. 

  1079. 										<p>The matrix to multiply with.</p>
    1080. 

  1080. 									</td>
    1081. 

  1081. 								</tr>
    1082. 

  1082. 							</tbody>
    1083. 

  1083. 						</table>
    1084. 

  1084. 						<dl class="details">
    1085. 

  1085. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1086. 

  1086. 						</dl>
    1087. 

  1087. 					</div>
    1088. 

  1088. 					<h3 class="name name-method" id="scale" translate="no">.<a href="#scale">scale</a><span class="signature">( v : <span class="param-type"><a href="Vector3.html">Vector3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1089. 

  1089. 					<div class="method">
    1090. 

  1090. 						<div class="description">
    1091. 

  1091. 							<p>Multiplies the columns of this matrix by the given vector.</p>
    1092. 

  1092. 						</div>
    1093. 

  1093. 						<table class="params">
    1094. 

  1094. 							<tbody>
    1095. 

  1095. 								<tr>
    1096. 

  1096. 									<td class="name">
    1097. 

  1097. 										<strong translate="no">v</strong>
    1098. 

  1098. 									</td>
    1099. 

  1099. 									<td class="description last">
    1100. 

  1100. 										<p>The scale vector.</p>
    1101. 

  1101. 									</td>
    1102. 

  1102. 								</tr>
    1103. 

  1103. 							</tbody>
    1104. 

  1104. 						</table>
    1105. 

  1105. 						<dl class="details">
    1106. 

  1106. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1107. 

  1107. 						</dl>
    1108. 

  1108. 					</div>
    1109. 

  1109. 					<h3 class="name name-method" id="set" translate="no">.<a href="#set">set</a><span class="signature">( n11 : <span class="param-type">number</span>, n12 : <span class="param-type">number</span>, n13 : <span class="param-type">number</span>, n14 : <span class="param-type">number</span>, n21 : <span class="param-type">number</span>, n22 : <span class="param-type">number</span>, n23 : <span class="param-type">number</span>, n24 : <span class="param-type">number</span>, n31 : <span class="param-type">number</span>, n32 : <span class="param-type">number</span>, n33 : <span class="param-type">number</span>, n34 : <span class="param-type">number</span>, n41 : <span class="param-type">number</span>, n42 : <span class="param-type">number</span>, n43 : <span class="param-type">number</span>, n44 : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1110. 

  1110. 					<div class="method">
    1111. 

  1111. 						<div class="description">
    1112. 

  1112. 							<p>Sets the elements of the matrix.The arguments are supposed to be
    1113. 

  1113. in row-major order.</p>
    1114. 

  1114. 						</div>
    1115. 

  1115. 						<table class="params">
    1116. 

  1116. 							<tbody>
    1117. 

  1117. 								<tr>
    1118. 

  1118. 									<td class="name">
    1119. 

  1119. 										<strong translate="no">n11</strong>
    1120. 

  1120. 									</td>
    1121. 

  1121. 									<td class="description last">
    1122. 

  1122. 										<p>1-1 matrix element.</p>
    1123. 

  1123. 									</td>
    1124. 

  1124. 								</tr>
    1125. 

  1125. 								<tr>
    1126. 

  1126. 									<td class="name">
    1127. 

  1127. 										<strong translate="no">n12</strong>
    1128. 

  1128. 									</td>
    1129. 

  1129. 									<td class="description last">
    1130. 

  1130. 										<p>1-2 matrix element.</p>
    1131. 

  1131. 									</td>
    1132. 

  1132. 								</tr>
    1133. 

  1133. 								<tr>
    1134. 

  1134. 									<td class="name">
    1135. 

  1135. 										<strong translate="no">n13</strong>
    1136. 

  1136. 									</td>
    1137. 

  1137. 									<td class="description last">
    1138. 

  1138. 										<p>1-3 matrix element.</p>
    1139. 

  1139. 									</td>
    1140. 

  1140. 								</tr>
    1141. 

  1141. 								<tr>
    1142. 

  1142. 									<td class="name">
    1143. 

  1143. 										<strong translate="no">n14</strong>
    1144. 

  1144. 									</td>
    1145. 

  1145. 									<td class="description last">
    1146. 

  1146. 										<p>1-4 matrix element.</p>
    1147. 

  1147. 									</td>
    1148. 

  1148. 								</tr>
    1149. 

  1149. 								<tr>
    1150. 

  1150. 									<td class="name">
    1151. 

  1151. 										<strong translate="no">n21</strong>
    1152. 

  1152. 									</td>
    1153. 

  1153. 									<td class="description last">
    1154. 

  1154. 										<p>2-1 matrix element.</p>
    1155. 

  1155. 									</td>
    1156. 

  1156. 								</tr>
    1157. 

  1157. 								<tr>
    1158. 

  1158. 									<td class="name">
    1159. 

  1159. 										<strong translate="no">n22</strong>
    1160. 

  1160. 									</td>
    1161. 

  1161. 									<td class="description last">
    1162. 

  1162. 										<p>2-2 matrix element.</p>
    1163. 

  1163. 									</td>
    1164. 

  1164. 								</tr>
    1165. 

  1165. 								<tr>
    1166. 

  1166. 									<td class="name">
    1167. 

  1167. 										<strong translate="no">n23</strong>
    1168. 

  1168. 									</td>
    1169. 

  1169. 									<td class="description last">
    1170. 

  1170. 										<p>2-3 matrix element.</p>
    1171. 

  1171. 									</td>
    1172. 

  1172. 								</tr>
    1173. 

  1173. 								<tr>
    1174. 

  1174. 									<td class="name">
    1175. 

  1175. 										<strong translate="no">n24</strong>
    1176. 

  1176. 									</td>
    1177. 

  1177. 									<td class="description last">
    1178. 

  1178. 										<p>2-4 matrix element.</p>
    1179. 

  1179. 									</td>
    1180. 

  1180. 								</tr>
    1181. 

  1181. 								<tr>
    1182. 

  1182. 									<td class="name">
    1183. 

  1183. 										<strong translate="no">n31</strong>
    1184. 

  1184. 									</td>
    1185. 

  1185. 									<td class="description last">
    1186. 

  1186. 										<p>3-1 matrix element.</p>
    1187. 

  1187. 									</td>
    1188. 

  1188. 								</tr>
    1189. 

  1189. 								<tr>
    1190. 

  1190. 									<td class="name">
    1191. 

  1191. 										<strong translate="no">n32</strong>
    1192. 

  1192. 									</td>
    1193. 

  1193. 									<td class="description last">
    1194. 

  1194. 										<p>3-2 matrix element.</p>
    1195. 

  1195. 									</td>
    1196. 

  1196. 								</tr>
    1197. 

  1197. 								<tr>
    1198. 

  1198. 									<td class="name">
    1199. 

  1199. 										<strong translate="no">n33</strong>
    1200. 

  1200. 									</td>
    1201. 

  1201. 									<td class="description last">
    1202. 

  1202. 										<p>3-3 matrix element.</p>
    1203. 

  1203. 									</td>
    1204. 

  1204. 								</tr>
    1205. 

  1205. 								<tr>
    1206. 

  1206. 									<td class="name">
    1207. 

  1207. 										<strong translate="no">n34</strong>
    1208. 

  1208. 									</td>
    1209. 

  1209. 									<td class="description last">
    1210. 

  1210. 										<p>3-4 matrix element.</p>
    1211. 

  1211. 									</td>
    1212. 

  1212. 								</tr>
    1213. 

  1213. 								<tr>
    1214. 

  1214. 									<td class="name">
    1215. 

  1215. 										<strong translate="no">n41</strong>
    1216. 

  1216. 									</td>
    1217. 

  1217. 									<td class="description last">
    1218. 

  1218. 										<p>4-1 matrix element.</p>
    1219. 

  1219. 									</td>
    1220. 

  1220. 								</tr>
    1221. 

  1221. 								<tr>
    1222. 

  1222. 									<td class="name">
    1223. 

  1223. 										<strong translate="no">n42</strong>
    1224. 

  1224. 									</td>
    1225. 

  1225. 									<td class="description last">
    1226. 

  1226. 										<p>4-2 matrix element.</p>
    1227. 

  1227. 									</td>
    1228. 

  1228. 								</tr>
    1229. 

  1229. 								<tr>
    1230. 

  1230. 									<td class="name">
    1231. 

  1231. 										<strong translate="no">n43</strong>
    1232. 

  1232. 									</td>
    1233. 

  1233. 									<td class="description last">
    1234. 

  1234. 										<p>4-3 matrix element.</p>
    1235. 

  1235. 									</td>
    1236. 

  1236. 								</tr>
    1237. 

  1237. 								<tr>
    1238. 

  1238. 									<td class="name">
    1239. 

  1239. 										<strong translate="no">n44</strong>
    1240. 

  1240. 									</td>
    1241. 

  1241. 									<td class="description last">
    1242. 

  1242. 										<p>4-4 matrix element.</p>
    1243. 

  1243. 									</td>
    1244. 

  1244. 								</tr>
    1245. 

  1245. 							</tbody>
    1246. 

  1246. 						</table>
    1247. 

  1247. 						<dl class="details">
    1248. 

  1248. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1249. 

  1249. 						</dl>
    1250. 

  1250. 					</div>
    1251. 

  1251. 					<h3 class="name name-method" id="setFromMatrix3" translate="no">.<a href="#setFromMatrix3">setFromMatrix3</a><span class="signature">( m : <span class="param-type"><a href="Matrix3.html">Matrix3</a></span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1252. 

  1252. 					<div class="method">
    1253. 

  1253. 						<div class="description">
    1254. 

  1254. 							<p>Set the upper 3x3 elements of this matrix to the values of given 3x3 matrix.</p>
    1255. 

  1255. 						</div>
    1256. 

  1256. 						<table class="params">
    1257. 

  1257. 							<tbody>
    1258. 

  1258. 								<tr>
    1259. 

  1259. 									<td class="name">
    1260. 

  1260. 										<strong translate="no">m</strong>
    1261. 

  1261. 									</td>
    1262. 

  1262. 									<td class="description last">
    1263. 

  1263. 										<p>The 3x3 matrix.</p>
    1264. 

  1264. 									</td>
    1265. 

  1265. 								</tr>
    1266. 

  1266. 							</tbody>
    1267. 

  1267. 						</table>
    1268. 

  1268. 						<dl class="details">
    1269. 

  1269. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1270. 

  1270. 						</dl>
    1271. 

  1271. 					</div>
    1272. 

  1272. 					<h3 class="name name-method" id="setPosition" translate="no">.<a href="#setPosition">setPosition</a><span class="signature">( x : <span class="param-type">number | <a href="Vector3.html">Vector3</a></span>, y : <span class="param-type">number</span>, z : <span class="param-type">number</span> )</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1273. 

  1273. 					<div class="method">
    1274. 

  1274. 						<div class="description">
    1275. 

  1275. 							<p>Sets the position component for this matrix from the given vector,
    1276. 

  1276. without affecting the rest of the matrix.</p>
    1277. 

  1277. 						</div>
    1278. 

  1278. 						<table class="params">
    1279. 

  1279. 							<tbody>
    1280. 

  1280. 								<tr>
    1281. 

  1281. 									<td class="name">
    1282. 

  1282. 										<strong translate="no">x</strong>
    1283. 

  1283. 									</td>
    1284. 

  1284. 									<td class="description last">
    1285. 

  1285. 										<p>The x component of the vector or alternatively the vector object.</p>
    1286. 

  1286. 									</td>
    1287. 

  1287. 								</tr>
    1288. 

  1288. 								<tr>
    1289. 

  1289. 									<td class="name">
    1290. 

  1290. 										<strong translate="no">y</strong>
    1291. 

  1291. 									</td>
    1292. 

  1292. 									<td class="description last">
    1293. 

  1293. 										<p>The y component of the vector.</p>
    1294. 

  1294. 									</td>
    1295. 

  1295. 								</tr>
    1296. 

  1296. 								<tr>
    1297. 

  1297. 									<td class="name">
    1298. 

  1298. 										<strong translate="no">z</strong>
    1299. 

  1299. 									</td>
    1300. 

  1300. 									<td class="description last">
    1301. 

  1301. 										<p>The z component of the vector.</p>
    1302. 

  1302. 									</td>
    1303. 

  1303. 								</tr>
    1304. 

  1304. 							</tbody>
    1305. 

  1305. 						</table>
    1306. 

  1306. 						<dl class="details">
    1307. 

  1307. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1308. 

  1308. 						</dl>
    1309. 

  1309. 					</div>
    1310. 

  1310. 					<h3 class="name name-method" id="toArray" translate="no">.<a href="#toArray">toArray</a><span class="signature">( array : <span class="param-type">Array.&lt;number></span>, offset : <span class="param-type">number</span> )</span><span class="type-signature"> : Array.&lt;number></span> </h3>
    1311. 

  1311. 					<div class="method">
    1312. 

  1312. 						<div class="description">
    1313. 

  1313. 							<p>Writes the elements of this matrix to the given array. If no array is provided,
    1314. 

  1314. the method returns a new instance.</p>
    1315. 

  1315. 						</div>
    1316. 

  1316. 						<table class="params">
    1317. 

  1317. 							<tbody>
    1318. 

  1318. 								<tr>
    1319. 

  1319. 									<td class="name">
    1320. 

  1320. 										<strong translate="no">array</strong>
    1321. 

  1321. 									</td>
    1322. 

  1322. 									<td class="description last">
    1323. 

  1323. 										<p>The target array holding the matrix elements in column-major order.</p>
    1324. 

  1324. 										<p>Default is <code>[]</code>.</p>
    1325. 

  1325. 									</td>
    1326. 

  1326. 								</tr>
    1327. 

  1327. 								<tr>
    1328. 

  1328. 									<td class="name">
    1329. 

  1329. 										<strong translate="no">offset</strong>
    1330. 

  1330. 									</td>
    1331. 

  1331. 									<td class="description last">
    1332. 

  1332. 										<p>Index of the first element in the array.</p>
    1333. 

  1333. 										<p>Default is <code>0</code>.</p>
    1334. 

  1334. 									</td>
    1335. 

  1335. 								</tr>
    1336. 

  1336. 							</tbody>
    1337. 

  1337. 						</table>
    1338. 

  1338. 						<dl class="details">
    1339. 

  1339. 							<dt class="tag-returns"><strong>Returns:</strong> The matrix elements in column-major order.</dt>
    1340. 

  1340. 						</dl>
    1341. 

  1341. 					</div>
    1342. 

  1342. 					<h3 class="name name-method" id="transpose" translate="no">.<a href="#transpose">transpose</a><span class="signature">()</span><span class="type-signature"> : <a href="Matrix4.html">Matrix4</a></span> </h3>
    1343. 

  1343. 					<div class="method">
    1344. 

  1344. 						<div class="description">
    1345. 

  1345. 							<p>Transposes this matrix in place.</p>
    1346. 

  1346. 						</div>
    1347. 

  1347. 						<dl class="details">
    1348. 

  1348. 							<dt class="tag-returns"><strong>Returns:</strong> A reference to this matrix.</dt>
    1349. 

  1349. 						</dl>
    1350. 

  1350. 					</div>
    1351. 

  1351. 				<h2 class="subsection-title">Source</h2>
    1352. 

  1352. 				<p>
    1353. 

  1353. 					<a href="https://github.com/mrdoob/three.js/blob/master/src/math/Matrix4.js" translate="no" target="_blank" rel="noopener">src/math/Matrix4.js</a>
    1354. 

  1354. 				</p>
    1355. 

  1355. 			</article>
    1356. 

  1356. 		</section>
    1357. 

  1357. <script src="../scripts/linenumber.js"></script>
    1358. 

  1358. <script src="../scripts/page.js"></script>
    1359. 

  1359. </body>
    1360. 

  1360. </html>
    1361.
粤ICP备19079148号