You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
176 lines
7.0 KiB
HTML
176 lines
7.0 KiB
HTML
2 months ago
|
<!DOCTYPE html>
|
||
|
|
<html lang="ar">
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8" />
|
||
|
|
<base href="../../../" />
|
||
|
|
<script src="page.js"></script>
|
||
|
|
<link type="text/css" rel="stylesheet" href="page.css" />
|
||
|
|
</head>
|
||
|
|
<body class="rtl">
|
||
|
|
<h1>[name]</h1>
|
||
|
|
|
||
|
|
<p class="desc">
|
||
|
|
فئة تمثل [link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر].<br /><br />
|
||
|
|
|
||
|
|
تصف زوايا أويلر التحول الدوار بتدوير كائن على
|
||
|
|
محاوره المختلفة بمقادير محددة لكل محور، وترتيب محور محدد.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
التكرار عبر نسخة [name] سيعود بمكوناته (x، y، z،
|
||
|
|
order) في الترتيب المقابل.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>مثال الكود</h2>
|
||
|
|
|
||
|
|
<code>
|
||
|
|
const a = new THREE.Euler( 0, 1, 1.57, 'XYZ' );
|
||
|
|
const b = new THREE.Vector3( 1, 0, 1 );
|
||
|
|
b.applyEuler(a);
|
||
|
|
</code>
|
||
|
|
|
||
|
|
<h2>المنشئ (Constructor)</h2>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[name]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:Float x] - (اختياري) زاوية المحور x بالراديان. الافتراضي هو
|
||
|
|
`0`.<br />
|
||
|
|
[page:Float y] - (اختياري) زاوية المحور y بالراديان. الافتراضي هو
|
||
|
|
`0`.<br />
|
||
|
|
[page:Float z] - (اختياري) زاوية المحور z بالراديان. الافتراضي هو
|
||
|
|
`0`.<br />
|
||
|
|
[page:String order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق
|
||
|
|
التدویرات، الافتراضی هو 'XYZ' (یجب أن تكون بحروف كبیرة).<br /><br />
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>الخصائص (Properties)</h2>
|
||
|
|
|
||
|
|
<h3>[property:Boolean isEuler]</h3>
|
||
|
|
<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].</p>
|
||
|
|
|
||
|
|
<h3>[property:String order]</h3>
|
||
|
|
<p>
|
||
|
|
الترتيب الذي يتم فيه تطبيق التدويرات. الافتراضي هو 'XYZ'، مما يعني أن
|
||
|
|
الكائن سيتم تدويره أولاً حول محور X الخاص به، ثم محور Y الخاص به وأخيرًا
|
||
|
|
محور Z الخاص به. الإمكانيات الأخرى هي: 'YZX'، 'ZXY'، 'XZY'، 'YXZ'
|
||
|
|
و'ZYX'. يجب أن تكون هذه بحروف كبيرة.<br /><br />
|
||
|
|
|
||
|
|
يستخدم Three.js زوايا Tait-Bryan `intrinsic`. هذا يعني أن التدويرات
|
||
|
|
يتم تنفيذها بالنسبة إلى نظام الإحداثيات `local`. أي للترتيب 'XYZ'، يتم
|
||
|
|
التدوير أولاً حول محور local-X (وهو نفسه محور world-X)، ثم حول local-Y
|
||
|
|
(الذي قد يكون الآن مختلفًا عن محور world Y)، ثم local-Z (الذي قد يكون
|
||
|
|
مختلفًا عن محور world Z).<br /><br />
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[property:Float x]</h3>
|
||
|
|
<p>القيمة الحالية للمكون x.<br /><br /></p>
|
||
|
|
|
||
|
|
<h3>[property:Float y]</h3>
|
||
|
|
<p>القيمة الحالية للمكون y.<br /><br /></p>
|
||
|
|
|
||
|
|
<h3>[property:Float z]</h3>
|
||
|
|
<p>القيمة الحالية للمكون z.<br /><br /></p>
|
||
|
|
|
||
|
|
<h2>الطرق (Methods)</h2>
|
||
|
|
|
||
|
|
<h3>[method:this copy]( [param:Euler euler] )</h3>
|
||
|
|
<p>ينسخ قيمة [page:Euler euler] إلى هذه الزاوية الأويلر.</p>
|
||
|
|
|
||
|
|
<h3>[method:Euler clone]()</h3>
|
||
|
|
<p>يعود إلى أويلر جديد بنفس المعلمات كهذا.</p>
|
||
|
|
|
||
|
|
<h3>[method:Boolean equals]( [param:Euler euler] )</h3>
|
||
|
|
<p>يتحقق من المساواة الصارمة لهذه الزاوية الأويلر و[page:Euler euler].</p>
|
||
|
|
|
||
|
|
<h3>[method:this fromArray]( [param:Array array] )</h3>
|
||
|
|
<p>
|
||
|
|
[page:Array array] من طول 3 أو 4. يتوافق السجل 4 اختياريًا
|
||
|
|
إلى [page:.order order].<br /><br />
|
||
|
|
|
||
|
|
يعيّن زاوية [page:.x x] لهذه الزاوية الأويلر إلى `array[0]`. <br />
|
||
|
|
يعيّن زاوية [page:.y y] لهذه الزاوية الأويلر إلى `array[1]`. <br />
|
||
|
|
يعيّن زاوية [page:.z z] لهذه الزاوية الأويلر إلى `array[2]`. <br />
|
||
|
|
اختیاریًا یعین ترتیب هذه الزاویة الأویلر [page:.order order] إلى `array[3]`.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>[method:this reorder]( [param:String newOrder] )</h3>
|
||
|
|
<p>
|
||
|
|
يعيد تعيين زاوية الأويلر بترتيب جديد عن طريق إنشاء رباعية من هذه
|
||
|
|
زاوية الأويلر ثم تعيين هذه الزاوية الأويلر مع الرباعية والترتيب
|
||
|
|
الجديد. <br /><br />
|
||
|
|
|
||
|
|
<em>*تحذير*: هذا يتجاهل معلومات الثورة.</em>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[method:this set]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:.x x] - زاوية المحور x بالراديان.<br />
|
||
|
|
[page:.y y] - زاوية المحور y بالراديان.<br />
|
||
|
|
[page:.z z] - زاوية المحور z بالراديان.<br />
|
||
|
|
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق
|
||
|
|
التدويرات.<br /><br />
|
||
|
|
|
||
|
|
يضبط زوايا هذا التحول الأويلر واختياريًا الترتيب [page:.order order].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[method:this setFromRotationMatrix]( [param:Matrix4 m], [param:String order] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:Matrix4 m] - a [page:Matrix4] منها 3x3 العلوية من المصفوفة هي
|
||
|
|
مصفوفة دوران نقية
|
||
|
|
(أي غير مقاسة).<br />
|
||
|
|
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق
|
||
|
|
التدويرات.<br />
|
||
|
|
|
||
|
|
يضبط زوايا هذا التحول الأويلر من مصفوفة دوران نقية بناءً على
|
||
|
|
التوجه المحدد بالترتيب.
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[method:this setFromQuaternion]( [param:Quaternion q], [param:String order] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:Quaternion q] - رباعية معدلة.<br />
|
||
|
|
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق
|
||
|
|
التدويرات.<br />
|
||
|
|
|
||
|
|
يضبط زوايا هذا التحول الأويلر من رباعية معدلة بناءً على
|
||
|
|
التوجه المحدد بـ[page:.order order].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[method:this setFromVector3]( [param:Vector3 vector], [param:String order] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:Vector3 vector] - [page:Vector3].<br />
|
||
|
|
[page:.order order] - (اختیاری) سلسلة تمثل الترتیب الذى يتم فيه تطبیق
|
||
|
|
التدویرات.<br /><br />
|
||
|
|
|
||
|
|
قم بضبط [page:.x x], [page:.y y] و[page:.z z]، وقم اختیاریًا بتحديث
|
||
|
|
الترتیب[page:.order order].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h3>
|
||
|
|
[method:Array toArray]( [param:Array array], [param:Integer offset] )
|
||
|
|
</h3>
|
||
|
|
<p>
|
||
|
|
[page:Array array] - (optional) array to store the euler in.<br />
|
||
|
|
[page:Integer offset] (optional) offset in the array.<br />
|
||
|
|
|
||
|
|
يعود إلى مصفوفة من شكل [[page:.x x], [page:.y y], [page:.z z],
|
||
|
|
[page:.order order ]].
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<h2>المصدر (Source)</h2>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
|
||
|
|
</p>
|
||
|
|
</body>
|
||
|
|
</html>
|