# [name]

فئة تمثل [link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر].
تصف زوايا أويلر التحول الدوار بتدوير كائن على محاوره المختلفة بمقادير محددة لكل محور، وترتيب محور محدد.

التكرار عبر نسخة [name] سيعود بمكوناته (x، y، z، order) في الترتيب المقابل.

## مثال الكود

`const a = new THREE.Euler( 0, 1, 1.57, 'XYZ' ); const b = new THREE.Vector3( 1, 0, 1 ); b.applyEuler(a);`

## المنشئ (Constructor)

### [name]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )

[page:Float x] - (اختياري) زاوية المحور x بالراديان. الافتراضي هو `0`.
[page:Float y] - (اختياري) زاوية المحور y بالراديان. الافتراضي هو `0`.
[page:Float z] - (اختياري) زاوية المحور z بالراديان. الافتراضي هو `0`.
[page:String order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق التدویرات، الافتراضی هو 'XYZ' (یجب أن تكون بحروف كبیرة).

## الخصائص (Properties)

### [property:Boolean isEuler]

علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].

### [property:String order]

الترتيب الذي يتم فيه تطبيق التدويرات. الافتراضي هو 'XYZ'، مما يعني أن الكائن سيتم تدويره أولاً حول محور X الخاص به، ثم محور Y الخاص به وأخيرًا محور Z الخاص به. الإمكانيات الأخرى هي: 'YZX'، 'ZXY'، 'XZY'، 'YXZ' و'ZYX'. يجب أن تكون هذه بحروف كبيرة.
يستخدم Three.js زوايا Tait-Bryan `intrinsic`. هذا يعني أن التدويرات يتم تنفيذها بالنسبة إلى نظام الإحداثيات `local`. أي للترتيب 'XYZ'، يتم التدوير أولاً حول محور local-X (وهو نفسه محور world-X)، ثم حول local-Y (الذي قد يكون الآن مختلفًا عن محور world Y)، ثم local-Z (الذي قد يكون مختلفًا عن محور world Z).

### [property:Float x]

القيمة الحالية للمكون x.

### [property:Float y]

القيمة الحالية للمكون y.

### [property:Float z]

القيمة الحالية للمكون z.

## الطرق (Methods)

### [method:this copy]( [param:Euler euler] )

ينسخ قيمة [page:Euler euler] إلى هذه الزاوية الأويلر.

### [method:Euler clone]()

يعود إلى أويلر جديد بنفس المعلمات كهذا.

### [method:Boolean equals]( [param:Euler euler] )

يتحقق من المساواة الصارمة لهذه الزاوية الأويلر و[page:Euler euler].

### [method:this fromArray]( [param:Array array] )

[page:Array array] من طول 3 أو 4. يتوافق السجل 4 اختياريًا إلى [page:.order order].
يعيّن زاوية [page:.x x] لهذه الزاوية الأويلر إلى `array[0]`.
يعيّن زاوية [page:.y y] لهذه الزاوية الأويلر إلى `array[1]`.
يعيّن زاوية [page:.z z] لهذه الزاوية الأويلر إلى `array[2]`.
اختیاریًا یعین ترتیب هذه الزاویة الأویلر [page:.order order] إلى `array[3]`.

### [method:this reorder]( [param:String newOrder] )

يعيد تعيين زاوية الأويلر بترتيب جديد عن طريق إنشاء رباعية من هذه زاوية الأويلر ثم تعيين هذه الزاوية الأويلر مع الرباعية والترتيب الجديد.
*تحذير*: هذا يتجاهل معلومات الثورة.

### [method:this set]( [param:Float x], [param:Float y], [param:Float z], [param:String order] )

[page:.x x] - زاوية المحور x بالراديان.
[page:.y y] - زاوية المحور y بالراديان.
[page:.z z] - زاوية المحور z بالراديان.
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق التدويرات.
يضبط زوايا هذا التحول الأويلر واختياريًا الترتيب [page:.order order].

### [method:this setFromRotationMatrix]( [param:Matrix4 m], [param:String order] )

[page:Matrix4 m] - a [page:Matrix4] منها 3x3 العلوية من المصفوفة هي مصفوفة دوران نقية (أي غير مقاسة).
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذي يتم فيه تطبيق التدويرات.
يضبط زوايا هذا التحول الأويلر من مصفوفة دوران نقية بناءً على التوجه المحدد بالترتيب.

### [method:this setFromQuaternion]( [param:Quaternion q], [param:String order] )

[page:Quaternion q] - رباعية معدلة.
[page:.order order] - (اختياري) سلسلة تمثل الترتيب الذى يتم فيه تطبیق التدويرات.
يضبط زوايا هذا التحول الأويلر من رباعية معدلة بناءً على التوجه المحدد بـ[page:.order order].

### [method:this setFromVector3]( [param:Vector3 vector], [param:String order] )

[page:Vector3 vector] - [page:Vector3].
[page:.order order] - (اختیاری) سلسلة تمثل الترتیب الذى يتم فيه تطبیق التدویرات.
قم بضبط [page:.x x], [page:.y y] و[page:.z z]، وقم اختیاریًا بتحديث الترتیب[page:.order order].

### [method:Array toArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - (optional) array to store the euler in.
[page:Integer offset] (optional) offset in the array.
يعود إلى مصفوفة من شكل [[page:.x x], [page:.y y], [page:.z z], [page:.order order ]].

## المصدر (Source)

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