upd: docs for vectors, libvecn.cpp

doc/ru/scripting/builtins/libvecn.md

@@ -5,7 +5,7 @@
 
 > [!WARNING]
 >
-> vecn, где n |-> размерность вектора (2, 3, 4), т.е vec2, vec3, vec4
+> vecn, где n == размерность вектора (2, 3, 4), т.е vec2, vec3, vec4
 > 
 
 ## Типы данных
@@ -110,12 +110,6 @@ vecn.pow(a: vector, b: number)
 vecn.dot(a: vector, b: vector)
 ```
 
-#### Векторное произведение - *vecn.cross(...)*
-```lua
--- возвращает векторное произведение векторов
-vecn.cross(a: vector, b: vector)
-```
-
 #### Поворот - *vecn.rot(...)*
 > [!WARNING]
 > Угол поворота (angle) указывается в радианах.
@@ -140,8 +134,50 @@ vecn.tostring(a: vector)
 local v1_3d = {1, 2, 2}
 local v2_3d = {10, 20, 40}
 local v3_4d = {1, 2, 4, 1}
-local v4_2d = {1, 1}
+local v4_2d = {1, 0}
 local scal = 6 -- обычный скаляр
 
+-- сложение векторов
+local result_add = vec3.add(v1_3d, v2_3d)
+print("add: " .. vec3.tostring(result_add)) -- {11, 22, 42}
 
+-- вычитание векторов
+local result_sub = vec3.sub(v2_3d, v1_3d)
+print("sub: " .. vec3.tostring(result_sub)) -- {9, 18, 38}
+
+-- умножение векторов
+local result_mul = vec3.mul(v1_3d, v2_3d)
+print("mul: " .. vec3.tostring(result_mul)) -- {10, 40, 80}
+
+-- умножение вектора на скаляр
+local result_mul_scal = vec3.mul(v1_3d, scal)
+print("mul_scal: " .. vec3.tostring(result_mul_scal)) -- {6, 12, 12}
+
+-- нормализация вектора
+local result_norm = vec3.norm(v1_3d)
+print("norm: " .. vec3.tostring(result_norm)) -- {0.333, 0.667, 0.667}
+
+-- длина вектора
+local result_len = vec3.len(v1_3d)
+print("len: " .. result_len) -- 3
+
+-- абсолютное значение вектора
+local result_abs = vec3.abs(v1_3d)
+print("abs: " .. vec3.tostring(result_abs)) -- {1, 2, 2}
+
+-- округление вектора
+local result_round = vec3.round(v1_3d)
+print("round: " .. vec3.tostring(result_round)) -- {1, 2, 2}
+
+-- степень вектора
+local result_pow = vec3.pow(v1_3d, 2)
+print("pow: " .. vec3.tostring(result_pow)) -- {1, 4, 4}
+
+-- скалярное произведение векторов
+local result_dot = vec3.dot(v1_3d, v2_3d)
+print("dot: " .. result_dot) -- 250
+
+-- поворот вектора
+local result_rot = vec2.rot(v4_2d, math.pi / 4)
+print("rot: " .. vec2.tostring(result_rot)) -- {0.707107, 0.707107}
 ```