# [name]

كائن مع عدة وظائف مساعدة للرياضيات.

## الطرق (Methods)

### [method:Float clamp]( [param:Float value], [param:Float min], [param:Float max] )

[page:Float value] — القيمة التي يتم تثبيتها.
[page:Float min] — الحد الأدنى.
[page:Float max] — الحد الأقصى.
يثبت[page:Float value ] ليكون بين[page:Float min ] و [page:Float max ].

### [method:Float degToRad]( [param:Float degrees] )

تحويل الدرجات إلى راديان.

### [method:Integer euclideanModulo]( [param:Integer n], [param:Integer m] )

[page:Integer n]،[page:Integer m ] - أعداد صحيحة
يحسب نمط إقليدي لـ[page:Integer m ] % [page:Integer n ]، هذا هو: `( ( n % m ) + m ) % m`

### [method:UUID generateUUID]( )

توليد [link:https://en.wikipedia.org/wiki/Universally_unique_identifier UUID] (معرف فريد عالميًا).

### [method:Boolean isPowerOfTwo]( [param:Number n] )

يعود بـ`true` إذا كان [page:Number n] قوة لـ2.

### [method:Float inverseLerp]( [param:Float x], [param:Float y], [param:Float value] )

[page:Float x] - نقطة البداية.
[page:Float y] - نقطة النهاية.
[page:Float value] - قيمة بين البداية والنهاية.
يعود بالنسبة المئوية في الفترة المغلقة `[0، 1]` للقيمة المعطاة بين نقطة البداية والنهاية.

### [method:Float lerp]( [param:Float x], [param:Float y], [param:Float t] )

[page:Float x] - نقطة البداية.
[page:Float y] - نقطة النهاية.
[page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`.
يعود بقيمة[link:https://en.wikipedia.org/wiki/Linear_interpolation متداخلة خطيًا ] من نقطتين معروفتين بناءً على الفترة المعطاة - [page:Float t ] = 0 سيعود بـ[page:Float x ] و[page:Float t ] = 1 سوف يعود بـ[page:Float y ].

### [method:Float damp]( [param:Float x], [param:Float y], [param:Float lambda], [param:Float dt] )

[page:Float x] - نقطة حالية.
[page:Float y] - نقطة الهدف.
[page:Float lambda] - قيمة lambda أعلى ستجعل الحركة أكثر فجأة، وقيمة أقل ستجعل الحركة أكثر تدرجًا.
[page:Float dt] - وقت دلتا بالثواني.
تداخل عدد من[page:Float x ] نحو[page:Float y ] بطريقة ربيعية باستخدام[page:Float dt ] للحفاظ على حركة مستقلة عن معدل الإطارات. للحصول على التفاصيل، راجع [link:http://www.rorydriscoll.com/2016/03/07/frame-rate-independent-damping-using-lerp/ تخميد مستقل عن معدل الإطارات باستخدام lerp].

### [method:Float mapLinear]( [param:Float x], [param:Float a1], [param:Float a2], [param:Float b1], [param:Float b2] )

[page:Float x] — القيمة التي يتم تعيينها.
[page:Float a1] — الحد الأدنى للنطاق A.
[page:Float a2] — الحد الأقصى للنطاق A.
[page:Float b1] — الحد الأدنى للنطاق B.
[page:Float b2] — الحد الأقصى للنطاق B.
تعيين خطي لـ[page:Float x ] من النطاق [[page:Float a1 ], [page:Float a2 ]] إلى النطاق [[page:Float b1 ], [page:Float b2 ]].

### [method:Float pingpong]( [param:Float x], [param:Float length] )

[page:Float x] — القيمة التي يتم تعيينها.
[page:Float length] — القيمة الموجبة التي ستتعامل معها الوظيفة. الافتراضي هو 1.
يعود بقيمة تتبادل بين 0 و[param:Float length ].

### [method:Integer ceilPowerOfTwo]( [param:Number n] )

يعود بأصغر قوة من 2 أكبر من أو يساوي [page:Number n ].

### [method:Integer floorPowerOfTwo]( [param:Number n] )

يعود بأكبر قوة من 2 أقل من أو يساوي[page:Number n ].

### [method:Float radToDeg]( [param:Float radians] )

تحويل الراديان إلى درجات.

### [method:Float randFloat]( [param:Float low], [param:Float high] )

عشوائية عائمة في الفترة [[page:Float low ], [page:Float high ]].

### [method:Float randFloatSpread]( [param:Float range] )

عشوائية عائمة في الفترة [-[page:Float range ] / 2،[page:Float range ] / 2].

### [method:Integer randInt]( [param:Integer low], [param:Integer high] )

عشوائية صحيحة في الفترة [[page:Float low ],[page:Float high ]].

### [method:Float seededRandom]( [param:Integer seed] )

عشوائية زائفة محددة عائمة في الفترة `[0، 1]`. هو اختیاری [page:Integer seed ].

### [method:Float smoothstep]( [param:Float x], [param:Float min], [param:Float max] )

[page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد الأدنى والأقصى.
[page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.
[page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.
يعود بقيمة بين 0-1 تمثل النسبة المئوية التي انتقلت فيها x بين الحد الأدنى والأقصى، ولكن تم تجانسها أو تبطئها كلما اقترب X من الحد الأدنى والأقصى.
راجع [link:http://en.wikipedia.org/wiki/Smoothstep Smoothstep] للحصول على التفاصيل.

### [method:Float smootherstep]( [param:Float x], [param:Float min], [param:Float max] )

[page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد الأدنى والأقصى.
[page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.
[page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.
يعود بقيمة بين 0-1. تغير على smoothstep يحتوي على مشتقات من الطلب 1st و 2nd صفر في x=0 و x=1.

### [method:undefined setQuaternionFromProperEuler]( [param:Quaternion q], [param:Float a], [param:Float b], [param:Float c], [param:String order] )

[page:Quaternion q] - رباعية لضبطها
[page:Float a] - التدوير المطبق على المحور الأول، بالراديان
[page:Float b] - التدوير المطبق على المحور الثاني، بالراديان
[page:Float c] - التدوير المطبق على المحور الثالث، بالراديان
[page:String order] - سلسلة تحدد ترتيب المحاور: 'XYX'، 'XZX'، 'YXY'، 'YZY'، 'ZXZ'، أو 'ZYZ'
يضبط رباعية[page:Quaternion q ] من [link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر Proper intrinsic ] المعرفة بزوايا[page:Float a ]،[page:Float b ]، و[page:Float c ]، والترتیب[page:String order].
يتم تطبیق التدویرات على المحاور بالترتیب المحدد بـ[page:String order]: يتم تطبیق التدویر بزاویة[page:Float a ] أولًا، ثم بزاویة [page:Float b ]، ثم بزاویة[page:Float c ]. زوایا هی فی رادیان.

## المصدر (Source)

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]