Class Vector

Matematika vektor pada array angka biasa. Sebuah vektor adalah array angka; dalam 3D bentuknya [x, y, z] dengan Y mengarah ke atas, sama seperti titik, sehingga keduanya dapat diberikan ke metode satu sama lain. Setiap metode mengembalikan array atau angka baru dan tidak pernah mengubah masukannya. Sudut dalam derajat.

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
Mengukur sudut antara dua vektor dalam derajat, selalu antara 0 dan 180.

Arah putaran tidak diperhitungkan; gunakan signedAngleBetween untuk itu. Contoh: [1,0,0] dan [0,1,0] -> 90
Parameters
- inputs: TwoVectorsDto
  Kedua vektor
Returns number
Sudut dalam derajat
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
Mengukur sudut bertanda dari vektor 2D pertama ke yang kedua, dalam derajat dari -180 sampai 180.

Hanya dua entri pertama setiap vektor yang dipakai; sudut positif berputar berlawanan arah jarum jam. Contoh: [1,0] ke [0,1] -> 90, [0,1] ke [1,0] -> -90
Parameters
- inputs: TwoVectorsDto
  Kedua vektor 2D
Returns number
Sudut bertanda dalam derajat
Example
```
const angle = bitbybit.vector.angleBetweenNormalized2d({ first: [1, 0], second: [0, 1] });
```
- Defined in bitbybit-docs.d.ts:57395

positiveAngleBetween

positiveAngleBetween(inputs: TwoVectorsReferenceDto): number
Mengukur sudut dari vektor pertama ke yang kedua, berputar mengelilingi arah acuan, dalam derajat dari 0 sampai 360.

Putarannya berlawanan arah jarum jam jika vektor acuan mengarah ke Anda. Contoh: [1,0,0] ke [0,0,-1] mengelilingi [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Kedua vektor dan arah acuan untuk berputar
Returns number
Sudut dalam derajat dari 0 sampai 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
Mengukur sudut dari vektor pertama ke yang kedua, berputar mengelilingi arah acuan, dalam derajat dari 0 sampai 360.

Putarannya berlawanan arah jarum jam jika vektor acuan mengarah ke Anda: putaran searah jarum jam sebesar 30 derajat terbaca sebagai 330. Contoh: [1,0,0] ke [0,0,-1] mengelilingi [0,1,0] -> 90
Parameters
- inputs: TwoVectorsReferenceDto
  Kedua vektor dan arah acuan untuk berputar
Returns number
Sudut dalam derajat dari 0 sampai 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[]
Menghitung hasil kali silang dua vektor 3D: vektor yang tegak lurus terhadap keduanya.

Arahnya mengikuti aturan tangan kanan dan panjangnya adalah luas jajar genjang yang direntangkan kedua vektor. Contoh: [1,0,0] x [0,1,0] -> [0,0,1]
Parameters
- inputs: TwoVectorsDto
  Kedua vektor 3D
Returns number[]
Vektor yang tegak lurus terhadap keduanya
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[]
Membagi setiap entri vektor dengan satu angka.

Contoh: [10,20,30] / 2 -> [5,10,15]
Parameters
- inputs: VectorScalarDto
  Vektor dan angka pembaginya
Returns number[]
Vektor hasil pembagian
Example
```
const half = bitbybit.vector.div({ vector: [10, 20, 30], scalar: 2 });
```
- Defined in bitbybit-docs.d.ts:57521

domain

domain(inputs: VectorDto): number
Mengurangkan nilai pertama vektor dari nilai terakhirnya, yang untuk daftar terurut adalah rentangnya.

Contoh: [1,3,5,9] -> 8
Parameters
- inputs: VectorDto
  Vektor
Returns number
Nilai terakhir dikurangi nilai pertama
Example
```
const span = bitbybit.vector.domain({ vector: [1, 3, 5, 9] });
```
- Defined in bitbybit-docs.d.ts:57536

dot

dot(inputs: TwoVectorsDto): number
Menghitung hasil kali titik dua vektor: jumlah hasil kali entri-entri yang bersesuaian.

Nilainya 0 untuk vektor yang tegak lurus dan, untuk vektor satuan, kosinus sudut di antara keduanya. Contoh: [1,2,3] dan [4,5,6] -> 32
Parameters
- inputs: TwoVectorsDto
  Kedua vektor
Returns number
Hasil kali titik
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[]
Mengalikan setiap entri vektor dengan satu angka.

Contoh: [2,3,4] x 5 -> [10,15,20]
Parameters
- inputs: VectorScalarDto
  Vektor dan angka pengalinya
Returns number[]
Vektor yang diskalakan
Example
```
const scaled = bitbybit.vector.mul({ vector: [2, 3, 4], scalar: 5 });
```
- Defined in bitbybit-docs.d.ts:57644

neg

neg(inputs: VectorDto): number[]
Membalik tanda setiap entri, sehingga vektor mengarah ke arah sebaliknya.

Contoh: [5,-3,2] -> [-5,3,-2]
Parameters
- inputs: VectorDto
  Vektor yang akan dibalik
Returns number[]
Vektor yang dinegasikan
Example
```
const opposite = bitbybit.vector.neg({ vector: [5, -3, 2] });
```
- Defined in bitbybit-docs.d.ts:57659

normSquared

normSquared(inputs: VectorDto): number
Menghitung kuadrat panjang vektor, yang menghindari akar kuadrat jika hanya membandingkan panjang.

Contoh: [3,4,0] -> 25
Parameters
- inputs: VectorDto
  Vektor
Returns number
Panjang kuadrat
Example
```
const n2 = bitbybit.vector.normSquared({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57675

norm

norm(inputs: VectorDto): number
Menghitung panjang vektor.

Contoh: [3,4,0] -> 5, [1,0,0] -> 1
Parameters
- inputs: VectorDto
  Vektor
Returns number
Panjang dalam satuan model
Example
```
const len = bitbybit.vector.norm({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57690

normalized

normalized(inputs: VectorDto): number[]
Menskalakan vektor 3D ke panjang 1 sambil mempertahankan arahnya.

Vektor yang lebih pendek dari 1e-8 tidak memiliki arah yang dapat dipertahankan, sehingga hasilnya undefined. Contoh: [3,4,0] -> [0.6,0.8,0]
Parameters
- inputs: VectorDto
  Vektor 3D yang akan dinormalisasi
Returns number[]
Vektor satuan, atau undefined untuk masukan berpanjang nol
Example
```
const direction = bitbybit.vector.normalized({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57706

onRay

onRay(inputs: RayPointDto): number[]
Menemukan titik pada jarak tertentu dari titik awal sepanjang sebuah arah.

Arah dipakai apa adanya, sehingga arah dengan panjang 2 menempuh dua kali jarak. Contoh: awal [0,0,0], arah [1,0,0], jarak 5 -> [5,0,0]
Parameters
- inputs: RayPointDto
  Titik awal, arah dan jarak
Returns number[]
Titik pada sinar
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[]
Mengurangkan vektor kedua dari yang pertama, entri demi entri.

Contoh: [10,20,30] - [1,2,3] -> [9,18,27]
Parameters
- inputs: TwoVectorsDto
  Vektor yang dikurangi dan vektor pengurangnya
Returns number[]
Vektor hasil pengurangan
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
Menjumlahkan semua nilai vektor menjadi satu angka.

Contoh: [1,2,3,4] -> 10
Parameters
- inputs: VectorDto
  Vektor yang akan dijumlahkan
Returns number
Total
Example
```
const total = bitbybit.vector.sum({ vector: [1, 2, 3, 4] });
```
- Defined in bitbybit-docs.d.ts:57864

lengthSq

lengthSq(inputs: Vector3Dto): number
Menghitung kuadrat panjang vektor 3D, yang menghindari akar kuadrat jika hanya membandingkan panjang.

Contoh: [3,4,0] -> 25
Parameters
- inputs: Vector3Dto
  Vektor 3D
Returns number
Panjang kuadrat
Example
```
const l2 = bitbybit.vector.lengthSq({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57880

length

length(inputs: Vector3Dto): number
Menghitung panjang vektor 3D.

Contoh: [3,4,0] -> 5
Parameters
- inputs: Vector3Dto
  Vektor 3D
Returns number
Panjang dalam satuan model
Example
```
const len = bitbybit.vector.length({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57895

create

vectorXYZ

vectorXYZ(inputs: VectorXYZDto): Vector3
Membangun vektor 3D dari nilai x, y dan z-nya.

Contoh: x=1, y=2, z=3 -> [1,2,3]
Parameters
- inputs: VectorXYZDto
  Ketiga nilai
Returns Vector3
Vektor [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
Membangun vektor 2D dari nilai x dan y-nya.

Contoh: x=3, y=4 -> [3,4]
Parameters
- inputs: VectorXYDto
  Kedua nilai
Returns Vector2
Vektor [x, y]
Example
```
const right = bitbybit.vector.vectorXY({ x: 1, y: 0 });
```
- Defined in bitbybit-docs.d.ts:57752

range

range(inputs: RangeMaxDto): number[]
Mencantumkan bilangan bulat dari 0 sampai, tetapi tidak termasuk, max.

Contoh: max=5 -> [0,1,2,3,4]
Parameters
- inputs: RangeMaxDto
  Akhir rentang, yang tidak disertakan
Returns number[]
Angka-angka dari 0 sampai max - 1
Example
```
const indices = bitbybit.vector.range({ max: 5 });
```
- Defined in bitbybit-docs.d.ts:57767

span

span(inputs: SpanDto): number[]
Mencantumkan angka-angka dari min sampai max, melangkah sebesar step; max disertakan jika suatu langkah tepat mendarat padanya.

Contoh: min=0, max=10, step=2 -> [0,2,4,6,8,10]
Parameters
- inputs: SpanDto
  Awal, akhir dan langkah
Returns number[]
Angka-angka dalam rentang
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[]
Mencantumkan nrItems angka dari min sampai max yang dijarakkan oleh kurva easing, sehingga mengumpul di satu ujung atau keduanya.

Dengan intervals aktif, hasilnya berisi celah antar tetangga, bukan nilai-nilainya sendiri. Contoh: min=0, max=100, nrItems=5, ease='easeInQuad' -> [0, 6.25, 25, 56.25, 100]
Parameters
- inputs: SpanEaseItemsDto
  Awal, akhir, jumlah item, easing dan apakah celahnya yang dikembalikan
Returns number[]
Angka-angka yang di-easing, atau celah di antaranya
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[]
Mencantumkan nrItems angka berjarak sama dari min sampai max, keduanya disertakan.

Contoh: min=0, max=10, nrItems=5 -> [0, 2.5, 5, 7.5, 10]
Parameters
- inputs: SpanLinearItemsDto
  Awal, akhir dan jumlah item
Returns number[]
Angka-angka dengan jarak seragam
Example
```
const values = bitbybit.vector.spanLinearItems({ min: 0, max: 10, nrItems: 5 });
```
- Defined in bitbybit-docs.d.ts:57834

parseNumbers

parseNumbers(inputs: VectorStringDto): number[]
Mengubah daftar string angka menjadi angka.

String yang bukan angka menjadi NaN. Contoh: ['1', '2.5', '3'] -> [1, 2.5, 3]
Parameters
- inputs: VectorStringDto
  String yang akan diurai
Returns number[]
Angka-angkanya
Example
```
const numbers = bitbybit.vector.parseNumbers({ vector: ["1", "2.5", "-3"] });
```
- Defined in bitbybit-docs.d.ts:57911

distance

distSquared

distSquared(inputs: TwoVectorsDto): number
Menghitung kuadrat jarak antara dua vektor, yang menghindari akar kuadrat jika hanya membandingkan jarak.

Contoh: [0,0,0] ke [3,4,0] -> 25
Parameters
- inputs: TwoVectorsDto
  Kedua vektor
Returns number
Jarak kuadrat
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
Menghitung jarak garis lurus antara dua vektor.

Contoh: [0,0,0] ke [3,4,0] -> 5
Parameters
- inputs: TwoVectorsDto
  Kedua vektor
Returns number
Jarak dalam satuan model
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[]
Memadukan dua vektor secara linear berdasarkan pecahan.

fraction adalah bagian dari first: 1 menghasilkan first, 0 menghasilkan second, 0.5 titik tengah. Contoh: [0,0,0] dan [10,10,10] pada 0.5 -> [5,5,5]
Parameters
- inputs: FractionTwoVectorsDto
  Kedua vektor dan fraksi dari vektor pertama
Returns number[]
Vektor hasil pencampuran
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
Menemukan nilai terbesar dalam vektor.

Contoh: [3, 7, 2, 9, 1] -> 9
Parameters
- inputs: VectorDto
  Vektor
Returns number
Entri terbesar
Example
```
const largest = bitbybit.vector.max({ vector: [3, 7, 2, 9, 1] });
```
- Defined in bitbybit-docs.d.ts:57614

min

min(inputs: VectorDto): number
Menemukan nilai terkecil dalam vektor.

Contoh: [3, 7, 2, 9, 1] -> 1
Parameters
- inputs: VectorDto
  Vektor
Returns number
Entri terkecil
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[][]
Menghapus setiap vektor yang berulang dari daftar, mempertahankan kemunculan pertama masing-masing.

Dua vektor dihitung sama jika setiap entrinya berbeda kurang dari tolerance. Contoh: [[1,2,3], [4,5,6], [1,2,3], [7,8,9]] -> [[1,2,3], [4,5,6], [7,8,9]]
Parameters
- inputs: RemoveAllDuplicateVectorsDto
  Vektor yang akan disaring dan toleransi
Returns number[][]
Vektor-vektor tanpa pengulangan, dalam urutan aslinya
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[][]
Menghapus vektor jika mengulang vektor tepat sebelumnya; vektor yang sama di tempat yang lebih jauh dipertahankan.

Dengan checkFirstAndLast aktif, vektor terakhir yang mengulang yang pertama juga dibuang, yang menutup loop titik dengan rapi. Entri yang berjarak dalam tolerance satu sama lain dihitung sama. Contoh: [[1,2], [1,2], [3,4], [1,2]] -> [[1,2], [3,4], [1,2]]
Parameters
- inputs: RemoveConsecutiveDuplicateVectorsDto
  Vektor yang akan disaring, apakah yang pertama dan terakhir dibandingkan, dan toleransi
Returns number[][]
Vektor-vektor tanpa pengulangan berurutan
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[]
Menjumlahkan daftar vektor entri demi entri menjadi satu vektor.

Hasilnya memiliki entri sebanyak vektor pertama. Contoh: [[1,2,3], [4,5,6], [7,8,9]] -> [12,15,18]
Parameters
- inputs: VectorsDto
  Vektor yang akan dijumlahkan
Returns number[]
Vektor hasil penjumlahan
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[]
Menjumlahkan dua vektor entri demi entri.

Contoh: [1,2,3] + [4,5,6] -> [5,7,9]
Parameters
- inputs: TwoVectorsDto
  Kedua vektor yang akan dijumlahkan
Returns number[]
Vektor hasil penjumlahan
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
Memberi tahu apakah setiap nilai dalam daftar boolean bernilai true.

Contoh: [true, true, true] -> true, [true, false, true] -> false
Parameters
- inputs: VectorBoolDto
  Nilai-nilai boolean yang akan diperiksa
Returns boolean
True jika tidak ada entri yang false
Example
```
const allTrue = bitbybit.vector.all({ vector: [true, true, false] });
```
- Defined in bitbybit-docs.d.ts:57458

validate

vectorsTheSame

vectorsTheSame(inputs: VectorsTheSameDto): boolean
Memberi tahu apakah dua vektor sama dalam batas toleransi, entri demi entri.

Vektor dengan panjang berbeda tidak pernah sama. Contoh: [1,2,3] dan [1.0001,2.0001,3.0001] dengan toleransi 0.001 -> true
Parameters
- inputs: VectorsTheSameDto
  Kedua vektor dan toleransi
Returns boolean
True jika setiap entri berbeda kurang dari toleransi
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[]
Menandai entri-entri vektor mana yang merupakan bilangan berhingga.

Contoh: [1, 2, Infinity, 3] -> [true, true, false, true]
Parameters
- inputs: VectorDto
  Vektor yang akan diperiksa
Returns boolean[]
Satu boolean per entri, true jika entri tersebut berhingga
Example
```
const flags = bitbybit.vector.finite({ vector: [1, Infinity, 3] });
```
- Defined in bitbybit-docs.d.ts:57568

isZero

isZero(inputs: VectorDto): boolean
Memberi tahu apakah sebuah vektor tidak memiliki panjang, yaitu setiap entrinya persis 0.

Contoh: [0,0,0] -> true, [0,0,0.001] -> false
Parameters
- inputs: VectorDto
  Vektor yang akan diperiksa
Returns boolean
True jika panjangnya 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