134 lines
4.8 KiB
Markdown
134 lines
4.8 KiB
Markdown
# Библиотека *mat4*
|
|
|
|
*mat4* содержит набор функций для работы с матрицами трансформации размерностью 4x4.
|
|
|
|
Большинство функций имеют несколько вариантов списка агрументов (перегрузок).
|
|
|
|
## Единичная матрица - *mat4.idt(...)*
|
|
|
|
```lua
|
|
-- создает единичную матрицу
|
|
mat4.idt()
|
|
|
|
-- записывает единичную матрицу в dst
|
|
mat4.idt(dst: matrix)
|
|
```
|
|
|
|
## Определитель матрицы - *mat4.determinant(...)*
|
|
|
|
```lua
|
|
-- вычисляет определитель матрицы
|
|
mat4.determinant(m: matrix)
|
|
```
|
|
|
|
## Матрица из кватерниона - *mat4.from_quat(...)*
|
|
|
|
```lua
|
|
-- создает матрицу вращения по кватерниону
|
|
mat4.from_quat(quaternion: quat)
|
|
|
|
-- записывает матрицу вращения по кватерниону в dst
|
|
mat4.from_quat(quaternion: quat, dst: matrix)
|
|
```
|
|
|
|
## Умножение матриц - *mat4.mul(...)*
|
|
|
|
```lua
|
|
-- возвращает результат умножения матриц
|
|
mat4.mul(a: matrix, b: matrix)
|
|
-- записывает результат умножения матриц в dst
|
|
mat4.mul(a: matrix, b: matrix, dst: matrix)
|
|
|
|
-- возвращает результат умножения матрицы и вектора
|
|
mat4.mul(a: matrix, v: vector)
|
|
-- записывает результат умножения матрицы и вектора в dst
|
|
mat4.mul(a: matrix, v: vector, dst: vector)
|
|
```
|
|
|
|
## Инверсия матрицы - *mat4.inverse(...)*
|
|
|
|
```lua
|
|
-- возвращает результат инверсии матрицы
|
|
mat4.inverse(m: matrix)
|
|
-- записывает результат инверсии матрицы в dst
|
|
mat4.inverse(m: matrix, dst: matrix)
|
|
```
|
|
|
|
## Транспонирование матрицы - *mat4.transpose(...)*
|
|
|
|
```lua
|
|
-- возвращает результат транспонирования матрицы
|
|
mat4.transpose(m: matrix)
|
|
-- записывает результат транспонирования матрицы в dst
|
|
mat4.transpose(m: matrix, dst: matrix)
|
|
```
|
|
|
|
## Смещение - *mat4.translate(...)*
|
|
|
|
```lua
|
|
-- создает матрицу смещения
|
|
mat4.translate(translation: vec3)
|
|
-- возвращает результат применения смещения к матрице m
|
|
mat4.translate(m: matrix, translation: vec3)
|
|
-- записывает результат применения смещения к матрице m в dst
|
|
mat4.translate(m: matrix, translation: vec3, dst: matrix)
|
|
```
|
|
## Масштабирование - *mat4.scale(...)*
|
|
|
|
```lua
|
|
-- создает матрицу масштабирования
|
|
mat4.scale(scale: vec3)
|
|
-- возвращает результат применения масштабирования к матрице m
|
|
mat4.scale(m: matrix, scale: vec3)
|
|
-- записывает результат применения масштабирования к матрице m в dst
|
|
mat4.scale(m: matrix, scale: vec3, dst: matrix)
|
|
```
|
|
|
|
## Вращение - *mat4.rotate(...)*
|
|
|
|
Угол поворота (angle) указывается в градусах.
|
|
|
|
```lua
|
|
-- создает матрицу поворота (angle - угол поворота) по заданной оси (axis - единичный вектор)
|
|
mat4.rotate(axis: vec3, angle: number)
|
|
-- возвращает результат применения вращения к матрице m
|
|
mat4.rotate(m: matrix, axis: vec3, angle: number)
|
|
-- записывает результат применения вращения к матрице m в dst
|
|
mat4.rotate(m: matrix, axis: vec3, angle: number, dst: matrix)
|
|
```
|
|
|
|
## Декомпозиция - *mat4.decompose(...)*
|
|
|
|
Раскладывает матрицу трансформации на составляющие.
|
|
|
|
```lua
|
|
mat4.decompose(m: matrix)
|
|
-- возвращает таблицу:
|
|
{
|
|
scale=vec3,
|
|
rotation=matrix,
|
|
quaternion=quat,
|
|
translation=vec3,
|
|
skew=vec3,
|
|
perspective=vec4
|
|
} или nil
|
|
```
|
|
|
|
## Отслеживание точки *mat4.look_at(...)*
|
|
|
|
```lua
|
|
-- cоздает матрицу вида с точки 'eye' на точку 'center', где вектор 'up' определяет верх.
|
|
mat4.look_at(eye: vec3, center: vec3, up: vec3)
|
|
-- записывает матрицу вида в dst
|
|
mat4.look_at(eye: vec3, center: vec3, up: vec3, dst: matrix)
|
|
```
|
|
|
|
## Перевод в строку - *mat4.tostring(...)*
|
|
|
|
```lua
|
|
-- возвращает строку представляющую содержимое матрицы
|
|
mat4.tostring(m: matrix)
|
|
-- возвращает строку представляющую содержимое матрицы, многострочную, если multiline = true
|
|
mat4.tostring(m: matrix, multiline: bool)
|
|
```
|