intersect.js 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200
  1. import { factory } from '../../utils/factory.js';
  2. var name = 'intersect';
  3. var dependencies = ['typed', 'config', 'abs', 'add', 'addScalar', 'matrix', 'multiply', 'multiplyScalar', 'divideScalar', 'subtract', 'smaller', 'equalScalar', 'flatten', 'isZero', 'isNumeric'];
  4. export var createIntersect = /* #__PURE__ */factory(name, dependencies, _ref => {
  5. var {
  6. typed,
  7. config,
  8. abs,
  9. add,
  10. addScalar,
  11. matrix,
  12. multiply,
  13. multiplyScalar,
  14. divideScalar,
  15. subtract,
  16. smaller,
  17. equalScalar,
  18. flatten,
  19. isZero,
  20. isNumeric
  21. } = _ref;
  22. /**
  23. * Calculates the point of intersection of two lines in two or three dimensions
  24. * and of a line and a plane in three dimensions. The inputs are in the form of
  25. * arrays or 1 dimensional matrices. The line intersection functions return null
  26. * if the lines do not meet.
  27. *
  28. * Note: Fill the plane coefficients as `x + y + z = c` and not as `x + y + z + c = 0`.
  29. *
  30. * Syntax:
  31. *
  32. * math.intersect(endPoint1Line1, endPoint2Line1, endPoint1Line2, endPoint2Line2)
  33. * math.intersect(endPoint1, endPoint2, planeCoefficients)
  34. *
  35. * Examples:
  36. *
  37. * math.intersect([0, 0], [10, 10], [10, 0], [0, 10]) // Returns [5, 5]
  38. * math.intersect([0, 0, 0], [10, 10, 0], [10, 0, 0], [0, 10, 0]) // Returns [5, 5, 0]
  39. * math.intersect([1, 0, 1], [4, -2, 2], [1, 1, 1, 6]) // Returns [7, -4, 3]
  40. *
  41. * @param {Array | Matrix} w Co-ordinates of first end-point of first line
  42. * @param {Array | Matrix} x Co-ordinates of second end-point of first line
  43. * @param {Array | Matrix} y Co-ordinates of first end-point of second line
  44. * OR Co-efficients of the plane's equation
  45. * @param {Array | Matrix} z Co-ordinates of second end-point of second line
  46. * OR undefined if the calculation is for line and plane
  47. * @return {Array} Returns the point of intersection of lines/lines-planes
  48. */
  49. return typed('intersect', {
  50. 'Array, Array, Array': _AAA,
  51. 'Array, Array, Array, Array': _AAAA,
  52. 'Matrix, Matrix, Matrix': function MatrixMatrixMatrix(x, y, plane) {
  53. var arr = _AAA(x.valueOf(), y.valueOf(), plane.valueOf());
  54. return arr === null ? null : matrix(arr);
  55. },
  56. 'Matrix, Matrix, Matrix, Matrix': function MatrixMatrixMatrixMatrix(w, x, y, z) {
  57. // TODO: output matrix type should match input matrix type
  58. var arr = _AAAA(w.valueOf(), x.valueOf(), y.valueOf(), z.valueOf());
  59. return arr === null ? null : matrix(arr);
  60. }
  61. });
  62. function _AAA(x, y, plane) {
  63. x = _coerceArr(x);
  64. y = _coerceArr(y);
  65. plane = _coerceArr(plane);
  66. if (!_3d(x)) {
  67. throw new TypeError('Array with 3 numbers or BigNumbers expected for first argument');
  68. }
  69. if (!_3d(y)) {
  70. throw new TypeError('Array with 3 numbers or BigNumbers expected for second argument');
  71. }
  72. if (!_4d(plane)) {
  73. throw new TypeError('Array with 4 numbers expected as third argument');
  74. }
  75. return _intersectLinePlane(x[0], x[1], x[2], y[0], y[1], y[2], plane[0], plane[1], plane[2], plane[3]);
  76. }
  77. function _AAAA(w, x, y, z) {
  78. w = _coerceArr(w);
  79. x = _coerceArr(x);
  80. y = _coerceArr(y);
  81. z = _coerceArr(z);
  82. if (w.length === 2) {
  83. if (!_2d(w)) {
  84. throw new TypeError('Array with 2 numbers or BigNumbers expected for first argument');
  85. }
  86. if (!_2d(x)) {
  87. throw new TypeError('Array with 2 numbers or BigNumbers expected for second argument');
  88. }
  89. if (!_2d(y)) {
  90. throw new TypeError('Array with 2 numbers or BigNumbers expected for third argument');
  91. }
  92. if (!_2d(z)) {
  93. throw new TypeError('Array with 2 numbers or BigNumbers expected for fourth argument');
  94. }
  95. return _intersect2d(w, x, y, z);
  96. } else if (w.length === 3) {
  97. if (!_3d(w)) {
  98. throw new TypeError('Array with 3 numbers or BigNumbers expected for first argument');
  99. }
  100. if (!_3d(x)) {
  101. throw new TypeError('Array with 3 numbers or BigNumbers expected for second argument');
  102. }
  103. if (!_3d(y)) {
  104. throw new TypeError('Array with 3 numbers or BigNumbers expected for third argument');
  105. }
  106. if (!_3d(z)) {
  107. throw new TypeError('Array with 3 numbers or BigNumbers expected for fourth argument');
  108. }
  109. return _intersect3d(w[0], w[1], w[2], x[0], x[1], x[2], y[0], y[1], y[2], z[0], z[1], z[2]);
  110. } else {
  111. throw new TypeError('Arrays with two or thee dimensional points expected');
  112. }
  113. }
  114. /** Coerce row and column 2-dim arrays to 1-dim array */
  115. function _coerceArr(arr) {
  116. // row matrix
  117. if (arr.length === 1) return arr[0];
  118. // column matrix
  119. if (arr.length > 1 && Array.isArray(arr[0])) {
  120. if (arr.every(el => Array.isArray(el) && el.length === 1)) return flatten(arr);
  121. }
  122. return arr;
  123. }
  124. function _2d(x) {
  125. return x.length === 2 && isNumeric(x[0]) && isNumeric(x[1]);
  126. }
  127. function _3d(x) {
  128. return x.length === 3 && isNumeric(x[0]) && isNumeric(x[1]) && isNumeric(x[2]);
  129. }
  130. function _4d(x) {
  131. return x.length === 4 && isNumeric(x[0]) && isNumeric(x[1]) && isNumeric(x[2]) && isNumeric(x[3]);
  132. }
  133. function _intersect2d(p1a, p1b, p2a, p2b) {
  134. var o1 = p1a;
  135. var o2 = p2a;
  136. var d1 = subtract(o1, p1b);
  137. var d2 = subtract(o2, p2b);
  138. var det = subtract(multiplyScalar(d1[0], d2[1]), multiplyScalar(d2[0], d1[1]));
  139. if (isZero(det)) return null;
  140. if (smaller(abs(det), config.epsilon)) {
  141. return null;
  142. }
  143. var d20o11 = multiplyScalar(d2[0], o1[1]);
  144. var d21o10 = multiplyScalar(d2[1], o1[0]);
  145. var d20o21 = multiplyScalar(d2[0], o2[1]);
  146. var d21o20 = multiplyScalar(d2[1], o2[0]);
  147. var t = divideScalar(addScalar(subtract(subtract(d20o11, d21o10), d20o21), d21o20), det);
  148. return add(multiply(d1, t), o1);
  149. }
  150. function _intersect3dHelper(a, b, c, d, e, f, g, h, i, j, k, l) {
  151. // (a - b)*(c - d) + (e - f)*(g - h) + (i - j)*(k - l)
  152. var add1 = multiplyScalar(subtract(a, b), subtract(c, d));
  153. var add2 = multiplyScalar(subtract(e, f), subtract(g, h));
  154. var add3 = multiplyScalar(subtract(i, j), subtract(k, l));
  155. return addScalar(addScalar(add1, add2), add3);
  156. }
  157. function _intersect3d(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4) {
  158. var d1343 = _intersect3dHelper(x1, x3, x4, x3, y1, y3, y4, y3, z1, z3, z4, z3);
  159. var d4321 = _intersect3dHelper(x4, x3, x2, x1, y4, y3, y2, y1, z4, z3, z2, z1);
  160. var d1321 = _intersect3dHelper(x1, x3, x2, x1, y1, y3, y2, y1, z1, z3, z2, z1);
  161. var d4343 = _intersect3dHelper(x4, x3, x4, x3, y4, y3, y4, y3, z4, z3, z4, z3);
  162. var d2121 = _intersect3dHelper(x2, x1, x2, x1, y2, y1, y2, y1, z2, z1, z2, z1);
  163. var numerator = subtract(multiplyScalar(d1343, d4321), multiplyScalar(d1321, d4343));
  164. var denominator = subtract(multiplyScalar(d2121, d4343), multiplyScalar(d4321, d4321));
  165. if (isZero(denominator)) return null;
  166. var ta = divideScalar(numerator, denominator);
  167. var tb = divideScalar(addScalar(d1343, multiplyScalar(ta, d4321)), d4343);
  168. var pax = addScalar(x1, multiplyScalar(ta, subtract(x2, x1)));
  169. var pay = addScalar(y1, multiplyScalar(ta, subtract(y2, y1)));
  170. var paz = addScalar(z1, multiplyScalar(ta, subtract(z2, z1)));
  171. var pbx = addScalar(x3, multiplyScalar(tb, subtract(x4, x3)));
  172. var pby = addScalar(y3, multiplyScalar(tb, subtract(y4, y3)));
  173. var pbz = addScalar(z3, multiplyScalar(tb, subtract(z4, z3)));
  174. if (equalScalar(pax, pbx) && equalScalar(pay, pby) && equalScalar(paz, pbz)) {
  175. return [pax, pay, paz];
  176. } else {
  177. return null;
  178. }
  179. }
  180. function _intersectLinePlane(x1, y1, z1, x2, y2, z2, x, y, z, c) {
  181. var x1x = multiplyScalar(x1, x);
  182. var x2x = multiplyScalar(x2, x);
  183. var y1y = multiplyScalar(y1, y);
  184. var y2y = multiplyScalar(y2, y);
  185. var z1z = multiplyScalar(z1, z);
  186. var z2z = multiplyScalar(z2, z);
  187. var numerator = subtract(subtract(subtract(c, x1x), y1y), z1z);
  188. var denominator = subtract(subtract(subtract(addScalar(addScalar(x2x, y2y), z2z), x1x), y1y), z1z);
  189. var t = divideScalar(numerator, denominator);
  190. var px = addScalar(x1, multiplyScalar(t, subtract(x2, x1)));
  191. var py = addScalar(y1, multiplyScalar(t, subtract(y2, y1)));
  192. var pz = addScalar(z1, multiplyScalar(t, subtract(z2, z1)));
  193. return [px, py, pz];
  194. // TODO: Add cases when line is parallel to the plane:
  195. // (a) no intersection,
  196. // (b) line contained in plane
  197. }
  198. });