MathUtils.html 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208
  1. <!DOCTYPE html>
  2. <html lang="ar">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body class="rtl">
  10. <h1>[name]</h1>
  11. <p class="desc">كائن مع عدة وظائف مساعدة للرياضيات.</p>
  12. <h2>الطرق (Methods)</h2>
  13. <h3>
  14. [method:Float clamp]( [param:Float value], [param:Float min], [param:Float max] )
  15. </h3>
  16. <p>
  17. [page:Float value] — القيمة التي يتم تثبيتها.<br />
  18. [page:Float min] — الحد الأدنى.<br />
  19. [page:Float max] — الحد الأقصى.<br /><br />
  20. يثبت[page:Float value ] ليكون بين[page:Float min ] و
  21. [page:Float max ].
  22. </p>
  23. <h3>[method:Float degToRad]( [param:Float degrees] )</h3>
  24. <p>تحويل الدرجات إلى راديان.</p>
  25. <h3>
  26. [method:Integer euclideanModulo]( [param:Integer n], [param:Integer m] )
  27. </h3>
  28. <p>
  29. [page:Integer n]،[page:Integer m ] - أعداد صحيحة<br /><br />
  30. يحسب نمط إقليدي لـ[page:Integer m ] % [page:Integer n ]، هذا
  31. هو:
  32. <code>( ( n % m ) + m ) % m</code>
  33. </p>
  34. <h3>[method:UUID generateUUID]( )</h3>
  35. <p>
  36. توليد
  37. [link:https://en.wikipedia.org/wiki/Universally_unique_identifier UUID]
  38. (معرف فريد عالميًا).
  39. </p>
  40. <h3>[method:Boolean isPowerOfTwo]( [param:Number n] )</h3>
  41. <p>يعود بـ`true` إذا كان [page:Number n] قوة لـ2.</p>
  42. <h3>
  43. [method:Float inverseLerp]( [param:Float x], [param:Float y], [param:Float value] )
  44. </h3>
  45. <p>
  46. [page:Float x] - نقطة البداية.<br />
  47. [page:Float y] - نقطة النهاية.<br />
  48. [page:Float value] - قيمة بين البداية والنهاية.<br /><br />
  49. يعود بالنسبة المئوية في الفترة المغلقة `[0، 1]` للقيمة المعطاة
  50. بين نقطة البداية والنهاية.
  51. </p>
  52. <h3>
  53. [method:Float lerp]( [param:Float x], [param:Float y], [param:Float t] )
  54. </h3>
  55. <p>
  56. [page:Float x] - نقطة البداية. <br />
  57. [page:Float y] - نقطة النهاية. <br />
  58. [page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`.<br /><br />
  59. يعود بقيمة[link:https://en.wikipedia.org/wiki/Linear_interpolation متداخلة خطيًا ]
  60. من نقطتين معروفتين بناءً على الفترة المعطاة -
  61. [page:Float t ] = 0 سيعود بـ[page:Float x ] و[page:Float t ] = 1 سوف
  62. يعود بـ[page:Float y ].
  63. </p>
  64. <h3>
  65. [method:Float damp]( [param:Float x], [param:Float y], [param:Float lambda], [param:Float dt] )
  66. </h3>
  67. <p>
  68. [page:Float x] - نقطة حالية. <br />
  69. [page:Float y] - نقطة الهدف. <br />
  70. [page:Float lambda] - قيمة lambda أعلى ستجعل الحركة أكثر
  71. فجأة، وقيمة أقل ستجعل الحركة أكثر تدرجًا. <br />
  72. [page:Float dt] - وقت دلتا بالثواني.<br /><br />
  73. تداخل عدد من[page:Float x ] نحو[page:Float y ] بطريقة
  74. ربيعية باستخدام[page:Float dt ] للحفاظ على حركة مستقلة عن معدل
  75. الإطارات. للحصول على التفاصيل، راجع
  76. [link:http://www.rorydriscoll.com/2016/03/07/frame-rate-independent-damping-using-lerp/ تخميد مستقل عن معدل الإطارات باستخدام lerp].
  77. </p>
  78. <h3>
  79. [method:Float mapLinear]( [param:Float x], [param:Float a1], [param:Float a2], [param:Float b1], [param:Float b2] )
  80. </h3>
  81. <p>
  82. [page:Float x] — القيمة التي يتم تعيينها.<br />
  83. [page:Float a1] — الحد الأدنى للنطاق A.<br />
  84. [page:Float a2] — الحد الأقصى للنطاق A.<br />
  85. [page:Float b1] — الحد الأدنى للنطاق B.<br />
  86. [page:Float b2] — الحد الأقصى للنطاق B.<br /><br />
  87. تعيين خطي لـ[page:Float x ] من النطاق [[page:Float a1 ], [page:Float a2 ]] إلى النطاق [[page:Float b1 ], [page:Float b2 ]].
  88. </p>
  89. <h3>[method:Float pingpong]( [param:Float x], [param:Float length] )</h3>
  90. <p>
  91. [page:Float x] — القيمة التي يتم تعيينها.<br />
  92. [page:Float length] — القيمة الموجبة التي ستتعامل معها الوظيفة.
  93. الافتراضي هو 1.<br /><br />
  94. يعود بقيمة تتبادل بين 0 و[param:Float length ].
  95. </p>
  96. <h3>[method:Integer ceilPowerOfTwo]( [param:Number n] )</h3>
  97. <p>
  98. يعود بأصغر قوة من 2 أكبر من أو يساوي
  99. [page:Number n ].
  100. </p>
  101. <h3>[method:Integer floorPowerOfTwo]( [param:Number n] )</h3>
  102. <p>
  103. يعود بأكبر قوة من 2 أقل من أو يساوي[page:Number n ].
  104. </p>
  105. <h3>[method:Float radToDeg]( [param:Float radians] )</h3>
  106. <p>تحويل الراديان إلى درجات.</p>
  107. <h3>[method:Float randFloat]( [param:Float low], [param:Float high] )</h3>
  108. <p>عشوائية عائمة في الفترة [[page:Float low ], [page:Float high ]].</p>
  109. <h3>[method:Float randFloatSpread]( [param:Float range] )</h3>
  110. <p>
  111. عشوائية عائمة في الفترة [-[page:Float range ] / 2،[page:Float range ]
  112. / 2].
  113. </p>
  114. <h3>
  115. [method:Integer randInt]( [param:Integer low], [param:Integer high] )
  116. </h3>
  117. <p>عشوائية صحيحة في الفترة [[page:Float low ],[page:Float high ]].</p>
  118. <h3>[method:Float seededRandom]( [param:Integer seed] )</h3>
  119. <p>
  120. عشوائية زائفة محددة عائمة في الفترة `[0، 1]`. هو اختیاری
  121. [page:Integer seed ].
  122. </p>
  123. <h3>
  124. [method:Float smoothstep]( [param:Float x], [param:Float min], [param:Float max] )
  125. </h3>
  126. <p>
  127. [page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد
  128. الأدنى والأقصى. <br />
  129. [page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.<br />
  130. [page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.<br /><br />
  131. يعود بقيمة بين 0-1 تمثل النسبة المئوية التي انتقلت فيها x بين الحد
  132. الأدنى والأقصى، ولكن تم تجانسها أو تبطئها كلما اقترب X من
  133. الحد الأدنى والأقصى.<br /><br />
  134. راجع [link:http://en.wikipedia.org/wiki/Smoothstep Smoothstep] للحصول على التفاصيل.
  135. </p>
  136. <h3>
  137. [method:Float smootherstep]( [param:Float x], [param:Float min], [param:Float max] )
  138. </h3>
  139. <p>
  140. [page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد
  141. الأدنى والأقصى. <br />
  142. [page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.<br />
  143. [page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.<br /><br />
  144. يعود بقيمة بين 0-1. تغير على smoothstep
  145. يحتوي على مشتقات من الطلب 1st و 2nd صفر في x=0 و x=1.
  146. </p>
  147. <h3>
  148. [method:undefined setQuaternionFromProperEuler]( [param:Quaternion q], [param:Float a], [param:Float b], [param:Float c], [param:String order] )
  149. </h3>
  150. <p>
  151. [page:Quaternion q] - رباعية لضبطها<br />
  152. [page:Float a] - التدوير المطبق على المحور الأول، بالراديان <br />
  153. [page:Float b] - التدوير المطبق على المحور الثاني، بالراديان
  154. <br />
  155. [page:Float c] - التدوير المطبق على المحور الثالث، بالراديان <br />
  156. [page:String order] - سلسلة تحدد ترتيب المحاور: 'XYX'، 'XZX'،
  157. 'YXY'، 'YZY'، 'ZXZ'، أو 'ZYZ'<br /><br />
  158. يضبط رباعية[page:Quaternion q ] من
  159. [link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر Proper intrinsic ]
  160. المعرفة بزوايا[page:Float a ]،[page:Float b ]، و[page:Float c ]،
  161. والترتیب[page:String order].<br />
  162. يتم تطبیق التدویرات على المحاور بالترتیب المحدد بـ[page:String order]:
  163. يتم تطبیق التدویر بزاویة[page:Float a ] أولًا، ثم بزاویة
  164. [page:Float b ]، ثم بزاویة[page:Float c ]. زوایا هی فی رادیان.
  165. </p>
  166. <h2>المصدر (Source)</h2>
  167. <p>
  168. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  169. </p>
  170. </body>
  171. </html>