Euler.html 7.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175
  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">
  12. فئة تمثل [link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر].<br /><br />
  13. تصف زوايا أويلر التحول الدوار بتدوير كائن على
  14. محاوره المختلفة بمقادير محددة لكل محور، وترتيب محور محدد.
  15. </p>
  16. <p>
  17. التكرار عبر نسخة [name] سيعود بمكوناته (x، y، z،
  18. order) في الترتيب المقابل.
  19. </p>
  20. <h2>مثال الكود</h2>
  21. <code>
  22. const a = new THREE.Euler( 0, 1, 1.57, 'XYZ' );
  23. const b = new THREE.Vector3( 1, 0, 1 );
  24. b.applyEuler(a);
  25. </code>
  26. <h2>المنشئ (Constructor)</h2>
  27. <h3>
  28. [name]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )
  29. </h3>
  30. <p>
  31. [page:Float x] - (اختياري) زاوية المحور x بالراديان. الافتراضي هو
  32. `0`.<br />
  33. [page:Float y] - (اختياري) زاوية المحور y بالراديان. الافتراضي هو
  34. `0`.<br />
  35. [page:Float z] - (اختياري) زاوية المحور z بالراديان. الافتراضي هو
  36. `0`.<br />
  37. [page:String order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق
  38. التدویرات، الافتراضی هو 'XYZ' (یجب أن تكون بحروف كبیرة).<br /><br />
  39. </p>
  40. <h2>الخصائص (Properties)</h2>
  41. <h3>[property:Boolean isEuler]</h3>
  42. <p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].</p>
  43. <h3>[property:String order]</h3>
  44. <p>
  45. الترتيب الذي يتم فيه تطبيق التدويرات. الافتراضي هو 'XYZ'، مما يعني أن
  46. الكائن سيتم تدويره أولاً حول محور X الخاص به، ثم محور Y الخاص به وأخيرًا
  47. محور Z الخاص به. الإمكانيات الأخرى هي: 'YZX'، 'ZXY'، 'XZY'، 'YXZ'
  48. و'ZYX'. يجب أن تكون هذه بحروف كبيرة.<br /><br />
  49. يستخدم Three.js زوايا Tait-Bryan `intrinsic`. هذا يعني أن التدويرات
  50. يتم تنفيذها بالنسبة إلى نظام الإحداثيات `local`. أي للترتيب 'XYZ'، يتم
  51. التدوير أولاً حول محور local-X (وهو نفسه محور world-X)، ثم حول local-Y
  52. (الذي قد يكون الآن مختلفًا عن محور world Y)، ثم local-Z (الذي قد يكون
  53. مختلفًا عن محور world Z).<br /><br />
  54. </p>
  55. <h3>[property:Float x]</h3>
  56. <p>القيمة الحالية للمكون x.<br /><br /></p>
  57. <h3>[property:Float y]</h3>
  58. <p>القيمة الحالية للمكون y.<br /><br /></p>
  59. <h3>[property:Float z]</h3>
  60. <p>القيمة الحالية للمكون z.<br /><br /></p>
  61. <h2>الطرق (Methods)</h2>
  62. <h3>[method:this copy]( [param:Euler euler] )</h3>
  63. <p>ينسخ قيمة [page:Euler euler] إلى هذه الزاوية الأويلر.</p>
  64. <h3>[method:Euler clone]()</h3>
  65. <p>يعود إلى أويلر جديد بنفس المعلمات كهذا.</p>
  66. <h3>[method:Boolean equals]( [param:Euler euler] )</h3>
  67. <p>يتحقق من المساواة الصارمة لهذه الزاوية الأويلر و[page:Euler euler].</p>
  68. <h3>[method:this fromArray]( [param:Array array] )</h3>
  69. <p>
  70. [page:Array array] من طول 3 أو 4. يتوافق السجل 4 اختياريًا
  71. إلى [page:.order order].<br /><br />
  72. يعيّن زاوية [page:.x x] لهذه الزاوية الأويلر إلى `array[0]`. <br />
  73. يعيّن زاوية [page:.y y] لهذه الزاوية الأويلر إلى `array[1]`. <br />
  74. يعيّن زاوية [page:.z z] لهذه الزاوية الأويلر إلى `array[2]`. <br />
  75. اختیاریًا یعین ترتیب هذه الزاویة الأویلر [page:.order order] إلى `array[3]`.
  76. </p>
  77. <h3>[method:this reorder]( [param:String newOrder] )</h3>
  78. <p>
  79. يعيد تعيين زاوية الأويلر بترتيب جديد عن طريق إنشاء رباعية من هذه
  80. زاوية الأويلر ثم تعيين هذه الزاوية الأويلر مع الرباعية والترتيب
  81. الجديد. <br /><br />
  82. <em>*تحذير*: هذا يتجاهل معلومات الثورة.</em>
  83. </p>
  84. <h3>
  85. [method:this set]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )
  86. </h3>
  87. <p>
  88. [page:.x x] - زاوية المحور x بالراديان.<br />
  89. [page:.y y] - زاوية المحور y بالراديان.<br />
  90. [page:.z z] - زاوية المحور z بالراديان.<br />
  91. [page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق
  92. التدويرات.<br /><br />
  93. يضبط زوايا هذا التحول الأويلر واختياريًا الترتيب [page:.order order].
  94. </p>
  95. <h3>
  96. [method:this setFromRotationMatrix]( [param:Matrix4 m], [param:String order] )
  97. </h3>
  98. <p>
  99. [page:Matrix4 m] - a [page:Matrix4] منها 3x3 العلوية من المصفوفة هي
  100. مصفوفة دوران نقية
  101. (أي غير مقاسة).<br />
  102. [page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق
  103. التدويرات.<br />
  104. يضبط زوايا هذا التحول الأويلر من مصفوفة دوران نقية بناءً على
  105. التوجه المحدد بالترتيب.
  106. </p>
  107. <h3>
  108. [method:this setFromQuaternion]( [param:Quaternion q], [param:String order] )
  109. </h3>
  110. <p>
  111. [page:Quaternion q] - رباعية معدلة.<br />
  112. [page:.order order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق
  113. التدويرات.<br />
  114. يضبط زوايا هذا التحول الأويلر من رباعية معدلة بناءً على
  115. التوجه المحدد بـ[page:.order order].
  116. </p>
  117. <h3>
  118. [method:this setFromVector3]( [param:Vector3 vector], [param:String order] )
  119. </h3>
  120. <p>
  121. [page:Vector3 vector] - [page:Vector3].<br />
  122. [page:.order order] - (اختیاری) سلسلة تمثل الترتیب الذى يتم فيه تطبیق
  123. التدویرات.<br /><br />
  124. قم بضبط [page:.x x], [page:.y y] و[page:.z z]، وقم اختیاریًا بتحديث
  125. الترتیب[page:.order order].
  126. </p>
  127. <h3>
  128. [method:Array toArray]( [param:Array array], [param:Integer offset] )
  129. </h3>
  130. <p>
  131. [page:Array array] - (optional) array to store the euler in.<br />
  132. [page:Integer offset] (optional) offset in the array.<br />
  133. يعود إلى مصفوفة من شكل [[page:.x x], [page:.y y], [page:.z z],
  134. [page:.order order ]].
  135. </p>
  136. <h2>المصدر (Source)</h2>
  137. <p>
  138. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  139. </p>
  140. </body>
  141. </html>