Class Vector

Векторная математика на простых массивах чисел. Вектор - это массив чисел; в 3D это [x, y, z] с осью Y, направленной вверх, той же формы, что и точка, так что их можно передавать в методы друг друга. Каждый метод возвращает новый массив или число и никогда не изменяет свои входные данные. Углы в градусах.

Index

Constructors

constructor

new Vector(math: MathBitByBit, geometryHelper: GeometryHelper): Bit.Vector
Parameters
- math: MathBitByBit
- geometryHelper: GeometryHelper
Returns Bit.Vector
- Defined in bitbybit-docs.d.ts:57305

angles

angleBetween

angleBetween(inputs: TwoVectorsDto): number
Измеряет угол между двумя векторами в градусах, всегда между 0 и 180.

Направление поворота не учитывается; для этого используйте signedAngleBetween. Пример: [1,0,0] и [0,1,0] -> 90
Parameters
- inputs: TwoVectorsDto
  Два вектора
Returns number
Угол в градусах
Example
```
const angle = bitbybit.vector.angleBetween({ first: [1, 0, 0], second: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:57378

angleBetweenNormalized2d

angleBetweenNormalized2d(inputs: TwoVectorsDto): number
Измеряет угол со знаком от первого 2D-вектора ко второму, в градусах от -180 до 180.

Используются только первые две компоненты каждого вектора; положительный угол поворачивает против часовой стрелки. Пример: [1,0] к [0,1] -> 90, [0,1] к [1,0] -> -90
Parameters
- inputs: TwoVectorsDto
  Два 2D-вектора
Returns number
Угол со знаком в градусах
Example
```
const angle = bitbybit.vector.angleBetweenNormalized2d({ first: [1, 0], second: [0, 1] });
```
- Defined in bitbybit-docs.d.ts:57395

positiveAngleBetween

positiveAngleBetween(inputs: TwoVectorsReferenceDto): number
Измеряет угол от первого вектора ко второму, поворачивая вокруг опорного направления, в градусах от 0 до 360.

Поворот против часовой стрелки, когда опорный вектор направлен на вас. Пример: [1,0,0] к [0,0,-1] вокруг [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Два вектора и опорное направление, вокруг которого выполняется поворот
Returns number
Угол в градусах от 0 до 360
Example
```
const angle = bitbybit.vector.positiveAngleBetween({ first: [1, 0, 0], second: [0, 0, -1], reference: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:57412

signedAngleBetween

signedAngleBetween(inputs: TwoVectorsReferenceDto): number
Измеряет угол от первого вектора ко второму, поворачивая вокруг опорного направления, в градусах от 0 до 360.

Поворот против часовой стрелки, когда опорный вектор направлен на вас: поворот по часовой стрелке на 30 градусов читается как 330. Пример: [1,0,0] к [0,0,-1] вокруг [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Два вектора и опорное направление, вокруг которого выполняется поворот
Returns number
Угол в градусах от 0 до 360
Example
```
const angle = bitbybit.vector.signedAngleBetween({ first: [1, 0, 0], second: [0, 0, -1], reference: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:57785

base

cross

cross(inputs: TwoVectorsDto): number[]
Вычисляет векторное произведение двух 3D-векторов: вектор под прямым углом к обоим.

Его направление следует правилу правой руки, а его длина - площадь параллелограмма, натянутого на два вектора. Пример: [1,0,0] x [0,1,0] -> [0,0,1]
Parameters
- inputs: TwoVectorsDto
  Два 3D-вектора
Returns number[]
Вектор, перпендикулярный обоим
Example
```
const normal = bitbybit.vector.cross({ first: [1, 0, 0], second: [0, 1, 0] });
```
- Defined in bitbybit-docs.d.ts:57475

div

div(inputs: VectorScalarDto): number[]
Делит каждую компоненту вектора на одно число.

Пример: [10,20,30] / 2 -> [5,10,15]
Parameters
- inputs: VectorScalarDto
  Вектор и число, на которое делить
Returns number[]
Разделенный вектор
Example
```
const half = bitbybit.vector.div({ vector: [10, 20, 30], scalar: 2 });
```
- Defined in bitbybit-docs.d.ts:57521

domain

domain(inputs: VectorDto): number
Вычитает первое значение вектора из его последнего, что для отсортированного списка есть его размах.

Пример: [1,3,5,9] -> 8
Parameters
- inputs: VectorDto
  Вектор
Returns number
Последнее значение минус первое значение
Example
```
const span = bitbybit.vector.domain({ vector: [1, 3, 5, 9] });
```
- Defined in bitbybit-docs.d.ts:57536

dot

dot(inputs: TwoVectorsDto): number
Вычисляет скалярное произведение двух векторов: сумму произведений соответствующих компонент.

Оно равно 0 для векторов под прямым углом и, для единичных векторов, косинусу угла между ними. Пример: [1,2,3] и [4,5,6] -> 32
Parameters
- inputs: TwoVectorsDto
  Два вектора
Returns number
Скалярное произведение
Example
```
const projection = bitbybit.vector.dot({ first: [1, 2, 3], second: [4, 5, 6] });
```
- Defined in bitbybit-docs.d.ts:57553

mul

mul(inputs: VectorScalarDto): number[]
Умножает каждую компоненту вектора на одно число.

Пример: [2,3,4] x 5 -> [10,15,20]
Parameters
- inputs: VectorScalarDto
  Вектор и число, на которое умножать
Returns number[]
Масштабированный вектор
Example
```
const scaled = bitbybit.vector.mul({ vector: [2, 3, 4], scalar: 5 });
```
- Defined in bitbybit-docs.d.ts:57644

neg

neg(inputs: VectorDto): number[]
Меняет знак каждой компоненты, так что вектор направлен в противоположную сторону.

Пример: [5,-3,2] -> [-5,3,-2]
Parameters
- inputs: VectorDto
  Вектор, который нужно обратить
Returns number[]
Вектор с обратным знаком
Example
```
const opposite = bitbybit.vector.neg({ vector: [5, -3, 2] });
```
- Defined in bitbybit-docs.d.ts:57659

normSquared

normSquared(inputs: VectorDto): number
Вычисляет квадрат длины вектора, что избегает квадратного корня, когда длины только сравниваются.

Пример: [3,4,0] -> 25
Parameters
- inputs: VectorDto
  Вектор
Returns number
Квадрат длины
Example
```
const n2 = bitbybit.vector.normSquared({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57675

norm

norm(inputs: VectorDto): number
Вычисляет длину вектора.

Пример: [3,4,0] -> 5, [1,0,0] -> 1
Parameters
- inputs: VectorDto
  Вектор
Returns number
Длина в единицах модели
Example
```
const len = bitbybit.vector.norm({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57690

normalized

normalized(inputs: VectorDto): number[]
Масштабирует 3D-вектор до длины 1, сохраняя его направление.

У вектора короче 1e-8 нет направления, которое можно сохранить, так что результат undefined. Пример: [3,4,0] -> [0.6,0.8,0]
Parameters
- inputs: VectorDto
  3D-вектор для нормализации
Returns number[]
Единичный вектор или undefined для входа нулевой длины
Example
```
const direction = bitbybit.vector.normalized({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57706

onRay

onRay(inputs: RayPointDto): number[]
Находит точку на заданном расстоянии от начальной точки вдоль направления.

Направление используется как задано, так что направление длиной 2 проходит вдвое большее расстояние. Пример: начало [0,0,0], направление [1,0,0], расстояние 5 -> [5,0,0]
Parameters
- inputs: RayPointDto
  Начальная точка, направление и расстояние
Returns number[]
Точка на луче
Example
```
const ahead = bitbybit.vector.onRay({ point: [0, 0, 0], vector: [1, 0, 0], distance: 5 });
```
- Defined in bitbybit-docs.d.ts:57722

sub

sub(inputs: TwoVectorsDto): number[]
Вычитает второй вектор из первого, покомпонентно.

Пример: [10,20,30] - [1,2,3] -> [9,18,27]
Parameters
- inputs: TwoVectorsDto
  Вектор, из которого вычитать, и вектор, который вычитать
Returns number[]
Вектор разностей
Example
```
const diff = bitbybit.vector.sub({ first: [10, 20, 30], second: [1, 2, 3] });
```
- Defined in bitbybit-docs.d.ts:57849

sum

sum(inputs: VectorDto): number
Складывает все значения вектора в одно число.

Пример: [1,2,3,4] -> 10
Parameters
- inputs: VectorDto
  Вектор, компоненты которого нужно сложить
Returns number
Сумма
Example
```
const total = bitbybit.vector.sum({ vector: [1, 2, 3, 4] });
```
- Defined in bitbybit-docs.d.ts:57864

lengthSq

lengthSq(inputs: Vector3Dto): number
Вычисляет квадрат длины 3D-вектора, что избегает квадратного корня, когда длины только сравниваются.

Пример: [3,4,0] -> 25
Parameters
- inputs: Vector3Dto
  3D-вектор
Returns number
Квадрат длины
Example
```
const l2 = bitbybit.vector.lengthSq({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57880

length

length(inputs: Vector3Dto): number
Вычисляет длину 3D-вектора.

Пример: [3,4,0] -> 5
Parameters
- inputs: Vector3Dto
  3D-вектор
Returns number
Длина в единицах модели
Example
```
const len = bitbybit.vector.length({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57895

create

vectorXYZ

vectorXYZ(inputs: VectorXYZDto): Vector3
Строит 3D-вектор из его значений x, y и z.

Пример: x=1, y=2, z=3 -> [1,2,3]
Parameters
- inputs: VectorXYZDto
  Три значения
Returns Vector3
Вектор [x, y, z]
Example
```
const up = bitbybit.vector.vectorXYZ({ x: 0, y: 1, z: 0 });
```
- Defined in bitbybit-docs.d.ts:57737

vectorXY

vectorXY(inputs: VectorXYDto): Vector2
Строит 2D-вектор из его значений x и y.

Пример: x=3, y=4 -> [3,4]
Parameters
- inputs: VectorXYDto
  Два значения
Returns Vector2
Вектор [x, y]
Example
```
const right = bitbybit.vector.vectorXY({ x: 1, y: 0 });
```
- Defined in bitbybit-docs.d.ts:57752

range

range(inputs: RangeMaxDto): number[]
Перечисляет целые числа от 0 до max, не включая его.

Пример: max=5 -> [0,1,2,3,4]
Parameters
- inputs: RangeMaxDto
  Конец диапазона, который не включается
Returns number[]
Числа от 0 до max - 1
Example
```
const indices = bitbybit.vector.range({ max: 5 });
```
- Defined in bitbybit-docs.d.ts:57767

span

span(inputs: SpanDto): number[]
Перечисляет числа от min до max с шагом step; max включается, когда шаг попадает на него.

Пример: min=0, max=10, step=2 -> [0,2,4,6,8,10]
Parameters
- inputs: SpanDto
  Начало, конец и шаг
Returns number[]
Числа в промежутке
Example
```
const values = bitbybit.vector.span({ min: 0, max: 10, step: 2.5 });
```
- Defined in bitbybit-docs.d.ts:57801

spanEaseItems

spanEaseItems(inputs: SpanEaseItemsDto): number[]
Перечисляет nrItems чисел от min до max, расставленных по кривой сглаживания, так что они сгущаются на одном конце или на обоих.

При включенном intervals результат содержит промежутки между соседями вместо самих значений. Пример: min=0, max=100, nrItems=5, ease='easeInQuad' -> [0, 6.25, 25, 56.25, 100]
Parameters
- inputs: SpanEaseItemsDto
  Начало, конец, число элементов, функция сглаживания и возвращать ли промежутки
Returns number[]
Числа с плавным распределением или промежутки между ними
Example
```
const eased = bitbybit.vector.spanEaseItems({ min: 0, max: 100, nrItems: 5, ease: Bit.Inputs.Math.easeEnum.easeInQuad, intervals: false });
```
- Defined in bitbybit-docs.d.ts:57819

spanLinearItems

spanLinearItems(inputs: SpanLinearItemsDto): number[]
Перечисляет nrItems равномерно расставленных чисел от min до max, включая оба.

Пример: min=0, max=10, nrItems=5 -> [0, 2.5, 5, 7.5, 10]
Parameters
- inputs: SpanLinearItemsDto
  Начало, конец и число элементов
Returns number[]
Равномерно распределенные числа
Example
```
const values = bitbybit.vector.spanLinearItems({ min: 0, max: 10, nrItems: 5 });
```
- Defined in bitbybit-docs.d.ts:57834

parseNumbers

parseNumbers(inputs: VectorStringDto): number[]
Превращает список числовых строк в числа.

Строка, не являющаяся числом, становится NaN. Пример: ['1', '2.5', '3'] -> [1, 2.5, 3]
Parameters
- inputs: VectorStringDto
  Строки для разбора
Returns number[]
Числа
Example
```
const numbers = bitbybit.vector.parseNumbers({ vector: ["1", "2.5", "-3"] });
```
- Defined in bitbybit-docs.d.ts:57911

distance

distSquared

distSquared(inputs: TwoVectorsDto): number
Вычисляет квадрат расстояния между двумя векторами, что избегает квадратного корня, когда расстояния только сравниваются.

Пример: [0,0,0] к [3,4,0] -> 25
Parameters
- inputs: TwoVectorsDto
  Два вектора
Returns number
Квадрат расстояния
Example
```
const d2 = bitbybit.vector.distSquared({ first: [0, 0, 0], second: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57491

dist

dist(inputs: TwoVectorsDto): number
Вычисляет расстояние по прямой между двумя векторами.

Пример: [0,0,0] к [3,4,0] -> 5
Parameters
- inputs: TwoVectorsDto
  Два вектора
Returns number
Расстояние в единицах модели
Example
```
const distance = bitbybit.vector.dist({ first: [0, 0, 0], second: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57506

lerp

lerp(inputs: FractionTwoVectorsDto): number[]
Линейно смешивает два вектора по доле.

fraction - доля first: 1 дает first, 0 дает second, 0.5 - середину. Пример: [0,0,0] и [10,10,10] при 0.5 -> [5,5,5]
Parameters
- inputs: FractionTwoVectorsDto
  Два вектора и доля первого
Returns number[]
Смешанный вектор
Example
```
const mid = bitbybit.vector.lerp({ first: [0, 0, 0], second: [10, 10, 10], fraction: 0.5 });
```
- Defined in bitbybit-docs.d.ts:57599

extract

max

max(inputs: VectorDto): number
Находит наибольшее значение в векторе.

Пример: [3, 7, 2, 9, 1] -> 9
Parameters
- inputs: VectorDto
  Вектор
Returns number
Наибольшая компонента
Example
```
const largest = bitbybit.vector.max({ vector: [3, 7, 2, 9, 1] });
```
- Defined in bitbybit-docs.d.ts:57614

min

min(inputs: VectorDto): number
Находит наименьшее значение в векторе.

Пример: [3, 7, 2, 9, 1] -> 1
Parameters
- inputs: VectorDto
  Вектор
Returns number
Наименьшая компонента
Example
```
const smallest = bitbybit.vector.min({ vector: [3, 7, 2, 9, 1] });
```
- Defined in bitbybit-docs.d.ts:57629

remove

removeAllDuplicateVectors

removeAllDuplicateVectors(inputs: RemoveAllDuplicateVectorsDto): number[][]
Удаляет из списка каждый повторяющийся вектор, сохраняя первое вхождение каждого.

Два вектора считаются одинаковыми, когда каждая компонента отличается меньше чем на tolerance. Пример: [[1,2,3], [4,5,6], [1,2,3], [7,8,9]] -> [[1,2,3], [4,5,6], [7,8,9]]
Parameters
- inputs: RemoveAllDuplicateVectorsDto
  Векторы для фильтрации и допуск
Returns number[][]
Векторы без повторов, в исходном порядке
Example
```
const unique = bitbybit.vector.removeAllDuplicateVectors({
    vectors: [[1, 2, 3], [4, 5, 6], [1, 2, 3]],
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:57324

removeConsecutiveDuplicateVectors

removeConsecutiveDuplicateVectors(
inputs: RemoveConsecutiveDuplicateVectorsDto,
): number[][]
Удаляет вектор, когда он повторяет стоящий прямо перед ним; тот же вектор дальше сохраняется.

При включенном checkFirstAndLast последний вектор, повторяющий первый, тоже отбрасывается, что аккуратно замыкает петлю точек. Компоненты в пределах tolerance друг от друга считаются равными. Пример: [[1,2], [1,2], [3,4], [1,2]] -> [[1,2], [3,4], [1,2]]
Parameters
- inputs: RemoveConsecutiveDuplicateVectorsDto
  Векторы для фильтрации, сравнивать ли первый и последний, и допуск
Returns number[][]
Векторы без подряд идущих повторов
Example
```
const cleaned = bitbybit.vector.removeConsecutiveDuplicateVectors({
    vectors: [[0, 0], [0, 0], [1, 1], [0, 0]],
    checkFirstAndLast: true,
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:57346

sum

addAll

addAll(inputs: VectorsDto): number[]
Складывает список векторов покомпонентно в один вектор.

У результата столько же компонент, сколько у первого вектора. Пример: [[1,2,3], [4,5,6], [7,8,9]] -> [12,15,18]
Parameters
- inputs: VectorsDto
  Векторы для сложения
Returns number[]
Вектор сумм
Example
```
const total = bitbybit.vector.addAll({ vectors: [[1, 2, 3], [4, 5, 6], [7, 8, 9]] });
```
- Defined in bitbybit-docs.d.ts:57428

add

add(inputs: TwoVectorsDto): number[]
Складывает два вектора покомпонентно.

Пример: [1,2,3] + [4,5,6] -> [5,7,9]
Parameters
- inputs: TwoVectorsDto
  Два вектора для сложения
Returns number[]
Вектор сумм
Example
```
const sum = bitbybit.vector.add({ first: [1, 2, 3], second: [4, 5, 6] });
```
- Defined in bitbybit-docs.d.ts:57443

all

all(inputs: VectorBoolDto): boolean
Сообщает, является ли каждое значение в списке булевых значений true.

Пример: [true, true, true] -> true, [true, false, true] -> false
Parameters
- inputs: VectorBoolDto
  Логические значения для проверки
Returns boolean
true, если ни одна компонента не равна false
Example
```
const allTrue = bitbybit.vector.all({ vector: [true, true, false] });
```
- Defined in bitbybit-docs.d.ts:57458

validate

vectorsTheSame

vectorsTheSame(inputs: VectorsTheSameDto): boolean
Сообщает, одинаковы ли два вектора в пределах допуска, компонента за компонентой.

Векторы разной длины никогда не одинаковы. Пример: [1,2,3] и [1.0001,2.0001,3.0001] с допуском 0.001 -> true
Parameters
- inputs: VectorsTheSameDto
  Два вектора и допуск
Returns boolean
true, если каждая компонента отличается меньше чем на допуск
Example
```
const same = bitbybit.vector.vectorsTheSame({ vec1: [1, 2, 3], vec2: [1, 2, 3.0000001], tolerance: 1e-6 });
```
- Defined in bitbybit-docs.d.ts:57362

finite

finite(inputs: VectorDto): boolean[]
Отмечает, какие компоненты вектора являются конечными числами.

Пример: [1, 2, Infinity, 3] -> [true, true, false, true]
Parameters
- inputs: VectorDto
  Вектор для проверки
Returns boolean[]
По одному логическому значению на компоненту, true, если она конечна
Example
```
const flags = bitbybit.vector.finite({ vector: [1, Infinity, 3] });
```
- Defined in bitbybit-docs.d.ts:57568

isZero

isZero(inputs: VectorDto): boolean
Сообщает, имеет ли вектор нулевую длину, то есть каждая компонента ровно 0.

Пример: [0,0,0] -> true, [0,0,0.001] -> false
Parameters
- inputs: VectorDto
  Вектор для проверки
Returns boolean
true, если длина равна 0
Example
```
const zero = bitbybit.vector.isZero({ vector: [0, 0, 0] });
```
- Defined in bitbybit-docs.d.ts:57583

Class Vector

Index

Constructors

angles

base

create

distance

extract

remove

sum

validate

Constructors

constructor

Parameters

Returns Bit.Vector

angles

angleBetween

Parameters

Returns number

Example

angleBetweenNormalized2d

Parameters

Returns number

Example

positiveAngleBetween

Parameters

Returns number

Example

signedAngleBetween

Parameters

Returns number

Example

base

cross

Parameters

Returns number[]

Example

div

Parameters

Returns number[]

Example

domain

Parameters

Returns number

Example

dot

Parameters

Returns number

Example

mul

Parameters

Returns number[]

Example

neg

Parameters

Returns number[]

Example

normSquared

Parameters

Returns number

Example

norm

Parameters

Returns number

Example

normalized

Parameters

Returns number[]

Example

onRay

Parameters

Returns number[]

Example

sub

Parameters

Returns number[]

Example

sum

Parameters

Returns number