Class Vector

رياضيات المتجهات على مصفوفات أرقام بسيطة. المتجه مصفوفة من الأرقام؛ وفي الفضاء ثلاثي الأبعاد هو [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
يقيس الزاوية ذات الإشارة من المتجه ثنائي الأبعاد الأول إلى الثاني، بالدرجات من -180 إلى 180.

يُستخدم أول مدخلين فقط من كل متجه؛ الزاوية الموجبة تدور عكس اتجاه عقارب الساعة. مثال: [1,0] إلى [0,1] -> 90، [0,1] إلى [1,0] -> -90
Parameters
- inputs: TwoVectorsDto
  المتجهان ثنائيا الأبعاد
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[]
يحسب الضرب الاتجاهي لمتجهين ثلاثيي الأبعاد: متجه عمودي على كليهما.

يتبع اتجاهه قاعدة اليد اليمنى وطوله هو مساحة متوازي الأضلاع الذي يمتد عليه المتجهان. مثال: [1,0,0] x [0,1,0] -> [0,0,1]
Parameters
- inputs: TwoVectorsDto
  المتجهان ثلاثيا الأبعاد
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[]
يحجّم متجهاً ثلاثي الأبعاد إلى الطول 1 مع الحفاظ على اتجاهه.

المتجه الأقصر من 1e-8 ليس له اتجاه يُحافظ عليه، لذا يكون الناتج undefined. مثال: [3,4,0] -> [0.6,0.8,0]
Parameters
- inputs: VectorDto
  المتجه ثلاثي الأبعاد المراد تطبيعه
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
يحسب مربع طول متجه ثلاثي الأبعاد، وهو ما يتجنب الجذر التربيعي عند الاكتفاء بمقارنة الأطوال.

مثال: [3,4,0] -> 25
Parameters
- inputs: Vector3Dto
  المتجه ثلاثي الأبعاد
Returns number
مربع الطول
Example
```
const l2 = bitbybit.vector.lengthSq({ vector: [3, 4, 0] });
```
- Defined in bitbybit-docs.d.ts:57880

length

length(inputs: Vector3Dto): number
يحسب طول متجه ثلاثي الأبعاد.

مثال: [3,4,0] -> 5
Parameters
- inputs: Vector3Dto
  المتجه ثلاثي الأبعاد
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
يبني متجهاً ثلاثي الأبعاد من قيمه 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
يبني متجهاً ثنائي الأبعاد من قيمتيه 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