Class MathBitByBit

الحساب والتقريب والنطاقات والأرقام العشوائية والدوال المثلثية على الأرقام البسيطة. تأخذ الدوال المثلثية الزوايا بالراديان وتعطيها به؛ ويحول degToRad و radToDeg عند الحدود، لأن كل زاوية تقريبا يكتبها المستخدم بالدرجات. مساعدات الاستيفاء (lerp و remap و ease و smoothstep و pingPong) هي اللبنات الأساسية للحركة والتنويع البارامتري.

Index

Constructors

constructor

new MathBitByBit(): MathBitByBit
Returns MathBitByBit

basics

add

add(inputs: TwoNumbersDto): number
يجمع رقمين.

مثال: 5 و 3 -> 8، -2 و 7 -> 5
Parameters
- inputs: TwoNumbersDto
  الرقمان
Returns number
مجموعهما
Example
```
const sum = bitbybit.math.add({ first: 5, second: 3 });
```
- Defined in bitbybit-docs.d.ts:55136

subtract

subtract(inputs: TwoNumbersDto): number
يطرح الرقم الثاني من الأول.

مثال: 10 و 3 -> 7، 5 و 8 -> -3
Parameters
- inputs: TwoNumbersDto
  الرقم المراد الطرح منه والرقم المراد طرحه
Returns number
الفرق بينهما
Example
```
const difference = bitbybit.math.subtract({ first: 10, second: 3 });
```
- Defined in bitbybit-docs.d.ts:55151

multiply

multiply(inputs: TwoNumbersDto): number
يضرب رقمين.

مثال: 5 و 3 -> 15، -2 و 4 -> -8
Parameters
- inputs: TwoNumbersDto
  الرقمان
Returns number
حاصل ضربهما
Example
```
const product = bitbybit.math.multiply({ first: 5, second: 3 });
```
- Defined in bitbybit-docs.d.ts:55166

divide

divide(inputs: TwoNumbersDto): number
يقسم الرقم الأول على الثاني.

القسمة على 0 تعطي Infinity، كما في JavaScript. مثال: 10 و 2 -> 5، 7 و 2 -> 3.5
Parameters
- inputs: TwoNumbersDto
  الرقم المراد قسمته والرقم المراد القسمة عليه
Returns number
حاصل قسمتهما
Example
```
const quotient = bitbybit.math.divide({ first: 7, second: 2 });
```
- Defined in bitbybit-docs.d.ts:55182

power

power(inputs: TwoNumbersDto): number
يرفع الرقم الأول إلى قوة الثاني.

مثال: 2 قوة 3 -> 8، 5 قوة 2 -> 25، 10 قوة -1 -> 0.1
Parameters
- inputs: TwoNumbersDto
  الأساس والأس
Returns number
القوة
Example
```
const cube = bitbybit.math.power({ first: 2, second: 3 });
```
- Defined in bitbybit-docs.d.ts:55197

sqrt

sqrt(inputs: NumberDto): number
يجد الجذر التربيعي لرقم.

الرقم السالب يعطي NaN. مثال: 9 -> 3، 2 -> 1.414
Parameters
- inputs: NumberDto
  الرقم
Returns number
الجذر التربيعي
- Defined in bitbybit-docs.d.ts:55209

abs

abs(inputs: NumberDto): number
يسقط إشارة رقم، فلا تكون النتيجة سالبة أبدا.

مثال: -5 -> 5، 3 -> 3، 0 -> 0
Parameters
- inputs: NumberDto
  الرقم
Returns number
القيمة المطلقة
- Defined in bitbybit-docs.d.ts:55220

round

round(inputs: NumberDto): number
يقرّب رقما إلى أقرب رقم صحيح؛ الأنصاف تُقرّب إلى الأعلى.

مثال: 3.7 -> 4، 2.3 -> 2، 5.5 -> 6
Parameters
- inputs: NumberDto
  الرقم
Returns number
أقرب عدد صحيح
- Defined in bitbybit-docs.d.ts:55231

floor

floor(inputs: NumberDto): number
يقرّب رقما إلى الأسفل إلى الرقم الصحيح الذي تحته.

مثال: 3.7 -> 3، -2.3 -> -3، 5 -> 5
Parameters
- inputs: NumberDto
  الرقم
Returns number
العدد الصحيح الأدنى
- Defined in bitbybit-docs.d.ts:55242

ceil

ceil(inputs: NumberDto): number
يقرّب رقما إلى الأعلى إلى الرقم الصحيح الذي فوقه.

مثال: 3.2 -> 4، -2.8 -> -2، 5 -> 5
Parameters
- inputs: NumberDto
  الرقم
Returns number
العدد الصحيح الأعلى
- Defined in bitbybit-docs.d.ts:55253

negate

negate(inputs: NumberDto): number
يقلب إشارة رقم.

مثال: 5 -> -5، -3 -> 3، 0 -> 0
Parameters
- inputs: NumberDto
  الرقم
Returns number
الرقم بالإشارة المعاكسة
- Defined in bitbybit-docs.d.ts:55264

ln

ln(inputs: NumberDto): number
يجد اللوغاريتم الطبيعي لرقم: القوة التي يجب رفع e إليها للحصول على ذلك الرقم.

مثال: 2.718 -> نحو 1، 1 -> 0
Parameters
- inputs: NumberDto
  الرقم، أكبر من 0
Returns number
اللوغاريتم الطبيعي
- Defined in bitbybit-docs.d.ts:55275

log10

log10(inputs: NumberDto): number
يجد اللوغاريتم ذا الأساس 10 لرقم: القوة التي يجب رفع 10 إليها للحصول على ذلك الرقم.

مثال: 100 -> 2، 1000 -> 3، 10 -> 1
Parameters
- inputs: NumberDto
  الرقم، أكبر من 0
Returns number
اللوغاريتم ذو الأساس 10
- Defined in bitbybit-docs.d.ts:55286

tenPow

tenPow(inputs: NumberDto): number
يرفع 10 إلى قوة رقم.

مثال: 2 -> 100، 3 -> 1000، -1 -> 0.1
Parameters
- inputs: NumberDto
  الأس
Returns number
10 مرفوعا إلى تلك القوة
- Defined in bitbybit-docs.d.ts:55297

sin

sin(inputs: NumberDto): number
يجد جيب زاوية معطاة بالراديان.

مثال: 0 -> 0، pi/2 -> 1
Parameters
- inputs: NumberDto
  الزاوية بالراديان
Returns number
الجيب، بين -1 و 1
- Defined in bitbybit-docs.d.ts:55308

cos

cos(inputs: NumberDto): number
يجد جيب تمام زاوية معطاة بالراديان.

مثال: 0 -> 1، pi -> -1
Parameters
- inputs: NumberDto
  الزاوية بالراديان
Returns number
جيب التمام، بين -1 و 1
- Defined in bitbybit-docs.d.ts:55319

tan

tan(inputs: NumberDto): number
يجد ظل زاوية معطاة بالراديان.

مثال: 0 -> 0، pi/4 -> نحو 1
Parameters
- inputs: NumberDto
  الزاوية بالراديان
Returns number
الظل
- Defined in bitbybit-docs.d.ts:55330

asin

asin(inputs: NumberDto): number
يجد الزاوية، بالراديان، التي جيبها هو الرقم المعطى.

مثال: 0 -> 0، 1 -> pi/2 (نحو 1.57)
Parameters
- inputs: NumberDto
  رقم بين -1 و 1
Returns number
الزاوية بالراديان
- Defined in bitbybit-docs.d.ts:55341

acos

acos(inputs: NumberDto): number
يجد الزاوية، بالراديان، التي جيب تمامها هو الرقم المعطى.

مثال: 1 -> 0، -1 -> pi (نحو 3.14)
Parameters
- inputs: NumberDto
  رقم بين -1 و 1
Returns number
الزاوية بالراديان
- Defined in bitbybit-docs.d.ts:55352

atan

atan(inputs: NumberDto): number
يجد الزاوية، بالراديان، التي ظلها هو الرقم المعطى.

مثال: 0 -> 0، 1 -> pi/4 (نحو 0.785)
Parameters
- inputs: NumberDto
  الرقم
Returns number
الزاوية بالراديان، بين -pi/2 و pi/2
- Defined in bitbybit-docs.d.ts:55363

exp

exp(inputs: NumberDto): number
يرفع e، أساس اللوغاريتم الطبيعي، إلى قوة رقم.

مثال: 0 -> 1، 1 -> نحو 2.718، 2 -> نحو 7.389
Parameters
- inputs: NumberDto
  الأس
Returns number
e مرفوعا إلى تلك القوة
- Defined in bitbybit-docs.d.ts:55374

degToRad

degToRad(inputs: NumberDto): number
يحول زاوية من الدرجات إلى الراديان.

مثال: 180 -> pi (نحو 3.14159)، 90 -> pi/2
Parameters
- inputs: NumberDto
  الزاوية بالدرجات
Returns number
الزاوية بالراديان
- Defined in bitbybit-docs.d.ts:55385

radToDeg

radToDeg(inputs: NumberDto): number
يحول زاوية من الراديان إلى الدرجات.

مثال: pi -> 180، pi/2 -> 90
Parameters
- inputs: NumberDto
  الزاوية بالراديان
Returns number
الزاوية بالدرجات
- Defined in bitbybit-docs.d.ts:55396

create

number

number(inputs: NumberDto): number
يمرر رقما دون تغيير، بحيث يمكن إعطاء القيمة اسما وإعادة استخدامها.

مثال: 42 -> 42
Parameters
- inputs: NumberDto
  الرقم
Returns number
الرقم نفسه
- Defined in bitbybit-docs.d.ts:54956

generate

random

random(): number
يعطي رقما عشوائيا من 0 حتى 1، دون شمول 1.

مثال: 0.342 أو 0.891 أو أي قيمة أخرى في ذلك النطاق

Returns number
رقم عشوائي بين 0 و 1
- Defined in bitbybit-docs.d.ts:55066

randomNumber

randomNumber(inputs: RandomNumberDto): number
يعطي رقما عشوائيا بين low و high.

مثال: low 0، high 10 -> 3.7 أو 8.2 أو أي قيمة أخرى بينهما
Parameters
- inputs: RandomNumberDto
  الطرفان الأدنى والأعلى للنطاق
Returns number
رقم عشوائي في النطاق
Example
```
const value = bitbybit.math.randomNumber({ low: 0, high: 10 });
```
- Defined in bitbybit-docs.d.ts:55081

randomNumbers

randomNumbers(inputs: RandomNumbersDto): number[]
يعطي قائمة أرقام عشوائية بين low و high.

مثال: low 0، high 10، count 3 -> [2.5, 7.1, 4.8]
Parameters
- inputs: RandomNumbersDto
  الطرفان الأدنى والأعلى للنطاق وعدد الأرقام المراد إنشاؤها
Returns number[]
الأرقام العشوائية
Example
```
const values = bitbybit.math.randomNumbers({ low: 0, high: 10, count: 3 });
```
- Defined in bitbybit-docs.d.ts:55096

pi

pi(): number
يعطي الثابت pi، نسبة محيط الدائرة إلى قطرها.

مثال: 3.141592653589793

Returns number
الرقم pi
- Defined in bitbybit-docs.d.ts:55106

operations

twoNrOperation

twoNrOperation(inputs: ActionOnTwoNumbersDto): number
يطبق عملية حسابية واحدة على رقمين: جمع أو طرح أو ضرب أو قسمة أو قوة أو باقي القسمة.

تقرأ العملية first ثم second: الطرح يعطي الأول ناقص الثاني، والقوة تعطي الأول مرفوعا إلى قوة الثاني. مثال: 5 جمع 3 -> 8، 10 باقي القسمة على 3 -> 1، 2 قوة 3 -> 8
Parameters
- inputs: ActionOnTwoNumbersDto
  الرقمان والعملية
Returns number
نتيجة العملية
Example
```
const result = bitbybit.math.twoNrOperation({ first: 2, second: 3, operation: Bit.Inputs.Math.mathTwoNrOperatorEnum.power });
```
- Defined in bitbybit-docs.d.ts:54974

modulus

modulus(inputs: ModulusDto): number
يجد الباقي بعد قسمة رقم على آخر.

تتبع الإشارة الرقم الأول، كما في JavaScript. مثال: 10 باقي القسمة على 3 -> 1، 17 باقي القسمة على 5 -> 2
Parameters
- inputs: ModulusDto
  الرقم المراد قسمته والرقم المراد القسمة عليه
Returns number
الباقي
Example
```
const remainder = bitbybit.math.modulus({ number: 17, modulus: 5 });
```
- Defined in bitbybit-docs.d.ts:54990

roundToDecimals

roundToDecimals(inputs: RoundToDecimalsDto): number
يقرّب رقما إلى عدد معطى من المنازل العشرية.

مثال: 1.32156 إلى 3 منازل -> 1.322
Parameters
- inputs: RoundToDecimalsDto
  الرقم وعدد المنازل العشرية المراد الاحتفاظ بها
Returns number
الرقم المقرب
Example
```
const rounded = bitbybit.math.roundToDecimals({ number: 1.32156, decimalPlaces: 3 });
```
- Defined in bitbybit-docs.d.ts:55005

roundAndRemoveTrailingZeros

roundAndRemoveTrailingZeros(inputs: RoundToDecimalsDto): number
يقرّب رقما إلى عدد معطى من المنازل العشرية ويحذف الأصفار في النهاية.

كرقم لا يمكن للنتيجة أن تحمل أصفارا في النهاية على أي حال؛ الفرق عن roundToDecimals هو أن ضجيج الفاصلة العائمة مثل 1.320000001 يُنظف إلى 1.32. مثال: 1.32156 إلى 3 منازل -> 1.322، 1.320000001 -> 1.32، 1.000 -> 1
Parameters
- inputs: RoundToDecimalsDto
  الرقم وعدد المنازل العشرية المراد الاحتفاظ بها
Returns number
الرقم المقرب
Example
```
const clean = bitbybit.math.roundAndRemoveTrailingZeros({ number: 1.320000001, decimalPlaces: 3 });
```
- Defined in bitbybit-docs.d.ts:55022

oneNrOperation

oneNrOperation(inputs: ActionOnOneNumberDto): number
يطبق عملية واحدة على رقم واحد: القيمة المطلقة، أو النفي، أو الجذر التربيعي، أو التقريب، أو اللوغاريتمات، أو الدوال المثلثية ومعكوساتها، أو الأسية، أو التحويل بين الراديان والدرجات.

تعمل الدوال المثلثية بالراديان. مثال: sqrt لـ 5 -> 2.236، القيمة المطلقة لـ -3 -> 3
Parameters
- inputs: ActionOnOneNumberDto
  الرقم والعملية
Returns number
نتيجة العملية
Example
```
const root = bitbybit.math.oneNrOperation({ number: 5, operation: Bit.Inputs.Math.mathOneNrOperatorEnum.sqrt });
```
- Defined in bitbybit-docs.d.ts:55040

remap

remap(inputs: RemapNumberDto): number
يربط رقما من نطاق إلى نطاق آخر، محافظا على موضعه النسبي.

الرقم الواقع خارج النطاق المصدر يُربط تناسبيا إلى ما بعد النطاق الهدف. مثال: 5 من [0,10] إلى [0,100] -> 50، 0.5 من [0,1] إلى [-10,10] -> 0
Parameters
- inputs: RemapNumberDto
  الرقم والنطاق الذي يقع فيه والنطاق المراد تحويله إليه
Returns number
الرقم عند الموضع النسبي نفسه في النطاق المستهدف
Example
```
const percent = bitbybit.math.remap({ number: 5, fromLow: 0, fromHigh: 10, toLow: 0, toHigh: 100 });
```
- Defined in bitbybit-docs.d.ts:55056

toFixed

toFixed(inputs: ToFixedDto): string
ينسق رقما كنص بعدد ثابت من المنازل العشرية، مع الاحتفاظ بالأصفار في النهاية.

مثال: 3.14159 بمنزلتين -> '3.14'، 5 بثلاث منازل -> '5.000'
Parameters
- inputs: ToFixedDto
  الرقم وعدد المنازل العشرية المراد عرضها
Returns string
النص المنسق
Example
```
const label = bitbybit.math.toFixed({ number: 3.14159, decimalPlaces: 2 });
```
- Defined in bitbybit-docs.d.ts:55121

ease

ease(inputs: EaseDto): number
يربط قيمة من 0 إلى 1 بالنطاق من min إلى max على طول منحنى تخفيف، بحيث تتسارع النتيجة أو تتباطأ بدلا من أن تتغير بانتظام.

منحنى easeIn يبدأ ببطء، ومنحنى easeOut ينتهي ببطء، ومنحنى easeInOut يفعل الاثنين. مثال: 0.5 من [0,100] مع easeInQuad -> 25
Parameters
- inputs: EaseDto
  القيمة بين 0 و 1 والنطاق المستهدف ومنحنى التخفيف
Returns number
القيمة المخففة في النطاق المستهدف
Example
```
const eased = bitbybit.math.ease({ x: 0.5, min: 0, max: 100, ease: Bit.Inputs.Math.easeEnum.easeInQuad });
```
- Defined in bitbybit-docs.d.ts:55414

clamp

clamp(inputs: ClampDto): number
يبقي رقما ضمن نطاق: ما دون min يصبح min، وما فوق max يصبح max.

مثال: 5 في [0,3] -> 3، -1 في [0,3] -> 0، 1.5 في [0,3] -> 1.5
Parameters
- inputs: ClampDto
  الرقم والنطاق المراد إبقاؤه فيه
Returns number
الرقم، محصورا في النطاق
Example
```
const limited = bitbybit.math.clamp({ number: 5, min: 0, max: 3 });
```
- Defined in bitbybit-docs.d.ts:55429

lerp

lerp(inputs: LerpDto): number
يمزج من قيمة بداية إلى قيمة نهاية بكسر t: 0 يعطي البداية، و 1 النهاية، و 0.5 نقطة المنتصف.

قيمة t خارج 0 إلى 1 تستقرئ بعد الطرفين. مثال: 0 إلى 100 عند 0.5 -> 50، 10 إلى 20 عند 0.25 -> 12.5
Parameters
- inputs: LerpDto
  قيمة البداية وقيمة النهاية والكسر
Returns number
القيمة الممزوجة
Example
```
const mid = bitbybit.math.lerp({ start: 10, end: 20, t: 0.25 });
```
- Defined in bitbybit-docs.d.ts:55446

inverseLerp

inverseLerp(inputs: InverseLerpDto): number
يجد موقع قيمة بين بداية ونهاية، ككسر: قيمة t التي تحتاجها lerp لإنتاجها.

مثال: 5 في [0,10] -> 0.5، 2.5 في [0,10] -> 0.25
Parameters
- inputs: InverseLerpDto
  قيمة البداية وقيمة النهاية والقيمة المراد تحديد موضعها
Returns number
الكسر من البداية إلى النهاية
Example
```
const fraction = bitbybit.math.inverseLerp({ start: 0, end: 10, value: 2.5 });
```
- Defined in bitbybit-docs.d.ts:55462

smoothstep

smoothstep(inputs: NumberDto): number
يحول قيمة من 0 إلى 1 إلى منحنى S ناعم يبدأ وينتهي برفق؛ تُحصر القيمة في ذلك النطاق أولا.

مثال: 0 -> 0، 0.5 -> 0.5، 0.25 -> 0.156
Parameters
- inputs: NumberDto
  القيمة بين 0 و 1
Returns number
القيمة المنعمة بين 0 و 1
- Defined in bitbybit-docs.d.ts:55474

sign

sign(inputs: NumberDto): number
يخبر بإشارة رقم: -1 عندما يكون سالبا، و 0 عندما يكون صفرا، و 1 عندما يكون موجبا.

مثال: -5 -> -1، 0 -> 0، 3.14 -> 1
Parameters
- inputs: NumberDto
  الرقم
Returns number
1 أو 0 أو 1
- Defined in bitbybit-docs.d.ts:55485

fract

fract(inputs: NumberDto): number
يحتفظ بجزء الرقم الذي يلي الفاصلة العشرية، مقيسا صعودا من الرقم الصحيح الأدنى منه، فتكون النتيجة دائما من 0 حتى 1.

مثال: 3.14 -> 0.14، -2.3 -> 0.7
Parameters
- inputs: NumberDto
  الرقم
Returns number
الجزء الكسري، من 0 إلى ما دون 1
- Defined in bitbybit-docs.d.ts:55497

wrap

wrap(inputs: WrapDto): number
يلف رقما في نطاق بحيث يدور: بعد max يعود من min، وتحت min يعود من max.

مفيد للزوايا والأنماط المتكررة؛ على خلاف باقي القسمة العادي يتعامل مع الأرقام السالبة. مثال: 1.5 في [0,1) -> 0.5، -0.3 في [0,1) -> 0.7، 370 في [0,360) -> 10
Parameters
- inputs: WrapDto
  الرقم والنطاق المراد لفه فيه
Returns number
الرقم الملفوف، من min إلى ما دون max
Example
```
const angle = bitbybit.math.wrap({ number: 370, min: 0, max: 360 });
```
- Defined in bitbybit-docs.d.ts:55514

pingPong

pingPong(inputs: PingPongDto): number
يرتد بقيمة ذهابا وإيابا بين 0 و length مع نمو t: صعودا إلى length، ثم نزولا إلى 0، ثم مجددا.

مثال: length 1 عند t 0.5 -> 0.5، t 1 -> 1، t 1.5 -> 0.5، t 2 -> 0
Parameters
- inputs: PingPongDto
  القيمة الجارية والطول الذي ترتد ضمنه
Returns number
القيمة المرتدة بين 0 و length
Example
```
const bounce = bitbybit.math.pingPong({ t: 1.5, length: 1 });
```
- Defined in bitbybit-docs.d.ts:55530

moveTowards

moveTowards(inputs: MoveTowardsDto): number
يحرك قيمة نحو هدف بمقدار maxDelta على الأكثر، دون تجاوزه.

مثال: 0 نحو 10 بمقدار 3 -> 3، 8 نحو 10 بمقدار 3 -> 10
Parameters
- inputs: MoveTowardsDto
  القيمة الحالية والهدف وأكبر خطوة مسموح بها
Returns number
القيمة بعد خطوة واحدة
Example
```
const next = bitbybit.math.moveTowards({ current: 8, target: 10, maxDelta: 3 });
```
- Defined in bitbybit-docs.d.ts:55545

evalArithmetic

evalArithmetic(inputs: EvalArithmeticDto): number
يحسب تعبيرا حسابيا بسيطا مكتوبا كنص: أرقام، و +، و -، وعلامة الضرب، و /، وأقواس ومسافات.

تحلل المكتبة نفسها التعبير وتحسبه، ولا يُسلّم أبدا إلى محرك JavaScript لتشغيله، فهو آمن مع نص كتبه مستخدم. مثال: '(3+2) times 4' مكتوبا بالعلامة -> 20، '10/3' -> 3.3333
Parameters
- inputs: EvalArithmeticDto
  نص التعبير
Returns number
القيمة المحسوبة
Example
```
const value = bitbybit.math.evalArithmetic({ expression: "(3 + 2) * 4" });
```
- Defined in bitbybit-docs.d.ts:55563

Class MathBitByBit

Index

Constructors

basics

create

generate

operations

Constructors

constructor

Returns MathBitByBit

basics

add

Parameters

Returns number

Example

subtract

Parameters

Returns number

Example

multiply

Parameters

Returns number

Example

divide

Parameters

Returns number

Example

power

Parameters

Returns number

Example

sqrt

Parameters

Returns number

abs

Parameters

Returns number

round

Parameters

Returns number

floor

Parameters

Returns number

ceil

Parameters

Returns number

negate

Parameters

Returns number

ln

Parameters

Returns number

log10

Parameters

Returns number

tenPow

Parameters

Returns number

sin

Parameters

Returns number

cos

Parameters

Returns number

tan

Parameters

Returns number

asin

Parameters

Returns number

acos

Parameters

Returns number

atan

Parameters

Returns number

exp

Parameters

Returns number

degToRad