# [name]

تنفيذ [link:http://en.wikipedia.org/wiki/Quaternion كواترنيون].
يتم استخدام الكواترنيونات في three.js لتمثيل [link:https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation الدوران].

التكرار عبر مثيل [name] سيعطي مكوناته (x، y، z، w) بالترتيب المقابل.

لاحظ أن three.js تتوقع أن يتم تسوية Quaternions.

## مثال الكود

`const quaternion = new THREE.Quaternion(); quaternion.setFromAxisAngle( new THREE.Vector3( 0, 1, 0 ), Math.PI / 2 ); const vector = new THREE.Vector3( 1, 0, 0 ); vector.applyQuaternion( quaternion );`

## المنشئ (Constructor)

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

[page:Float x] - إحداثية x
[page:Float y] - إحداثية y
[page:Float z] - إحداثية z
[page:Float w] - إحداثية w

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

### [property:Boolean isQuaternion]

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

### [property:Float x]

### [property:Float y]

### [property:Float z]

### [property:Float w]

## الطرق (Methods)

### [method:Float angleTo]( [param:Quaternion q] )

يعيد الزاوية بين هذا الكواترنيون وكواترنيون [page:Quaternion q] بالراديان.

### [method:Quaternion clone]()

ينشئ كواترنيون جديدًا بخصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] متطابقة مع هذا.

### [method:this conjugate]()

يعيد التجانس الدوراني لهذا الكواترنيون. التجانس لـ كواترنيون يمثل نفس الدوران في الاتجاه المعاكس حول محور الدوران.

### [method:this copy]( [param:Quaternion q] )

ينسخ خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] من [page:Quaternion q] إلى هذا الكواترنيون.

### [method:Boolean equals]( [param:Quaternion v] )

[page:Quaternion v] - كواترنيون سيتم مقارنة هذا الكواترنيون إليه.
يقارن خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] من [page:Quaternion v] إلى الخصائص المكافئة لهذا كواترنيون لتحديد ما إذا كانت تمثل نفس الدوران.

### [method:Float dot]( [param:Quaternion v] )

يحسب [link:https://en.wikipedia.org/wiki/Dot_product dot product] من كواترنيونات [page:Quaternion v] وهذا.

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

[page:Array array] - مصفوفة بتنسيق (x، y، z، w) تستخدم لبناء الكواترنيون.
[page:Integer offset] - (اختياري) إزاحة في المصفوفة.
يضع خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] لهذا الكواترنيون من مصفوفة.

### [method:this identity]()

يضع هذا الكواترنيون على الكواترنيون المتطابق ؛ أي إلى الكواترنيون الذي يمثل "لا دوران".

### [method:this invert]()

يعكس هذا الكواترنيون - يحسب [page:.conjugate conjugate]. The يفترض أن الكواترنيون لديه طول وحدة.

### [method:Float length]()

يحسب [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي] (طول خط مستقيم) لهذا الكواترنيون ، كما هو معتبر متجه 4 أبعاد.

### [method:Float lengthSq]()

يحسب المربع [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي] (طول خط مستقيم) لهذا الكواترنيون ، كما هو معتبر متجه 4 أبعاد . هذا يمكن أن يكون مفيدًا إذا كنت تقارن طول اثنين كواترنيون ، حيث أن هذا حساب أكثر كفاءة قليلاً من [page:.length length]().

### [method:this normalize]()

[link:https://en.wikipedia.org/wiki/Normalized_vector يعدل] هذا كواترنيون - أي حساب الكواترنيون الذي يؤدي نفس دوران كهذا ، ولكن لديه [page:.length length] يساوي `1`.

### [method:this multiply]( [param:Quaternion q] )

يضرب هذا الكواترنيون بـ[page:Quaternion q].

### [method:this multiplyQuaternions]( [param:Quaternion a], [param:Quaternion b] )

يضع هذا الكواترنيون على[page:Quaternion a] x[page:Quaternion b].
تم تكييفه من الطريقة الموضحة [link:http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.html هنا].

### [method:this premultiply]( [param:Quaternion q] )

يضرب مسبقًا هذا الكواترنيون بـ[page:Quaternion q].

### [method:this random]()

يضع هذا الكواترنيون على كواترنيون عشوائي معتدل ومعتدل.

### [method:this rotateTowards]( [param:Quaternion q], [param:Float step] )

[page:Quaternion q] - كواترنيون الهدف.
[page:Float step] - الخطوة الزاوية بالراديان.
يدور هذا الكواترنيون بخطوة زاوية معطاة إلى كواترنيون محدد *q*. تضمن الطريقة ألا يتجاوز الكواترنيون النهائي *q*.

### [method:this slerp]( [param:Quaternion qb], [param:Float t] )

[page:Quaternion qb] - التدوير الكواترنيون الآخر
[page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`.
يتعامل مع التداخل الخطي الكروي بين كواترنيون. [page:Float t] يمثل مقدار التدوير بين هذا الكواترنيون (حيث[page:Float t] هو 0) و[page:Quaternion qb] (حيث[page:Float t] هو 1). يتم تعيين هذا الكواترنيون على النتيجة. اطلع أيضًا على الإصدار الثابت من `slerp` أدناه. `// تدور شبكة نحو كواترنيون هدف mesh.quaternion.slerp( endQuaternion، 0.01 );`

### [method:this slerpQuaternions]( [param:Quaternion qa], [param:Quaternion qb], [param:Float t] )

يؤدي التداخل الخطي الكروي بين كواترنيون المعطى وتخزين النتائج في هذا الكواترنيون.

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

يضع خصائص [page:.x x] ،[page:.y y] ،[page:.z z] ،[page:.w w] من هذا كواترنيون.

### [method:this setFromAxisAngle]( [param:Vector3 axis], [param:Float angle] )

يضع هذا الكواترنيون من التدوير المحدد بـ[page:Vector3 axis] و [page:Float angle].
تم تكييفه من الطريقة [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToQuaternion/index.html هنا].
يفترض أن يكون `Axis` معتدلًا ، `angle` بالراديان.

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

يضع هذا الكواترنيون من التدوير المحدد بزاوية[page:Euler].

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

[page:Matrix4 m] - a[page:Matrix4] من الذي العلوي 3x3 من المصفوفة هو مصفوفة دوران نقية (أي غير متساوية القياس).
يضع هذا الكواترنيون من مكون التدوير لـ[page:Matrix4 m].
تم تكييفه من الطريقة [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/index.html هنا].

### [method:this setFromUnitVectors]( [param:Vector3 vFrom], [param:Vector3 vTo] )

يضع هذا الكواترنيون على التدوير المطلوب لتدوير متجه الاتجاه [page:Vector3 vFrom] إلى متجه الاتجاه[page:Vector3 vTo].
تم تكييفه من الطريقة [link:http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors هنا].
يفترض أن يكون[page:Vector3 vFrom] و[page:Vector3 vTo] معتدلًا.

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

[page:Array array] - مصفوفة اختيارية لتخزين الكواترنيون. إذا لم يتم محدد ، سيتم إنشاء مصفوفة جديدة.
[page:Integer offset] - (اختياري) إذا تم تحديده ، فسيتم نسخ في هذه[page:Array].
يعود بالعناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق [x، y، z، w].

### [method:Array toJSON]()

هذه الطرق تحدد نتيجة التسلسل لـ[name]. يعود العناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق [x، y، z، w].

### [method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )

[page:BufferAttribute attribute] - السمة المصدر.
[page:Integer index] - فهرس في السمة.
يضع خصائص [page:.x x] ،[page:.y y] ،[page:.z z] ،[page:.w w] من هذا كواترنيون من[page:BufferAttribute attribute].

## طرق ثابتة (Static Methods)

### [method:undefined slerpFlat]( [param:Array dst], [param:Integer dstOffset], [param:Array src0], [param:Integer srcOffset0], [param:Array src1], [param:Integer srcOffset1], [param:Float t] )

[page:Array dst] - مصفوفة الإخراج.
[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج.
[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي.
[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`.
[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف.
[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`.
[page:Float t] - عامل التداخل المعتدل (بين 0 و 1).
تفترض هذه التطبيقات SLERP أن بيانات الكواترنيون يتم إدارتها في مصفوفات مسطحة.

### [method:Array multiplyQuaternionsFlat]( [param:Array dst], [param:Integer dstOffset], [param:Array src0], [param:Integer srcOffset0], [param:Array src1], [param:Integer srcOffset1] )

[page:Array dst] - مصفوفة الإخراج.
[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج.
[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي.
[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`.
[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف.
[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`.
تفترض هذه التطبيقات التعددية أن بيانات الكواترنيون يتم إدارتها في مصفوفات مسطحة.

## المصدر (Source)

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