1 |
|
2 |
|
3 | # Function intersect
|
4 |
|
5 | Calculates the point of intersection of two lines in two or three dimensions
|
6 | and of a line and a plane in three dimensions. The inputs are in the form of
|
7 | arrays or 1 dimensional matrices. The line intersection functions return null
|
8 | if the lines do not meet.
|
9 |
|
10 | Note: Fill the plane coefficients as `x + y + z = c` and not as `x + y + z + c = 0`.
|
11 |
|
12 |
|
13 | ## Syntax
|
14 |
|
15 | ```js
|
16 | math.intersect(endPoint1Line1, endPoint2Line1, endPoint1Line2, endPoint2Line2)
|
17 | math.intersect(endPoint1, endPoint2, planeCoefficients)
|
18 | ```
|
19 |
|
20 | ### Parameters
|
21 |
|
22 | Parameter | Type | Description
|
23 | --------- | ---- | -----------
|
24 | `w` | Array | Matrix | Co-ordinates of first end-point of first line
|
25 | `x` | Array | Matrix | Co-ordinates of second end-point of first line
|
26 | `y` | Array | Matrix | Co-ordinates of first end-point of second line OR Co-efficients of the plane's equation
|
27 | `z` | Array | Matrix | Co-ordinates of second end-point of second line OR null if the calculation is for line and plane
|
28 |
|
29 | ### Returns
|
30 |
|
31 | Type | Description
|
32 | ---- | -----------
|
33 | Array | Returns the point of intersection of lines/lines-planes
|
34 |
|
35 |
|
36 | ## Examples
|
37 |
|
38 | ```js
|
39 | math.intersect([0, 0], [10, 10], [10, 0], [0, 10]) // Returns [5, 5]
|
40 | math.intersect([0, 0, 0], [10, 10, 0], [10, 0, 0], [0, 10, 0]) // Returns [5, 5, 0]
|
41 | math.intersect([1, 0, 1], [4, -2, 2], [1, 1, 1, 6]) // Returns [7, -4, 3]
|
42 | ```
|
43 |
|
44 |
|