]> git.lizzy.rs Git - minetest.git/blob - builtin/common/vector.lua
Add Lua helper functions vector.apply(v) math.sign(x, tolerance)
[minetest.git] / builtin / common / vector.lua
1
2 vector = {}
3
4 function vector.new(a, b, c)
5         if type(a) == "table" then
6                 assert(a.x and a.y and a.z, "Invalid vector passed to vector.new()")
7                 return {x=a.x, y=a.y, z=a.z}
8         elseif a then
9                 assert(b and c, "Invalid arguments for vector.new()")
10                 return {x=a, y=b, z=c}
11         end
12         return {x=0, y=0, z=0}
13 end
14
15 function vector.equals(a, b)
16         return a.x == b.x and
17                a.y == b.y and
18                a.z == b.z
19 end
20
21 function vector.length(v)
22         return math.hypot(v.x, math.hypot(v.y, v.z))
23 end
24
25 function vector.normalize(v)
26         local len = vector.length(v)
27         if len == 0 then
28                 return {x=0, y=0, z=0}
29         else
30                 return vector.divide(v, len)
31         end
32 end
33
34 function vector.round(v)
35         return {
36                 x = math.floor(v.x + 0.5),
37                 y = math.floor(v.y + 0.5),
38                 z = math.floor(v.z + 0.5)
39         }
40 end
41
42 function vector.apply(v, func)
43         return {
44                 x = func(v.x),
45                 y = func(v.y),
46                 z = func(v.z)
47         }
48 end
49
50 function vector.distance(a, b)
51         local x = a.x - b.x
52         local y = a.y - b.y
53         local z = a.z - b.z
54         return math.hypot(x, math.hypot(y, z))
55 end
56
57 function vector.direction(pos1, pos2)
58         local x_raw = pos2.x - pos1.x
59         local y_raw = pos2.y - pos1.y
60         local z_raw = pos2.z - pos1.z
61         local x_abs = math.abs(x_raw)
62         local y_abs = math.abs(y_raw)
63         local z_abs = math.abs(z_raw)
64         if x_abs >= y_abs and
65            x_abs >= z_abs then
66                 y_raw = y_raw * (1 / x_abs)
67                 z_raw = z_raw * (1 / x_abs)
68                 x_raw = x_raw / x_abs
69         end
70         if y_abs >= x_abs and
71            y_abs >= z_abs then
72                 x_raw = x_raw * (1 / y_abs)
73                 z_raw = z_raw * (1 / y_abs)
74                 y_raw = y_raw / y_abs
75         end
76         if z_abs >= y_abs and
77            z_abs >= x_abs then
78                 x_raw = x_raw * (1 / z_abs)
79                 y_raw = y_raw * (1 / z_abs)
80                 z_raw = z_raw / z_abs
81         end
82         return {x=x_raw, y=y_raw, z=z_raw}
83 end
84
85
86 function vector.add(a, b)
87         if type(b) == "table" then
88                 return {x = a.x + b.x,
89                         y = a.y + b.y,
90                         z = a.z + b.z}
91         else
92                 return {x = a.x + b,
93                         y = a.y + b,
94                         z = a.z + b}
95         end
96 end
97
98 function vector.subtract(a, b)
99         if type(b) == "table" then
100                 return {x = a.x - b.x,
101                         y = a.y - b.y,
102                         z = a.z - b.z}
103         else
104                 return {x = a.x - b,
105                         y = a.y - b,
106                         z = a.z - b}
107         end
108 end
109
110 function vector.multiply(a, b)
111         if type(b) == "table" then
112                 return {x = a.x * b.x,
113                         y = a.y * b.y,
114                         z = a.z * b.z}
115         else
116                 return {x = a.x * b,
117                         y = a.y * b,
118                         z = a.z * b}
119         end
120 end
121
122 function vector.divide(a, b)
123         if type(b) == "table" then
124                 return {x = a.x / b.x,
125                         y = a.y / b.y,
126                         z = a.z / b.z}
127         else
128                 return {x = a.x / b,
129                         y = a.y / b,
130                         z = a.z / b}
131         end
132 end
133