Class Vector

Calcul vectoriel sur de simples tableaux de nombres. Un vecteur est un tableau de nombres ; en 3D c'est [x, y, z] avec Y pointant vers le haut, la même forme qu'un point, de sorte que les deux peuvent être passés aux méthodes l'un de l'autre. Chaque méthode renvoie un nouveau tableau ou un nombre et ne modifie jamais ses entrées. Les angles sont en degrés.

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
Mesure l'angle entre deux vecteurs en degrés, toujours entre 0 et 180.

Le sens de rotation n'est pas pris en compte ; utilisez signedAngleBetween pour cela. Exemple : [1,0,0] et [0,1,0] -> 90
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs
Returns number
L'angle en degrés
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
Mesure l'angle signé du premier vecteur 2D au second, en degrés de -180 à 180.

Seules les deux premières composantes de chaque vecteur sont utilisées ; un angle positif tourne dans le sens antihoraire. Exemple : [1,0] vers [0,1] -> 90, [0,1] vers [1,0] -> -90
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs 2D
Returns number
L'angle signé en degrés
Example
```
const angle = bitbybit.vector.angleBetweenNormalized2d({ first: [1, 0], second: [0, 1] });
```
- Defined in bitbybit-docs.d.ts:57395

positiveAngleBetween

positiveAngleBetween(inputs: TwoVectorsReferenceDto): number
Mesure l'angle du premier vecteur au second, en tournant autour d'une direction de référence, en degrés de 0 à 360.

La rotation est dans le sens antihoraire quand le vecteur de référence pointe vers vous. Exemple : [1,0,0] vers [0,0,-1] autour de [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Les deux vecteurs et la direction de référence autour de laquelle tourner
Returns number
L'angle en degrés de 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
Mesure l'angle du premier vecteur au second, en tournant autour d'une direction de référence, en degrés de 0 à 360.

La rotation est dans le sens antihoraire quand le vecteur de référence pointe vers vous : une rotation horaire de 30 degrés se lit 330. Exemple : [1,0,0] vers [0,0,-1] autour de [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Les deux vecteurs et la direction de référence autour de laquelle tourner
Returns number
L'angle en degrés de 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[]
Calcule le produit vectoriel de deux vecteurs 3D : un vecteur perpendiculaire aux deux.

Sa direction suit la règle de la main droite et sa longueur est l'aire du parallélogramme que les deux vecteurs délimitent. Exemple : [1,0,0] x [0,1,0] -> [0,0,1]
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs 3D
Returns number[]
Le vecteur perpendiculaire aux deux
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[]
Divise chaque composante d'un vecteur par un nombre.

Exemple : [10,20,30] / 2 -> [5,10,15]
Parameters
- inputs: VectorScalarDto
  Le vecteur et le nombre par lequel diviser
Returns number[]
Le vecteur divisé
Example
```
const half = bitbybit.vector.div({ vector: [10, 20, 30], scalar: 2 });
```
- Defined in bitbybit-docs.d.ts:57521

domain

domain(inputs: VectorDto): number
Soustrait la première valeur d'un vecteur de sa dernière, ce qui pour une liste triée est son étendue.

Exemple : [1,3,5,9] -> 8
Parameters
- inputs: VectorDto
  Le vecteur
Returns number
La dernière valeur moins la première valeur
Example
```
const span = bitbybit.vector.domain({ vector: [1, 3, 5, 9] });
```
- Defined in bitbybit-docs.d.ts:57536

dot

dot(inputs: TwoVectorsDto): number
Calcule le produit scalaire de deux vecteurs : la somme des produits des composantes correspondantes.

Il vaut 0 pour des vecteurs perpendiculaires et, pour des vecteurs unitaires, le cosinus de l'angle entre eux. Exemple : [1,2,3] et [4,5,6] -> 32
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs
Returns number
Le produit scalaire
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[]
Multiplie chaque composante d'un vecteur par un nombre.

Exemple : [2,3,4] x 5 -> [10,15,20]
Parameters
- inputs: VectorScalarDto
  Le vecteur et le nombre par lequel multiplier
Returns number[]
Le vecteur mis à l'échelle
Example
```
const scaled = bitbybit.vector.mul({ vector: [2, 3, 4], scalar: 5 });
```
- Defined in bitbybit-docs.d.ts:57644

neg

neg(inputs: VectorDto): number[]
Inverse le signe de chaque composante, de sorte que le vecteur pointe dans le sens opposé.

Exemple : [5,-3,2] -> [-5,3,-2]
Parameters
- inputs: VectorDto
  Le vecteur à inverser
Returns number[]
Le vecteur opposé
Example
```
const opposite = bitbybit.vector.neg({ vector: [5, -3, 2] });
```
- Defined in bitbybit-docs.d.ts:57659

normSquared

normSquared(inputs: VectorDto): number
Calcule le carré de la longueur d'un vecteur, ce qui évite la racine carrée quand on ne fait que comparer des longueurs.

Exemple : [3,4,0] -> 25
Parameters
- inputs: VectorDto
  Le vecteur
Returns number
La longueur au carré
Example
```
const n2 = bitbybit.vector.normSquared({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57675

norm

norm(inputs: VectorDto): number
Calcule la longueur d'un vecteur.

Exemple : [3,4,0] -> 5, [1,0,0] -> 1
Parameters
- inputs: VectorDto
  Le vecteur
Returns number
La longueur en unités du modèle
Example
```
const len = bitbybit.vector.norm({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57690

normalized

normalized(inputs: VectorDto): number[]
Met un vecteur 3D à la longueur 1 en gardant sa direction.

Un vecteur plus court que 1e-8 n'a pas de direction à garder, le résultat est donc undefined. Exemple : [3,4,0] -> [0.6,0.8,0]
Parameters
- inputs: VectorDto
  Le vecteur 3D à normaliser
Returns number[]
Le vecteur unitaire, ou undefined pour une entrée de longueur nulle
Example
```
const direction = bitbybit.vector.normalized({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57706

onRay

onRay(inputs: RayPointDto): number[]
Trouve le point à une distance donnée d'un point de départ le long d'une direction.

La direction est utilisée telle quelle, une direction de longueur 2 parcourt donc deux fois la distance. Exemple : départ [0,0,0], direction [1,0,0], distance 5 -> [5,0,0]
Parameters
- inputs: RayPointDto
  Le point de départ, la direction et la distance
Returns number[]
Le point sur le rayon
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[]
Soustrait le second vecteur du premier, composante par composante.

Exemple : [10,20,30] - [1,2,3] -> [9,18,27]
Parameters
- inputs: TwoVectorsDto
  Le vecteur duquel soustraire et le vecteur à soustraire
Returns number[]
Le vecteur des différences
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
Additionne toutes les valeurs d'un vecteur en un seul nombre.

Exemple : [1,2,3,4] -> 10
Parameters
- inputs: VectorDto
  Le vecteur à additionner
Returns number
Le total
Example
```
const total = bitbybit.vector.sum({ vector: [1, 2, 3, 4] });
```
- Defined in bitbybit-docs.d.ts:57864

lengthSq

lengthSq(inputs: Vector3Dto): number
Calcule le carré de la longueur d'un vecteur 3D, ce qui évite la racine carrée quand on ne fait que comparer des longueurs.

Exemple : [3,4,0] -> 25
Parameters
- inputs: Vector3Dto
  Le vecteur 3D
Returns number
La longueur au carré
Example
```
const l2 = bitbybit.vector.lengthSq({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57880

length

length(inputs: Vector3Dto): number
Calcule la longueur d'un vecteur 3D.

Exemple : [3,4,0] -> 5
Parameters
- inputs: Vector3Dto
  Le vecteur 3D
Returns number
La longueur en unités du modèle
Example
```
const len = bitbybit.vector.length({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57895

create

vectorXYZ

vectorXYZ(inputs: VectorXYZDto): Vector3
Construit un vecteur 3D à partir de ses valeurs x, y et z.

Exemple : x=1, y=2, z=3 -> [1,2,3]
Parameters
- inputs: VectorXYZDto
  Les trois valeurs
Returns Vector3
Le vecteur [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
Construit un vecteur 2D à partir de ses valeurs x et y.

Exemple : x=3, y=4 -> [3,4]
Parameters
- inputs: VectorXYDto
  Les deux valeurs
Returns Vector2
Le vecteur [x, y]
Example
```
const right = bitbybit.vector.vectorXY({ x: 1, y: 0 });
```
- Defined in bitbybit-docs.d.ts:57752

range

range(inputs: RangeMaxDto): number[]
Liste les nombres entiers de 0 jusqu'à max, non compris.

Exemple : max=5 -> [0,1,2,3,4]
Parameters
- inputs: RangeMaxDto
  La fin de la plage, qui est exclue
Returns number[]
Les nombres de 0 à max - 1
Example
```
const indices = bitbybit.vector.range({ max: 5 });
```
- Defined in bitbybit-docs.d.ts:57767

span

span(inputs: SpanDto): number[]
Liste les nombres de min à max, par pas de step ; max est inclus quand un pas tombe dessus.

Exemple : min=0, max=10, step=2 -> [0,2,4,6,8,10]
Parameters
- inputs: SpanDto
  Le début, la fin et le pas
Returns number[]
Les nombres de l'intervalle
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[]
Liste nrItems nombres de min à max espacés selon une courbe d'accélération, de sorte qu'ils se resserrent à une extrémité ou aux deux.

Avec intervals actif, le résultat contient les écarts entre voisins au lieu des valeurs elles-mêmes. Exemple : min=0, max=100, nrItems=5, ease='easeInQuad' -> [0, 6.25, 25, 56.25, 100]
Parameters
- inputs: SpanEaseItemsDto
  Le début, la fin, le nombre d'éléments, la fonction d'accélération et s'il faut renvoyer les écarts
Returns number[]
Les nombres avec accélération, ou les écarts entre eux
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[]
Liste nrItems nombres régulièrement espacés de min à max, tous deux inclus.

Exemple : min=0, max=10, nrItems=5 -> [0, 2.5, 5, 7.5, 10]
Parameters
- inputs: SpanLinearItemsDto
  Le début, la fin et le nombre d'éléments
Returns number[]
Les nombres régulièrement espacés
Example
```
const values = bitbybit.vector.spanLinearItems({ min: 0, max: 10, nrItems: 5 });
```
- Defined in bitbybit-docs.d.ts:57834

parseNumbers

parseNumbers(inputs: VectorStringDto): number[]
Transforme une liste de chaînes de nombres en nombres.

Une chaîne qui n'est pas un nombre devient NaN. Exemple : ['1', '2.5', '3'] -> [1, 2.5, 3]
Parameters
- inputs: VectorStringDto
  Les chaînes à analyser
Returns number[]
Les nombres
Example
```
const numbers = bitbybit.vector.parseNumbers({ vector: ["1", "2.5", "-3"] });
```
- Defined in bitbybit-docs.d.ts:57911

distance

distSquared

distSquared(inputs: TwoVectorsDto): number
Calcule le carré de la distance entre deux vecteurs, ce qui évite la racine carrée quand on ne fait que comparer des distances.

Exemple : [0,0,0] vers [3,4,0] -> 25
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs
Returns number
La distance au carré
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
Calcule la distance en ligne droite entre deux vecteurs.

Exemple : [0,0,0] vers [3,4,0] -> 5
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs
Returns number
La distance en unités du modèle
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[]
Mélange deux vecteurs linéairement selon une fraction.

fraction est la part de first : 1 donne first, 0 donne second, 0.5 le point milieu. Exemple : [0,0,0] et [10,10,10] à 0.5 -> [5,5,5]
Parameters
- inputs: FractionTwoVectorsDto
  Les deux vecteurs et la fraction du premier
Returns number[]
Le vecteur interpolé
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
Trouve la plus grande valeur d'un vecteur.

Exemple : [3, 7, 2, 9, 1] -> 9
Parameters
- inputs: VectorDto
  Le vecteur
Returns number
La plus grande composante
Example
```
const largest = bitbybit.vector.max({ vector: [3, 7, 2, 9, 1] });
```
- Defined in bitbybit-docs.d.ts:57614

min

min(inputs: VectorDto): number
Trouve la plus petite valeur d'un vecteur.

Exemple : [3, 7, 2, 9, 1] -> 1
Parameters
- inputs: VectorDto
  Le vecteur
Returns number
La plus petite composante
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[][]
Supprime chaque vecteur répété d'une liste, en gardant la première occurrence de chacun.

Deux vecteurs comptent comme identiques quand chaque composante diffère de moins que tolerance. Exemple : [[1,2,3], [4,5,6], [1,2,3], [7,8,9]] -> [[1,2,3], [4,5,6], [7,8,9]]
Parameters
- inputs: RemoveAllDuplicateVectorsDto
  Les vecteurs à filtrer et la tolérance
Returns number[][]
Les vecteurs sans répétitions, dans leur ordre d'origine
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[][]
Supprime un vecteur quand il répète celui juste avant lui ; le même vecteur plus loin est conservé.

Avec checkFirstAndLast actif, un dernier vecteur qui répète le premier est aussi supprimé, ce qui ferme proprement une boucle de points. Des composantes à moins de tolerance l'une de l'autre comptent comme égales. Exemple : [[1,2], [1,2], [3,4], [1,2]] -> [[1,2], [3,4], [1,2]]
Parameters
- inputs: RemoveConsecutiveDuplicateVectorsDto
  Les vecteurs à filtrer, s'il faut comparer le premier et le dernier, et la tolérance
Returns number[][]
Les vecteurs sans répétitions consécutives
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[]
Additionne une liste de vecteurs composante par composante en un seul vecteur.

Le résultat a autant de composantes que le premier vecteur. Exemple : [[1,2,3], [4,5,6], [7,8,9]] -> [12,15,18]
Parameters
- inputs: VectorsDto
  Les vecteurs à additionner
Returns number[]
Le vecteur des sommes
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[]
Additionne deux vecteurs composante par composante.

Exemple : [1,2,3] + [4,5,6] -> [5,7,9]
Parameters
- inputs: TwoVectorsDto
  Les deux vecteurs à additionner
Returns number[]
Le vecteur des sommes
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
Indique si chaque valeur d'une liste de booléens est vraie.

Exemple : [true, true, true] -> true, [true, false, true] -> false
Parameters
- inputs: VectorBoolDto
  Les booléens à vérifier
Returns boolean
Vrai quand aucune entrée n'est fausse
Example
```
const allTrue = bitbybit.vector.all({ vector: [true, true, false] });
```
- Defined in bitbybit-docs.d.ts:57458

validate

vectorsTheSame

vectorsTheSame(inputs: VectorsTheSameDto): boolean
Indique si deux vecteurs sont identiques à une tolérance près, composante par composante.

Des vecteurs de longueurs différentes ne sont jamais identiques. Exemple : [1,2,3] et [1.0001,2.0001,3.0001] avec une tolérance de 0.001 -> true
Parameters
- inputs: VectorsTheSameDto
  Les deux vecteurs et la tolérance
Returns boolean
Vrai quand chaque composante diffère de moins que la tolérance
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[]
Marque quelles composantes d'un vecteur sont des nombres finis.

Exemple : [1, 2, Infinity, 3] -> [true, true, false, true]
Parameters
- inputs: VectorDto
  Le vecteur à vérifier
Returns boolean[]
Un booléen par composante, vrai quand elle est finie
Example
```
const flags = bitbybit.vector.finite({ vector: [1, Infinity, 3] });
```
- Defined in bitbybit-docs.d.ts:57568

isZero

isZero(inputs: VectorDto): boolean
Indique si un vecteur n'a pas de longueur, c'est-à-dire que chaque composante vaut exactement 0.

Exemple : [0,0,0] -> true, [0,0,0.001] -> false
Parameters
- inputs: VectorDto
  Le vecteur à vérifier
Returns boolean
Vrai quand la longueur est 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