VoxelEngine/doc/ru/scripting/builtins/libvecn.md

Библиотека Vecn

vecn содержит набор функций для работы с векторами размерностью 2, 3 или 4. Большинство функций имеют несколько вариантов списка аргументов (перегрузок).

Warning

vecn, где n == размерность вектора (2, 3, 4), т.е vec2, vec3, vec4

Типы данных

На данной странице будут использоваться условные обозначения типов.

• vector - массив из двух, трех или четырех чисел
• vec2 - массив из двух чисел
• vec3 - массив из трех чисел
• vec4 - массив из четырех чисел

Warning

Аннотации типов являются частью документации и не указываются при вызове использовании.

Операции с векторами

Сложение - vecn.add(...)

-- возвращает результат сложения векторов
vecn.add(a: vector, b: vector)

-- возвращает результат сложения вектора и скаляра
vecn.add(a: vector, b: number)

Вычитание - vecn.sub(...)

-- возвращает результат вычитания векторов
vecn.sub(a: vector, b: vector)

-- возвращает результат вычитания скаляра из вектора
vecn.sub(a: vector, b: number)

Умножение - vecn.mul(...)

-- возвращает результат умножения векторов
vecn.mul(a: vector, b: vector)

-- возвращает результат умножения вектора на скаляр
vecn.mul(a: vector, b: number)

Инверсия - vecn.inv(...)

-- возвращает результат инверсии (противоположный) вектора
vecn.inv(a: vector)

Деление - vecn.div(...)

-- возвращает результат деления векторов
vecn.div(a: vector, b: vector)

-- возвращает результат деления вектора на скаляр
vecn.div(a: vector, b: number)

Нормализация - vecn.norm(...)

-- возвращает нормализованный вектор
vecn.norm(a: vector)

Длина вектора - vecn.len(...)

-- возвращает длину вектора
vecn.len(a: vector)

Абсолютное значение - vecn.abs(...)

-- возвращает вектор с абсолютными значениями
vecn.abs(a: vector)

Округление - vecn.round(...)

-- возвращает вектор с округленными значениями
vecn.round(a: vector)

Степень - vecn.pow(...)

-- возвращает вектор с элементами, возведенными в степень
vecn.pow(a: vector, b: number)

Скалярное произведение - vecn.dot(...)

-- возвращает скалярное произведение векторов
vecn.dot(a: vector, b: vector)

Поворот - vecn.rot(...)

Warning

Угол поворота (angle) указывается в радианах.

-- возвращает вектор, повернутый на заданный угол
vecn.rot(a: vector, angle: number)

Перевод в строку - vecn.tostring(...)

Warning

Возвращает только тогда, когда содержимым является вектор

-- возвращает строку представляющую содержимое вектора
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, 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}